Вебхуки

PRX поддерживает исходящие вебхуки для уведомления внешних сервисов о событиях агента. Вебхуки обеспечивают интеграции с системами CI/CD, инструментами мониторинга и пользовательскими рабочими процессами.

Обзор

При настройке PRX отправляет HTTP POST-запросы на зарегистрированные URL вебхуков при наступлении определённых событий:

• session.created -- запущена новая сессия агента
• session.completed -- сессия агента завершена
• tool.executed -- инструмент был вызван и завершён
• error.occurred -- произошла ошибка

Конфигурация

[[gateway.webhooks]]
url = "https://example.com/webhook"
secret = "your-webhook-secret"
events = ["session.completed", "error.occurred"]
timeout_secs = 10
max_retries = 3

Формат полезной нагрузки

Полезные нагрузки вебхуков -- это JSON-объекты со стандартными полями:

{
  "event": "session.completed",
  "timestamp": "2026-03-21T10:00:00Z",
  "data": { }
}

Проверка подписи

Каждый запрос вебхука включает заголовок X-PRX-Signature, содержащий HMAC-SHA256 подпись полезной нагрузки с использованием настроенного секрета.

Связанные страницы

• Обзор шлюза
• HTTP API