Виджет «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 сущности в контексте задачи.

У чата не предусмотрена история:

  • Выводится только один ответ на последний заданный вопрос.
  • Ответ не сохраняется при переходе на другую страницу или при обновлении страницы.

Перед отправкой вопроса измените промпт, выбрав пункт «Отправить с изменением промпта» в выпадающем меню кнопки вопроса.