Обзор

Что это

Agent принимает задачи по REST, ставит их в очередь и оркестрирует обработку в экосистеме AIST: создаёт чат и ход в основном бэкенде (Aist Back), передаёт конфигурацию ассистента в AI-движок (Aist Core) и возвращает вам готовый результат. Вся тяжёлая работа асинхронна — ваш сервер не держит соединение открытым.

Вы работаете только с Agent: указываете assistant_id и входные данные. Какие модель, системный промпт и инструменты у ассистента — задаётся в Aist Back, а не в запросе к Agent.

Поток запроса

# 1. Создание задачи
Клиент ──POST /api/tasks──▶ AIST Agent          # → { uuid, status: "pending" }
                              │
                              ├─▶ Aist Back      # создаёт чат + ход, отдаёт конфиг ассистента
                              └─▶ Aist Core      # принимает ход (fire-and-forget, stream)

# 2. Обработка в фоне (очередь Redis + Horizon)
Aist Core ──webhook──▶ AIST Agent               # processing → completed / failed

# 3. Получение результата
Клиент ──GET /api/tasks/{uuid}──▶ AIST Agent    # опрос статуса
   # или
AIST Agent ──POST callback_url──▶ Клиент        # webhook, если задан

Между «принял» и «готово» может пройти от секунд до минут — зависит от модели, объёма ввода и инструментов ассистента. Поэтому забор результата всегда асинхронный: опрос (GET /api/tasks/{uuid}) или webhook (callback_url).

С чего начать