Характеристики агента и переменные аккаунта
Повторно используемые черты (traits) и переменные для подстановки в шаблоны Liquid
Введение
Характеристики агента (traits) — это переиспользуемые правила и ограничения, которые добавляются в системный промпт агента. Например: «Отвечай только по базе знаний», «Не используй внешние API», «Всегда будь вежливым». Одну характеристику можно привязать к нескольким агентам.
Переменные аккаунта — это пары «ключ–значение» (например, название компании, описание продукта), которые подставляются во все Liquid-шаблоны: в текст характеристик, в шаблоны промптов и т.д. Так вы один раз задаёте, например, company_name, и он автоматически подставляется везде, где вы используете {{ company_name }}.
Характеристики агента
Характеристики создаются в разделе Характеристики агента. У каждой характеристики есть:
- Название — отображается в интерфейсе.
- Ключ (key) — уникальный идентификатор внутри аккаунта.
- Описание — для людей, что делает эта характеристика.
- Текст характеристики (Liquid) — фрагмент, который попадает в системный промпт агента. Поддерживает переменные (см. ниже).
- Активна — неактивные не добавляются в промпт.
Есть глобальные характеристики (созданные системой) и характеристики аккаунта. Глобальные нельзя редактировать, но их можно скопировать в аккаунт и изменить. При создании или редактировании агента в блоке «Характеристики агента (traits)» вы выбираете, какие характеристики применить к этому агенту.
Переменные в характеристиках
В тексте характеристики (и в других Liquid-шаблонах) доступны переменные:
agent_name— имя агента.account_name— название аккаунта.- Переменные аккаунта — например
company_name,company_description,product_name,product_description, а также любые добавленные вами ключи. Настраиваются в разделе Переменные аккаунта.
Пример текста характеристики:
Ты представляешь компанию {{ company_name }}. Отвечай кратко и по делу. Имя агента: {{ agent_name }}.
Переменные аккаунта
Управление переменными — в разделе Переменные аккаунта. По умолчанию доступны ключи:
company_name,company_descriptionproduct_name,product_description
Их можно заполнить или оставить пустыми. Можно добавить свои ключи (латиница в нижнем регистре, цифры и подчёркивание). Значения подставляются во все Liquid-шаблоны аккаунта: характеристики агентов, шаблоны промптов и т.д.
Где используются
Характеристики — выбранные для агента активные характеристики рендерятся (с подстановкой переменных) и добавляются в системный промпт при каждом запросе.
Шаблоны промптов — при рендере шаблона для чата в контекст подставляются переменные аккаунта и переданные при вызове переменные.