# Получайте push-уведомление когда агент закончит работу.

> Получайте push-уведомления на телефон, когда AI-агент или запуск LLM завершился, ждёт подтверждения или упал с ошибкой. В Pocket Alert есть MCP-инструмент create_message и обычный HTTP POST.

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

Обновлено: 2026-08-11

Долго работающему LLM-агенту не нужно, чтобы вы за ним следили. Телефон вибрирует, когда задача завершена, агент ждёт подтверждения или сломался. Так вы можете отойти и быть уверены, что он до вас достучится.

## Три шага до уведомлений от агентов без присмотра

1. **Выберите MCP или HTTP** — Создайте API-ключ или добавьте MCP-сервер Pocket Alert в свой клиент, если хотите путь без кода.
2. **Отправляйте по завершении** — Вызовите create_message или отправьте заголовок и текст POST-запросом из callback LangChain или инструмента агента.
3. **Займитесь своими делами** — Дайте каждому агенту отдельное приложение для ошибок и подтверждений. Теперь можно отойти от стола, пока он работает.

## Для агентов, которые работают без присмотра

Два пути, один результат: агент вызывает MCP-инструмент или делает один POST, а ваш телефон вибрирует.

- **Встроенный MCP-сервер** — MCP-клиенты вроде Claude Code, Claude Desktop и Cursor отправляют push-уведомление, вызывая инструмент create_message.
- **Запасной вариант через HTTP** — Нет MCP-клиента? Один авторизованный POST в API сообщений делает то же самое из любого агента или скрипта.
- **Готово для Stop-хуков** — Запускайте уведомление из Stop-хука, чтобы оно отправлялось, когда агент закончит работу, а не когда вы вспомните проверить.
- **Статус в сообщении** — Передавайте статус агента и текст результата прямо в сообщении, чтобы «нужно подтверждение» было понятно сразу.
- **Каналы для каждого агента** — Отдельное приложение на каждого агента или проект держит бота для рефакторинга и cron-задачу в своих каналах.
- **Доставка меньше чем за секунду** — Push-уведомления приходят меньше чем за секунду, поэтому вы узнаете, что долгая задача завершилась или зависла на вводе, сразу же.

## Подключите агента к телефону

### 1. Получите API-ключ

Создайте ключ на странице [API-ключи](https://pocketalert.app/ru/account/apikeys). Агент передаёт его в заголовке `Token`.

### 2. Отправка POST из callback LangChain (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), добавьте MCP-сервер Pocket Alert и пусть агент вызывает инструмент `create_message`. Кода с вашей стороны не нужно.

В [документации](https://info.pocketalert.app/getting-started.html) описаны адресация, приложения и остальные инструменты MCP.

## Частые вопросы

### Как агент отправляет мне push-уведомление?

Есть два способа. MCP-клиенты вроде Claude Code, Claude Desktop или Cursor вызывают инструмент create_message, и push-уведомление приходит на телефон. Любой другой сценарий делает один HTTP POST в API сообщений. Обычно запуск происходит из Stop-хука в конце работы.

### Как работает путь без кода через MCP?

Добавьте MCP-сервер Pocket Alert в свой клиент и вызовите create_message с заголовком и текстом. Ни кода, ни curl. Если агенту нужно отправить файл или скриншот, есть create_message_with_attachment.

### Можно ли по уведомлению сразу понять, ошибка это или успех?

Дайте каждому агенту отдельное приложение, чтобы запрос на подтверждение от бота для рефакторинга и сообщение о завершении от ночного пайплайна приходили в разные каналы. Формулируйте заголовок так, чтобы запрос на подтверждение или ошибку было понятно с первого взгляда.

### Как разделить агентов из разных проектов?

Дайте каждому агенту или проекту собственное приложение. Push-уведомления от бота для рефакторинга и от ночного пайплайна с данными придут в разные каналы, и вы поймёте, какая задача отчиталась, не читая текст.

### Достаточно ли быстро, чтобы не проверять телефон?

Доставка занимает меньше секунды. Если кодинг-агент работает пятнадцать минут, а вы отошли за кофе, push-уведомление придёт раньше, чем вы вернётесь к столу.

### Как сделать так, чтобы уведомления о завершении были тихими, а об ошибках громкими?

Указывайте уровень важности для каждого сообщения. Обычное уведомление о завершении задачи можно отправить с уровнем silent: без звука и вибрации, но оно останется в истории. Ошибка или запрос на подтверждение пойдёт с уровнем high и придёт как срочное уведомление, которое пробивает Фокусирование на iPhone. Инструмент MCP create_message принимает то же поле level, поэтому агент сам выбирает громкость для каждого сообщения.
