Формат ответа

Ответы инструментов

Встроенные инструменты (погода, поиск, работа с документами и т.д.) включаются на ассистенте в Aist Back, а не через Agent API. Здесь — как выглядят их ответы в output.

Область применения

Набор инструментов и их параметры задаются в настройках ассистента (Aist Back) и через Agent API не управляются. Клиент не включает эти инструменты в запросе. Вам важно уметь читать их результат — он приходит в output[].tool_call.output. Инструменты, которыми управляет клиент, — это клиентские инструменты.

Успешный результат любого инструмента имеет форму { "type": "content", "content": [{ "type": "text", "text": "…" }] }. Внутри text обычно лежит JSON-строка или plain-text. Ниже — что именно возвращает каждый инструмент.

Данные и утилиты

Инструмент	`text` в ответе
`get_time`	Строка времени: `"23 апреля 2026, 14:32:05 МСК"`
`get_current_weather`	JSON OpenWeatherMap: `{"weather":[…],"main":{"temp":12.3,…},"wind":{…}}`
`get_currency_info`	`{"base":"USD","target":"RUB","rate":92.45}`
`web_search`	Текст с результатами поиска Perplexity.
`look_image`	Текстовое описание изображения (vision-модель).

Генерация изображений

generate_image возвращает файл — и внутри tool_call.output, и отдельным элементом file в output[]:

"output": {
  "type": "content",
  "content": [{ "type": "file", "file": { "id": "88", "name": "generated_….png", "mime_type": "image/png" } }]
}

Нативные image-модели (напр. google/gemini-2.5-flash-image) генерируют картинку без tool_call — сразу элементом file в output[] (возможен и смешанный ответ «текст + файл»).

Документы

Инструмент	`text` в ответе
`read_document`	`{"page":1,"total_pages":12,"elements":[{"type":"heading","text":"…"},…]}`
`get_document_content`	`{"offset":0,"limit":100,"total":247,"has_more":true,"elements":[…]}`
`read_table`	CSV: `date,name,amount\n2026-04-01,Иванов,1500\n…`
`search_document_vector`	`{"results":[{"score":0.94,"page":8,"text":"…"},…]}`
`search_document_fulltext`	`{"results":[{"page":3,"element_type":"paragraph","text":"…"},…]}` (до 10)

Коллекции (базы знаний)

Инструмент	`text` в ответе
`search_collection_vector`	`{"results":[{"score":0.97,"document":"refund-policy.pdf","page":1,"text":"…"},…]}`
`search_collection_fulltext`	`{"results":[{"document":"…","page":2,"type":"paragraph","text":"…"},…]}` (до 10)

Внешние инструменты (external_tools)

Ассистент может вызывать инструменты со своим callback-URL (настраиваются в Aist Back). Модель видит их под именем с префиксом ext_. В output они выглядят как обычный tool_call — с результатом, который вернул внешний сервис:

{
  "type": "tool_call",
  "tool_call": {
    "name": "ext_book_room",
    "input": { "room": "№3", "time": "15:00" },
    "output": { "type": "content", "content": [{ "type": "text", "text": "Бронь BK-2091" }] },
    "cost": 0
  }
}

Разница с клиентскими инструментами: external_tools вызывает сервер (по настроенному URL), задача не прерывается. client_tools прерывают задачу и передают управление вам — см. Клиентские инструменты.