diff --git a/content/documentation/admin/ai-agents/overview.ru.md b/content/documentation/admin/ai-agents/overview.ru.md index edf8548..f6f72ba 100644 --- a/content/documentation/admin/ai-agents/overview.ru.md +++ b/content/documentation/admin/ai-agents/overview.ru.md @@ -32,9 +32,11 @@ AI-агент получает задачу на естественном язы Платформенный агент всегда использует прокси. Для внешнего агента включите «Разрешить прокси моделей DDP» в настройках подключения, если модель должен предоставлять портал. -Прокси работает с API, совместимым с OpenAI Chat Completions: к URL провайдера добавляется `/chat/completions`, если суффикса ещё нет. Требуются модель и токен; поля провайдера «Шаблон тела запроса» и «Поле ответа» для агентского запроса не используются. +Прокси работает с API, совместимым с OpenAI Chat Completions. Укажите модель, метод `POST` и требуемые провайдером заголовки авторизации. К пути URL добавляется `/chat/completions`, если суффикса ещё нет; параметры запроса в URL сохраняются. -Прокси не поддерживает `stream: true` и подставляет модель AI-провайдера вместо модели из запроса агента. +В запросы передаются заголовки провайдера и дополнительные поля «Шаблона тела запроса». Правила подстановок и приоритетов описаны в разделе [«Шаблон запроса для агентов»](../../user/ai-assistant/#шаблон-запроса-для-агентов). «Поле ответа» используется при сжатии истории чата; агент получает ответ в формате Chat Completions. + +Прокси поддерживает потоковые ответы (`stream: true`) и подставляет модель AI-провайдера вместо модели из запроса агента. ## Инструменты агента diff --git a/content/documentation/admin/ai-agents/provider-templates.ru.md b/content/documentation/admin/ai-agents/provider-templates.ru.md index 225fa0f..3a0e8a4 100644 --- a/content/documentation/admin/ai-agents/provider-templates.ru.md +++ b/content/documentation/admin/ai-agents/provider-templates.ru.md @@ -47,14 +47,16 @@ AI-провайдер нужен пользователю для работы с | «Доступные модели» | Нет | Модели, которые может выбрать пользователь. Пустой список — любая модель | | «Включён» | — | Отключённый шаблон нельзя использовать для новых подключений | | «URL» | Да | URL API провайдера, например `https://api.openai.com/v1/chat/completions` | -| «Метод» | Да | HTTP-метод запроса к провайдеру | +| «Метод» | Да | HTTP-метод запроса к провайдеру. Для агентов — `POST` | | «Источник токена» | Да | Режим работы шаблона. Подробнее — в разделе [«Источник токена»](#источник-токена) | | «Токен» | Для общего токена | Токен, которым авторизуются все пользователи шаблона. При редактировании пустое значение сохраняет текущий токен | | «Заголовки» | Нет | HTTP-заголовки запроса. Токен подставляется вместо `{{ .token }}`, например `Authorization: Bearer {{ .token }}` | -| «Поле ответа» | Нет | Путь к тексту ответа модели в JSON-ответе провайдера, например `choices.0.message.content` | -| «Шаблон тела запроса» | Нет | JSON-шаблон тела запроса с переменными `{{.prompt}}` и `{{.model}}` | +| «Поле ответа» | Нет | Путь к тексту ответа модели при сжатии истории чата, например `choices.0.message.content`. Агенты читают ответ в формате Chat Completions | +| «Шаблон тела запроса» | Нет | JSON-шаблон для сжатия истории чата и дополнительных параметров запросов агентов. Правила — в разделе [«Шаблон запроса для агентов»](../../user/ai-assistant/#шаблон-запроса-для-агентов) | -Чтобы шаблон работал с агентами, укажите API, совместимый с OpenAI Chat Completions: URL оканчивается на `/v1` или `/v1/chat/completions`. +Чтобы шаблон работал с агентами, укажите API, совместимый с OpenAI Chat Completions, и метод `POST`. К пути URL добавляется `/chat/completions`, если суффикса ещё нет; параметры запроса в URL сохраняются. + +Заголовки шаблона передаются при каждом запросе к модели, включая запросы агентов. Правила размещения токена описаны в разделе [«Токен в заголовках»](../../user/ai-assistant/#токен-в-заголовках). Если переключить шаблон с общего токена на личный, общий токен удаляется. Шаблон, из которого подключены провайдеры пользователей, удалить нельзя. diff --git a/content/documentation/release-notes/v1.8.0.ru.md b/content/documentation/release-notes/v1.8.0.ru.md index e20ab84..c18ff06 100644 --- a/content/documentation/release-notes/v1.8.0.ru.md +++ b/content/documentation/release-notes/v1.8.0.ru.md @@ -5,7 +5,7 @@ description: Рабочие пространства с AI-агентом, ци --- {{< alert level="info" >}} -Выпуск релиза планируется 15.11.2026. +Релиз выпущен 11.11.2026. {{< /alert >}} ## Несовместимые изменения @@ -93,6 +93,9 @@ description: Рабочие пространства с AI-агентом, ци - Записи действий больше не остаются выполняющимися после удаления связанной сущности. - Исправлено ошибочное завершение webhook-действия с успехом при ответе 3xx без выполненного перенаправления. - При переключении чатов во время ответа агента сообщения разных диалогов больше не смешиваются. +- В [AI-ассистенте](../user/ai-assistant/#устранение-неполадок) ошибки провайдера теперь показывают причину и UUID запуска; полученная до сбоя часть ответа сохраняется в истории. +- Исправлены сбои вызова инструментов моделями с режимом рассуждений. +- Исправлены отказы моделей принимать схемы MCP-инструментов с параметрами произвольного типа. - Исправлено включение [MCP-серверов и инструментов](../user/mcp-management/), а также [шаблонов AI-провайдеров](../admin/ai-agents/provider-templates/) при создании в выключенном состоянии. - Исправлен учёт объектных прав при просмотре и редактировании AI-агентов и объектов MCP в интерфейсе. - Редактирование источника AI-агентов больше не сбрасывает время последней синхронизации. diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index 5e32104..5d1c434 100644 --- a/content/documentation/user/ai-assistant.ru.md +++ b/content/documentation/user/ai-assistant.ru.md @@ -50,16 +50,23 @@ URL, метод и заголовки подставляются из шабло | «Название» | Да | Название провайдера. По названию провайдер выбирается в чате и в элементе процесса «AI-агент» | | «Модель» | Да | Название модели, например `gpt-4o` | | «URL» | Да | URL API провайдера, например `https://api.openai.com/v1/chat/completions` | -| «Метод» | Да | HTTP-метод запроса, обычно `POST` | +| «Метод» | Да | HTTP-метод запроса. Для агентов — `POST` | | «Заголовки» | Нет | HTTP-заголовки запроса. Токен подставляется вместо `{{ .token }}` | | «Токен» | Нет | Токен API провайдера. Хранится в зашифрованном виде и после сохранения не отображается | -| «Поле ответа» | Нет | Путь к тексту ответа модели в JSON-ответе провайдера, например `choices.0.message.content` | -| «Шаблон тела запроса» | Нет | JSON-шаблон тела запроса с переменными `{{.prompt}}` и `{{.model}}` | +| «Поле ответа» | Нет | Путь к тексту ответа модели при сжатии истории чата, например `choices.0.message.content`. Агенты читают ответ в формате Chat Completions | +| «Шаблон тела запроса» | Нет | JSON-шаблон для сжатия истории чата и дополнительных параметров запросов агентов. Правила — в разделе [«Шаблон запроса для агентов»](#шаблон-запроса-для-агентов) | При сохранении проверяется формат URL провайдера. URL не должен содержать имя пользователя и пароль. -Агенты обращаются к модели в формате OpenAI Chat Completions, поэтому для работы с агентами укажите API, совместимый с OpenAI: URL оканчивается на `/v1` или `/v1/chat/completions`. -Поля «Поле ответа» и «Шаблон тела запроса» используются только при сжатии длинной истории чата в резюме (подробнее — в разделе [«Передача контекста»](#передача-контекста)). +Агенты обращаются к модели в формате OpenAI Chat Completions. Укажите совместимый API и метод `POST`. К пути URL добавляется `/chat/completions`, если путь ещё не заканчивается этим суффиксом; параметры запроса в URL сохраняются. + +### Шаблон запроса для агентов + +В поле «Шаблон тела запроса» можно задать дополнительные параметры модели, например `temperature` или `thinking`, если провайдер их поддерживает. Эти поля верхнего уровня передаются в каждом запросе агента; значения из шаблона имеют приоритет над значениями агента. + +Поля `messages`, `model`, `stream`, `stream_options`, `tools` и `tool_choice` формируются для запуска агента и не берутся из шаблона. Модель определяется выбранным AI-провайдером. + +В дополнительных полях поддерживается подстановка `{{.model}}`. Поле с `{{.prompt}}` или другой неподдерживаемой подстановкой делает провайдер недоступным для агентов. Для сжатия истории чата шаблон используется целиком с переменными `{{.prompt}}` и `{{.model}}` (подробнее — в разделе [«Передача контекста»](#передача-контекста)). ### Токен в заголовках @@ -69,7 +76,9 @@ URL, метод и заголовки подставляются из шабло Authorization: Bearer {{ .token }} ``` -Если в заголовках нет выражения `{{ .token }}`, агенты передают токен модели как API-ключ. +Настроенные заголовки передаются и в запросах агентов, и при сжатии истории чата. Например, для провайдера с авторизацией через `X-Api-Key` укажите `X-Api-Key: {{ .token }}`. + +Если токен задан, но ни один заголовок его не использует, портал добавляет `Authorization: Bearer <токен>`. Если при этом `Authorization` уже задан, запрос отклоняется. Укажите в нужном заголовке `{{ .token }}` или удалите лишний заголовок `Authorization`. ### Пример провайдера для OpenAI @@ -109,7 +118,7 @@ Authorization: Bearer {{ .token }} 1. До первого сообщения у чата служебное название. После первого вопроса название подставляется по тексту (можно «Переименовать»). 1. Удаление чата вместе с историей сообщений в нём необратимо. -Если агент не смог ответить, под сообщением отображается «Агент не смог ответить» и кнопки «Повторить» и «Подробности». +Если агент не смог ответить, под сообщением отображается «Агент не смог ответить», причина ошибки и кнопка «Повторить». Полученная до ошибки часть ответа сохраняется в истории. Если доступны дополнительные сведения, кнопка «Подробности» раскрывает сообщение об ошибке и UUID запуска агента. ### Передача контекста @@ -183,7 +192,10 @@ Authorization: Bearer {{ .token }} | «Для вашей учётной записи не настроен AI-провайдер. Добавьте его в настройках профиля.» | У пользователя нет AI-провайдера. Подключите провайдера, как описано в разделе [«Подключение AI-провайдера»](#подключение-ai-провайдера) | | «Выберите AI-провайдера» | Для выбранного агента нужен провайдер. Выберите провайдера в поле «Провайдер» | | «Недостаточно прав для запуска этого AI-агента» | Выберите другого доступного агента или обратитесь к администратору портала | -| «LLM-провайдер отклонил запрос. Проверьте API-ключи в настройках профиля.» | Провайдер не принял токен. Проверьте токен и заголовки провайдера | +| «LLM-провайдер отклонил API-ключ. Проверьте токен провайдера в настройках профиля.» | Провайдер не принял токен. Проверьте токен и заголовки провайдера | | «Превышен лимит запросов к LLM-провайдеру. Попробуйте позже.» | Провайдер ограничил число запросов | +| «Агент не может использовать настройки AI-провайдера. Причина — в подробностях: исправьте настройки провайдера или обратитесь к администратору.» | Раскройте «Подробности» и проверьте метод `POST`, заголовки авторизации и подстановки в шаблоне запроса | +| «LLM-провайдер отклонил запрос агента. Причина — в подробностях.» | Раскройте «Подробности» и проверьте указанные провайдером ограничения модели или параметров запроса | +| «Ответ LLM-провайдера оборвался до завершения. Попробуйте позже.» | Полученная часть ответа сохранена. Повторите запрос | -При ошибке вызова внешнего агента передайте администратору название агента и сообщение об ошибке. +При обращении к администратору передайте название агента, сообщение об ошибке и UUID запуска из «Подробностей», если он отображается. diff --git a/content/documentation/user/mcp-server.ru.md b/content/documentation/user/mcp-server.ru.md index e4446ed..40112de 100644 --- a/content/documentation/user/mcp-server.ru.md +++ b/content/documentation/user/mcp-server.ru.md @@ -39,6 +39,8 @@ MCP — это открытый протокол для взаимодейств Аргументы инструмента описаны в `inputSchema` ответа `tools/list`. Например, `run_process` — операция API, а `curated_run_process` — специализированный инструмент с параметрами, описанными ниже. Их аргументы различаются. +Имена аргументов могут отличаться от имён параметров REST API: например, `filters[status]` передаётся как `filters_status`, а `uuids[]` — как `uuids`. Используйте имена из `inputSchema`; портал преобразует их в параметры API при вызове. + Результат инструмента операции содержит HTTP-статус, тип содержимого, способ кодирования и тело ответа. Например: ```json