Введение

Быстрый старт

Два запроса: создать задачу и опросить результат. Понадобится JWT-токен и ID ассистента.

1. Создать задачу

POST /api/tasks

bash

curl -X POST https://agent.aist-ai.com/api/tasks \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --data-binary '{
    "assistant_id": 1,
    "input": [
      { "type": "text", "text": "Привет! Кто ты?" }
    ]
  }'

ответ

{ "uuid": "550e8400-e29b-41d4-a716-446655440000", "status": "pending" }

2. Забрать результат

GET /api/tasks/{uuid}

Опрашивайте эндпоинт, пока status не станет терминальным (completed или failed):

bash

curl https://agent.aist-ai.com/api/tasks/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer <jwt>" \
  -H "Accept: application/json"

ответ

{
  "uuid": "550e8400-...",
  "status": "completed",
  "turn": {
    "output": [{ "type": "text", "text": "Я — AI-ассистент…" }],
    "messages": [/* полная история LLM */],
    "metadata": { "model": "claude-sonnet-4-6", "cost": { "total": 0.0002 } }
  },
  "error": null,
  "created_at": "2026-07-08T10:00:00Z",
  "completed_at": "2026-07-08T10:00:04Z"
}

Не хотите опрашивать?

Передайте callback_url при создании задачи — Agent сам пришлёт результат, как только он готов. См. Webhook-уведомления.

Дальше

Форматы ввода — текст, файлы, голос.
Структура turn — что лежит в поле turn.
SDK — то же самое в несколько строк на TypeScript.

Кириллица в --data-binary в некоторых оболочках ломается — используйте ASCII или записывайте тело запроса во временный файл (--data-binary @body.json).