API агента

Каждый агент обязан реализовать два HTTP-эндпоинта. Оркестратор платформы взаимодействует с агентом только через них.

POST /run

Запуск задачи.

Запрос

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "input": "текст задачи для агента",
  "config": {
    "system_prompt": "Вы — финансовый аналитик.",
    "max_tokens": 2048,
    "enabled_tools": ["calculator", "web_search"]
  }
}

Поле	Тип	Обязательное	Описание
task_id	string (UUID)	да	Уникальный идентификатор задачи
input	string	да	Текст задачи
config	object	нет	Переопределение параметров для этого запуска

Ответ — успех

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "output": "результат работы агента",
  "metrics": {
    "duration_sec": 1.24,
    "input_tokens": 312,
    "output_tokens": 48,
    "steps": 2
  }
}

Ответ — ошибка

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "error",
  "output": "",
  "metrics": {},
  "error": "описание ошибки"
}

warning

Всегда возвращайте HTTP 200 даже при ошибке агента — статус передаётся в поле status. HTTP-ошибки (4xx, 5xx) используются только для инфраструктурных проблем.

GET /health

Проверка работоспособности агента.

Ответ

{
  "status": "ok",
  "agent_id": "agent-001",
  "agent_name": "my-agent"
}

Оркестратор проверяет /health каждые 30 секунд. Если агент не отвечает более 3 раз подряд — помечается как недоступный.

Тайм-ауты

Параметр	Значение
Тайм-аут /run	120 секунд (для маркетплейса — не более 30 сек для 95% запросов)
Тайм-аут /health	5 секунд