REST API

Ассистенты

Откуда брать assistant_id и llm_model_id: список ассистентов, которые видит владелец токена, и модели каждого из них.

Список ассистентов

GET /api/assistants

Возвращает тех же ассистентов, что владелец токена видит в каталоге Aist Ai: свои ассистенты пользователя и каталог его организации, пакета или тарифа. id — это assistant_id для создания задачи.

curl https://agent.aist-ai.com/api/assistants \
  -H "Authorization: Bearer $AIST_AGENT_TOKEN" \
  -H "Accept: application/json"

{
  "data": [
    {
      "id": 3,
      "slug": "writer",
      "title": "Редактор",
      "description": "Пишет и редактирует тексты",
      "avatar_url": "https://…",
      "owned": false,
      "categories": ["Работа", "Творчество"]
    }
  ]
}

Поле	Описание
`id`	`assistant_id` для `POST /api/tasks`.
`slug`	Ключ для запроса моделей ассистента (ниже).
`title`, `description`, `avatar_url`	Витринные данные — как в каталоге.
`owned`	`true` — ассистент создан самим пользователем.
`categories`	Рубрики каталога. Ассистент приходит один раз, даже если состоит в нескольких.

Скрытых ассистентов в списке нет

Список совпадает с тем, что пользователь видит на сайте. Ассистенты, которых в каталоге нет (служебные, для интеграций), сюда не попадают — их assistant_id выдаёт администратор платформы вместе с доступом. Задачу с таким ID можно создать как обычно.

Выполнение кода через Agent пока недоступно

Ассистенты, вызванные через Agent, не запускают код: даже если в каталоге ассистент это умеет, в задаче такого инструмента у него не будет, и в options поле code_execution — false. Чтение таблиц и документов работает как обычно.

Видео — как картинки

Если у ассистента есть генератор видео, ролик генерируется прямо в задаче и приходит элементом file в output. Шага подтверждения, как в чате на сайте, у Agent нет.

Модели ассистента

GET /api/assistants/{slug}

models[].id передаётся в задачу как llm_model_id. Без него ассистент отвечает моделью с is_default: true. Недоступный токену ассистент — 404.

{
  "id": 3,
  "slug": "writer",
  "title": "Редактор",
  "description": "Пишет и редактирует тексты",
  "avatar_url": "https://…",
  "models": [
    { "id": 11, "label": "Быстро", "description": null, "is_default": true, "features": [] },
    { "id": 12, "label": "Глубоко", "description": "Думает дольше", "is_default": false, "features": [] }
  ],
  "options": { "internet_search": true, "read_documents": true, … }
}

# Задача конкретной модели ассистента
{ "assistant_id": 3, "llm_model_id": 12, "input": [{ "type": "text", "text": "…" }] }

Ошибки

Код	Когда
`401`	Токен не принят, истёк или отозван.
`404`	Ассистент по `slug` не найден или недоступен токену.
`502`	Aist Backend временно недоступен — повторите позже.

То же самое без кода — в панели управления: вставьте токен, и ассистенты с моделями будут на вкладке «Ассистенты».