提醒 | ElevenLabs Documentation

概览

当工作区中的智能体出现问题时，提醒会通知你。ElevenLabs 会持续监控对话活动，当错误率超过配置的阈值或显著高于近期基线时触发提醒。提醒无需任何设置即可开始运行：监控器会使用默认阈值自动运行，你可在需要时调整阈值或添加通知。

可在 ElevenLabs 仪表板中查看和管理提醒，并在工作区和智能体层面配置设置。使用 Update agent API、SDK 或 Agents CLI 配置文件创建或更新智能体时，也可通过 platform_settings.alerting 字段以编程方式设置智能体级设置。工作区级设置和提醒历史记录仅可在仪表板中查看。

系统会对每个智能体评估以下监控器：

提醒类型	触发条件
对话失败	错误数超过对话数的一定百分比
工具失败	错误数超过工具调用数的一定百分比，按工具跟踪
Webhook 错误	错误数超过 Webhook 调用数的一定百分比
护栏触发	护栏触发次数超过对话数的一定百分比
通话发起错误	错误数超过通话发起次数的一定百分比
评估成功分数	平均评估成功分数低于阈值

每条提醒具有以下状态之一：

活跃：条件当前正在触发。
已解决：条件已停止触发，提醒会在一段时间无活动后自动解决。
已忽略：用户手动忽略了提醒。

查看提醒

前往 开发者 > 提醒，查看工作区中智能体最近的监控提醒。页面会显示提醒活动时间线，以及列出每条提醒时间戳、持续时间、状态、类型和智能体的表格。你可以按状态、智能体或工具筛选，并调整时间范围（最长 90 天）。

点击提醒以打开受影响的对话，或使用行菜单在对话历史记录中 检查对话。也可从同一菜单中忽略活跃提醒。

活跃提醒也会显示为每个智能体页面上的 Spotlight 概览仪表板中的高优先级卡片。当工作区存在活跃提醒时，智能体仪表板中的横幅会链接至提醒页面。

配置阈值

提醒阈值可在工作区级别配置，并按智能体覆盖。未设置的值会回退到工作区配置，未设置的工作区值会回退到系统默认值。

只有工作区管理员可以更改工作区级提醒设置。

在 开发者 > 提醒页面上，点击 提醒设置，然后选择 配置阈值。若要为单个智能体覆盖阈值，请打开智能体高级设置标签中的提醒部分，然后点击 配置阈值。

每个监控器均可启用或停用，并设有阈值：即触发提醒的错误率，范围为 0% 至 100%。你也可以设置 无活动后自动解决（分钟），以控制提醒在自动解决前可以保持无活动状态的时长。

通知

提醒可通过工作区 Webhook、Slack 和 PagerDuty 通知外部系统。当提醒触发、解决或被忽略时，ElevenLabs 会通知每个已配置的通知器。通知器可附加在工作区级别和智能体级别；智能体级通知器会添加到工作区通知器之上，而非替代它们。每个级别最多可配置 10 个通知器。

要设置通知器，请在 开发者 > 提醒页面上点击 提醒设置 > 配置通知；若是单个智能体，请在智能体高级设置标签的提醒部分中点击 配置通知。每个通知器都有 发送测试 操作，可在提醒触发前验证投递。

Webhook

选择现有工作区 Webhook，或使用 HTTPS 回调 URL 创建新的 Webhook。ElevenLabs 会为每个提醒生命周期事件发送 POST 请求。端点应验证请求签名并及时返回 HTTP 200；重复失败的 Webhook 会自动停用，规则与其他工作区 Webhook相同。

通知负载

提醒通知使用 convai_alerting_notification 事件类型。event.name 字段表示发生的事件：提醒变为活跃时为 triggered，无活动后解决时为 auto_resolved，用户忽略时为 resolved（此时 was_resolved_by_user 为 true）。text 字段包含采用 Slack 标记格式的易读摘要，因此通知可直接转发至 Slack 传入 Webhook。

{
  "type": "convai_alerting_notification",
  "event_timestamp": 1739537297,
  "text": ":rotating_light: *New agent alert - High tool failure rate*\n*Agent:* <https://elevenlabs.io/app/agents/agents/agent_7101k5zvyjhmfg983brhmhkd98n6|Support agent>\n*Status:* Triggered\n*Started at:* 14 February at 12:48 UTC",
  "event": {
    "name": "triggered",
    "was_resolved_by_user": false
  },
  "alert": {
    "id": "alert_2601k5zvyjhmfg983brhmhkd98n6",
    "tool_name": "get_order_status",
    "monitor": "elevated_tool_failure_rate",
    "metric_name": "tool_failure_rate",
    "status": "active",
    "first_triggered_at_unix_secs": 1739537297,
    "last_triggered_at_unix_secs": 1739537897
  }
}

monitor 字段的值为 elevated_conversation_failure_rate、elevated_tool_failure_rate、webhook_error_spike、guardrail_trigger_spike、call_initiation_error_spike 或 low_evaluation_success_score 之一。tool_name 字段仅在工具失败提醒中设置。

Slack

Slack 通知器会将提醒通知直接发布到 Slack 频道。将 Slack 集成连接到工作区，然后将该连接添加为通知器，并输入要发布到的频道 ID。要在 Slack 中查找频道 ID，请打开频道，点击页眉中的频道名称，然后滚动到关于标签底部并复制频道 ID（例如 C0123456789）。将已连接的 Slack 应用添加到频道；应用需要 chat:write 权限范围，或者需要 chat:write.public 才能发布到尚未加入的公开频道。提醒触发时会发布一条消息，解决时会再次发布。

PagerDuty

PagerDuty 通知器通过 Events API 将提醒作为 PagerDuty 事件发送。使用应接收提醒的 PagerDuty 服务中的 Events API v2 集成密钥，在集成页面连接 PagerDuty 集成，然后将该连接添加为通知器。提醒变为活跃时会触发事件，提醒解决时会自动解决；同一提醒的重复触发会去重为单个事件。支持美国和欧盟 PagerDuty 服务区域。

概览