# 即时收到推送通知 智能体完成任务时 。

> AI 智能体或 LLM 任务完成、需要审批或运行失败时，立即收到手机推送通知。Pocket Alert 提供 MCP create_message 工具，也支持通过简单的 HTTP POST 把消息发到你的手机。

<!-- source: https://pocketalert.app/zh/use-cases/ai-agent-alerts -->

最后更新：2026-08-11

长时间运行的 LLM 智能体不应该需要你一直盯着。当任务完成、卡在等待审批或出现故障时，你的手机会震动提醒你。你可以放心离开，相信它会通知到你。

## 三步实现免值守的智能体告警

1. **选择 MCP 或 HTTP** — 创建 API 密钥，或将 Pocket Alert MCP 服务器添加到你的客户端，走无代码路线。
2. **运行结束时发送** — 调用 create_message，或在 LangChain 回调或智能体工具中发送标题和消息。
3. **放心离开** — 为失败和审批请求分配独立的应用。这样，智能体工作时，你就可以离开工位了。

## 为无人值守运行的智能体而生

两种途径，同样结果：智能体调用一次 MCP 工具或发起一次 POST 请求，你的手机就会震动。

- **内置 MCP 服务器** — Claude Code、Claude Desktop、Cursor 等 MCP 客户端通过调用 create_message 工具发送推送通知。
- **普通 HTTP 备选方案** — 没有 MCP 客户端？任何智能体或脚本只需向消息 API 发起一次带身份验证的 POST 请求，即可完成同样的工作。
- **支持 Stop hook** — 在 Stop hook 中触发告警，让它在智能体结束运行时发出，而不是等你想起来再去查看。
- **消息中包含状态** — 在消息中直接附上智能体的状态和结果文本，让“需要审批”一目了然。
- **按智能体划分通道** — 为每个智能体或项目设置独立的应用，让重构机器人和 cron 任务各自使用独立的通道。
- **亚秒级送达** — 推送在一秒内送达，因此长时间任务一结束或在等待输入时停滞，你都能立即得到反馈。

## 将智能体接入你的手机

### 1. 获取 API 密钥

在 [API 密钥](https://pocketalert.app/zh/account/apikeys)页面创建一个密钥。智能体会在 `Token` 请求头中发送该密钥。

### 2. 从 LangChain 回调发起 POST（Python）

```
import requests
from langchain.callbacks.base import BaseCallbackHandler

class PocketAlert(BaseCallbackHandler):
    def on_agent_finish(self, finish, **kwargs):
        requests.post(
            "https://api.pocketalert.app/v1/messages",
            headers={"Token": "YOUR_API_KEY"},
            json={"title": "Agent finished", "message": finish.return_values["output"][:200]},
        )

agent.invoke({"input": task}, config={"callbacks": [PocketAlert()]})
```

### 3. 或将其作为智能体调用的 OpenAI 工具（Node）

```
async function notifyHuman({ title, message }) {
  await fetch("https://api.pocketalert.app/v1/messages", {
    method: "POST",
    headers: { Token: "YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({ title, message, level: "high" }),
  });
}
```

将 `notifyHuman` 注册为函数或工具，这样智能体在需要审批或遇到错误时就会调用它。

### 4. 或通过 MCP 免代码接入

如果你的客户端支持 MCP（Claude Code、Claude Desktop、Cursor），添加 Pocket Alert MCP 服务器，让智能体调用 `create_message` 工具即可。你这边无需编写任何代码。

请查阅[文档](https://info.pocketalert.app/getting-started.html)，了解目标设备、应用以及其余 MCP 工具的详细说明。

## 常见问题

### 智能体如何给我发送推送？

有两种方式。Claude Code、Claude Desktop 或 Cursor 等 MCP 客户端会调用 create_message 工具，推送随即发送到你的手机。其他情况只需向消息 API 发起一次 HTTP POST 请求。通常会在运行结束时通过 Stop hook 触发。

### 无代码的 MCP 方式是什么？

将 Pocket Alert MCP 服务器添加到你的客户端，然后使用标题和消息调用 create_message。无需编写代码，也无需 curl。如果智能体需要发送文件或截图，还可以使用 create_message_with_attachment。

### 能否一眼区分失败和完成？

为每个智能体分配独立的应用，这样重构机器人发出的“需要审批”和夜间流水线发出的“任务完成”会进入不同的通道。标题写清楚，让审批请求或失败信息一眼就能看懂。

### 如何让不同项目的智能体互不干扰？

为每个智能体或项目分配独立的应用。重构机器人和夜间数据流水线发出的推送会进入不同的通道，无需阅读正文，就知道是哪个任务发出的。

### 速度快到值得去看手机吗？

推送在一秒内送达。当编码智能体运行了十五分钟，而你已经去泡咖啡时，推送会在你坐回座位前送达。

### 如何让完成通知保持安静，而失败通知足够醒目？

每条消息都可以设置级别。例行的“任务完成”提醒可以设为静音，不发声、不震动，但仍会保留在历史记录中；而失败或审批请求可以设为高级别，以时效性推送送达，即使开启了 iPhone 专注模式也能突破提醒。MCP 的 create_message 工具同样接受 level 字段，因此智能体可以为每条消息选择提醒的强度。
