Виджет «AI-чат» отправляет вопросы AI-агенту: задаются агент, общие инструкции («Глобальный промпт») и набор кнопок быстрых вопросов («Быстрые вопросы»).
Конфигурация
| Название | Обязательность | Описание |
|---|---|---|
| Агент | Нет | Агент, который отвечает в виджете. По умолчанию — платформенный агент. Задаётся только в настройках виджета, при работе с виджетом агента сменить нельзя |
| Глобальный промпт | Нет | Общие инструкции к каждому запросу; при отправке объединяются с промптом выбранной кнопки быстрого вопроса |
| Быстрые вопросы | Да | Набор кнопок с подписью и текстом промпта (до 20); для корректной работы виджета добавьте хотя бы один вопрос |
Для каждого быстрого вопроса задайте следующие поля:
| Название | Обязательность | Описание |
|---|---|---|
| Название вопроса | Да | Короткая подпись, отображаемая на нижней панели виджета и в чате |
| Промпт | Да | Инструкция для модели при нажатии на эту кнопку; допускается использование Go-шаблонизации |
При заполнении промпта явно укажите названия инструментов Model Context Protocol (MCP), которые должен вызвать агент при подготовке ответа. Агент получает инструменты назначенных ему MCP-коллекций, которыми может пользоваться запускающий пользователь. Без коллекций агент работает без MCP-инструментов.
Чтобы платформенный агент вызывал ddp_curated_get_external_data по инструкции в промпте, включите curated_get_external_data в MCP-коллекции агента и предоставьте пользователю доступ к этому инструменту через коллекцию.
Пример промпта для быстрого вопроса:
1. Вызови MCP-инструмент ddp_curated_get_external_data для внешнего сервиса «Deckhouse Code» и получи пайплайны для проекта с ID {{ .entity.properties.deckhouse_code_id }}.
2. Выведи таблицу с последними 10 пайплайнами.Использование виджета
Для работы с виджетом требуется глобальное use:ai-agents или объектное use:ai-agent на выбранного агента. Если модель агенту предоставляет портал (платформенный агент или внешний агент с разрешённым прокси моделей DDP), у пользователя должен быть AI-провайдер.
Для виджетов на странице сущности агент получает UUID сущности в контексте задачи.
У чата не предусмотрена история:
- Выводится только один ответ на последний заданный вопрос.
- Ответ не сохраняется при переходе на другую страницу или при обновлении страницы.
Перед отправкой вопроса измените промпт, выбрав пункт «Отправить с изменением промпта» в выпадающем меню кнопки вопроса.