Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions content/documentation/admin/ai-agents/overview.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-провайдера вместо модели из запроса агента.

## Инструменты агента

Expand Down
10 changes: 6 additions & 4 deletions content/documentation/admin/ai-agents/provider-templates.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/#токен-в-заголовках).

Если переключить шаблон с общего токена на личный, общий токен удаляется.
Шаблон, из которого подключены провайдеры пользователей, удалить нельзя.
Expand Down
5 changes: 4 additions & 1 deletion content/documentation/release-notes/v1.8.0.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: Рабочие пространства с AI-агентом, ци
---

{{< alert level="info" >}}
Выпуск релиза планируется 15.11.2026.
Релиз выпущен 11.11.2026.
{{< /alert >}}

## Несовместимые изменения
Expand Down Expand Up @@ -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-агентов больше не сбрасывает время последней синхронизации.
Expand Down
30 changes: 21 additions & 9 deletions content/documentation/user/ai-assistant.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -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}}` (подробнее — в разделе [«Передача контекста»](#передача-контекста)).

### Токен в заголовках

Expand All @@ -69,7 +76,9 @@ URL, метод и заголовки подставляются из шабло
Authorization: Bearer {{ .token }}
```

Если в заголовках нет выражения `{{ .token }}`, агенты передают токен модели как API-ключ.
Настроенные заголовки передаются и в запросах агентов, и при сжатии истории чата. Например, для провайдера с авторизацией через `X-Api-Key` укажите `X-Api-Key: {{ .token }}`.

Если токен задан, но ни один заголовок его не использует, портал добавляет `Authorization: Bearer <токен>`. Если при этом `Authorization` уже задан, запрос отклоняется. Укажите в нужном заголовке `{{ .token }}` или удалите лишний заголовок `Authorization`.

### Пример провайдера для OpenAI

Expand Down Expand Up @@ -109,7 +118,7 @@ Authorization: Bearer {{ .token }}
1. До первого сообщения у чата служебное название. После первого вопроса название подставляется по тексту (можно «Переименовать»).
1. Удаление чата вместе с историей сообщений в нём необратимо.

Если агент не смог ответить, под сообщением отображается «Агент не смог ответить» и кнопки «Повторить» и «Подробности».
Если агент не смог ответить, под сообщением отображается «Агент не смог ответить», причина ошибки и кнопка «Повторить». Полученная до ошибки часть ответа сохраняется в истории. Если доступны дополнительные сведения, кнопка «Подробности» раскрывает сообщение об ошибке и UUID запуска агента.

### Передача контекста

Expand Down Expand Up @@ -183,7 +192,10 @@ Authorization: Bearer {{ .token }}
| «Для вашей учётной записи не настроен AI-провайдер. Добавьте его в настройках профиля.» | У пользователя нет AI-провайдера. Подключите провайдера, как описано в разделе [«Подключение AI-провайдера»](#подключение-ai-провайдера) |
| «Выберите AI-провайдера» | Для выбранного агента нужен провайдер. Выберите провайдера в поле «Провайдер» |
| «Недостаточно прав для запуска этого AI-агента» | Выберите другого доступного агента или обратитесь к администратору портала |
| «LLM-провайдер отклонил запрос. Проверьте API-ключи в настройках профиля.» | Провайдер не принял токен. Проверьте токен и заголовки провайдера |
| «LLM-провайдер отклонил API-ключ. Проверьте токен провайдера в настройках профиля.» | Провайдер не принял токен. Проверьте токен и заголовки провайдера |
| «Превышен лимит запросов к LLM-провайдеру. Попробуйте позже.» | Провайдер ограничил число запросов |
| «Агент не может использовать настройки AI-провайдера. Причина — в подробностях: исправьте настройки провайдера или обратитесь к администратору.» | Раскройте «Подробности» и проверьте метод `POST`, заголовки авторизации и подстановки в шаблоне запроса |
| «LLM-провайдер отклонил запрос агента. Причина — в подробностях.» | Раскройте «Подробности» и проверьте указанные провайдером ограничения модели или параметров запроса |
| «Ответ LLM-провайдера оборвался до завершения. Попробуйте позже.» | Полученная часть ответа сохранена. Повторите запрос |

При ошибке вызова внешнего агента передайте администратору название агента и сообщение об ошибке.
При обращении к администратору передайте название агента, сообщение об ошибке и UUID запуска из «Подробностей», если он отображается.
2 changes: 2 additions & 0 deletions content/documentation/user/mcp-server.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading