ai chat widget

content/documentation/admin/widgets/types.ru.md

@@ -2,6 +2,44 @@
 title: Типы виджетов
 ---
 
+## AI-чат
+
+Виджет **AI-чат** позволяет отправлять запросы к языковой модели через выбранный AI-провайдер: задаются общие инструкции (**Глобальный промпт**) и набор кнопок быстрых вопросов (**Быстрые вопросы**).
+
+### Конфигурация
+
+| Название            | Обязательность | Описание                                                                                                                       |
+|---------------------|----------------|--------------------------------------------------------------------------------------------------------------------------------|
+| Глобальный промпт   | нет            | Общие инструкции к каждому запросу; при отправке объединяются с промптом выбранной кнопки быстрого вопроса.                    |
+| Быстрые вопросы     | **да**         | Набор кнопок с подписью и текстом промпта (до 20 штук); для корректной работы виджета необходимо добавить хотя бы один вопрос. |
+
+Для каждого быстрого вопроса задаются поля:
+
+| Название         | Обязательность | Описание                                                                                     |
+|------------------|----------------|----------------------------------------------------------------------------------------------|
+| Название вопроса | **да**         | Короткая подпись, отображается на нижней панели виджета и в чате.                            |
+| Промпт           | **да**         | Инструкция для модели при нажатии на эту кнопку; допускается использование Go-шаблонизации.  |
+
+При заполнении промпта рекомендуется в явном виде указывать названия MCP-инструментов, которые должна вызвать модель при подготовке ответа.
+
+Пример промпта для быстрого вопроса:
+
+```sh
+1. Вызови MCP tool get_external_data для внешнего сервиса «Deckhouse Code» и получи пайплайны для проекта с ID {{ .entity.properties.deckhouse_code_id }}.
+2. Выведи таблицу с последними 10 пайплайнами.
+```
+
+### Использование виджета
+
+Для использования виджета у пользователя должен быть добавлен как минимум один [AI-провайдер](../../user/ai-assistant/#подключение-ai-провайдера).
+
+У чата не предусмотрена история:
+
+- Выводится только один ответ на последний заданный вопрос.
+- Ответ не сохраняется при переходе на другую страницу или при обновлении страницы.
+
+Перед отправкой вопроса пользователь может кастомизировать промпт, кликнув на пункт «Отправить с изменением промпта» в выпадающем меню кнопки вопроса.
+
 ## API
 
 Виджет позволяет вывести спецификацию API из файла в репозитории GitLab или по ссылке в формате OpenAPI (Swagger) или Protobuf. При выводе спецификации OpenAPI из файла в формате YAML или JSON виджет отображает интерфейс Swagger. Во всех остальных случаях виджет отображает спецификацию в виде текста.

content/documentation/release-notes/v1.5.0.ru.md

@@ -13,7 +13,8 @@ weight: 920
 
 Добавлены новые виджеты:
 
-- «GitHub. Actions» — для просмотра запусков и управления ([GitHub Actions](../../admin/widgets/types/#github-actions)).
+- «AI-чат» — для предоставления пользователям преднастроенных вопросов при взаимодействии с AI-провайдерами. Подробнее — в разделе [«AI-чат»](../../admin/widgets/types/#ai-чат).
+- «GitHub. Actions» — для просмотра запусков и управления [GitHub Actions](../../admin/widgets/types/#github-actions).
 
 ### Связи