> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 提醒

## 概览

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

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

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

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

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

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

## 查看提醒

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

![仪表板中的提醒页面](/docs/_fern-img/d2dbe97d07149ab05ea88cff5300146de39682532a84d1a37326b01dbc04ba9f.webp)

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

活跃提醒也会显示为每个智能体页面上的 [**Spotlight**](/docs/zh/eleven-agents/dashboard/spotlight) 概览仪表板中的高优先级卡片。当工作区存在活跃提醒时，智能体仪表板中的横幅会链接至提醒页面。

## 配置阈值

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

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

在 [**开发者** > **提醒**](https://elevenlabs.io/app/developers/alerts) 页面上，点击 **提醒设置**，然后选择 **配置阈值**。若要为单个智能体覆盖阈值，请打开智能体 **高级** 设置标签中的 **提醒** 部分，然后点击 **配置阈值**。

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

![智能体“高级”标签中的提醒设置](/docs/_fern-img/d951fa5b6cd3c39590227a893874426be4b0629cd84a6d9919b584a977d2cfdc.webp)

## 通知

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

要设置通知器，请在 [**开发者** > **提醒**](https://elevenlabs.io/app/developers/alerts) 页面上点击 **提醒设置** > **配置通知**；若是单个智能体，请在智能体 **高级** 设置标签的 **提醒** 部分中点击 **配置通知**。每个通知器都有 **发送测试** 操作，可在提醒触发前验证投递。

### Webhook

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

#### 通知负载

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

```json
{
  "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 集成](/docs/zh/eleven-agents/customization/integrations/slack)连接到工作区，然后将该连接添加为通知器，并输入要发布到的频道 ID。要在 Slack 中查找频道 ID，请打开频道，点击页眉中的频道名称，然后滚动到 **关于** 标签底部并复制频道 ID（例如 `C0123456789`）。将已连接的 Slack 应用添加到频道；应用需要 `chat:write` 权限范围，或者需要 `chat:write.public` 才能发布到尚未加入的公开频道。提醒触发时会发布一条消息，解决时会再次发布。

### PagerDuty

PagerDuty 通知器通过 [Events API](https://developer.pagerduty.com/docs/events-api-v2-overview) 将提醒作为 PagerDuty 事件发送。使用应接收提醒的 PagerDuty 服务中的 Events API v2 集成密钥，在[集成页面](https://elevenlabs.io/app/agents/integrations)连接 PagerDuty 集成，然后将该连接添加为通知器。提醒变为活跃时会触发事件，提醒解决时会自动解决；同一提醒的重复触发会去重为单个事件。支持美国和欧盟 PagerDuty 服务区域。

## 相关资源

#### [Webhook](/docs/zh/eleven-api/resources/webhooks)

配置工作区 Webhook、重试和自动停用行为。

#### [实时监控](/docs/zh/eleven-agents/guides/realtime-monitoring)

在活跃通话期间查看实时对话并发送控制命令。

#### [通话后 Webhook](/docs/zh/eleven-agents/workflows/post-call-webhooks)

通话完成后接收对话数据和分析结果。

#### [分析](/docs/zh/eleven-agents/dashboard)

在仪表板中跟踪智能体性能指标。