Навыки

Навыки — это текстовые инструкции, которые AI-агент использует в определенных ситуациях.

В отличие от системного промпта, полная инструкция навыка не передается модели с каждым запросом. В контекст постоянно добавляется только описание из поля «Когда применять». Если запрос подходит под это описание, агент дополнительно использует инструкцию из навыка.

Такой подход помогает сократить расход входящих токенов: объемные инструкции попадают в контекст только тогда, когда они нужны.

Навыки работают при использовании виджета, внешнего чата или API.

Как работают навыки

К одному агенту можно подключить несколько навыков. Один навык также можно использовать с несколькими агентами.

При подготовке одного ответа агент может использовать сразу несколько навыков, если запрос соответствует условиям их применения.

Если инструкции в навыке и системном промпте противоречат друг другу, агент следует системному промпту.

Если агент использовал навык при подготовке ответа, в чате отобразится соответствующий лейбл.

Создание навыка

Создать навык можно в разделе «Навыки» или при создании агента.

В разделе «Навыки»

1. Перейдите в раздел «ИИ-сервисы» → «Навыки».

2. Нажмите «Добавить».

3. Задайте параметры навыка.

4. Нажмите «Добавить».

После создания навык появится в разделе «ИИ-сервисы» → «Навыки».

При создании агента

На шаге «Инструкция и навыки» выберите существующий навык или нажмите «Добавить новый». При создании нового навыка задайте его параметры и нажмите «Добавить».

Параметры навыка

При создании навыка укажите:

• Название навыка — имя, под которым навык отображается в панели управления;

• Когда применять — описание ситуаций, в которых агент должен использовать навык. Это описание передается агенту при каждом запросе;

• Инструкция — текст инструкции, которую агент использует, если запрос соответствует описанию из поля «Когда применять»;

• Агенты — список агентов, к которым нужно сразу подключить навык. Поле необязательное.

Подключение навыка к агенту

Чтобы подключить к агенту ранее созданный навык:

1. Перейдите в раздел «ИИ-сервисы» → «Агенты» и кликните на нужного агента.

2. Перейдите на вкладку «Управление».

3. В блоке «Ресурсы» нажмите «Изменить» в строке «Навыки».

4. Выберите нужный навык и его версию.

Редактирование и версии навыка

Чтобы изменить навык, перейдите в раздел «ИИ-сервисы» → «Навыки» и кликните на нужный навык. Откроется редактор, в котором можно изменить его параметры.

При сохранении изменения можно выбрать, для каких подключенных агентов будет использоваться новая версия.

Каждое изменение, кроме названия, создает новую версию навыка. Это позволяет вернуться к предыдущей инструкции.

Чтобы выбрать версию:

• кликните на нее в правом меню редактора;

• или измените версию при подключении навыка к агенту.

Для одного навыка можно создать не более 50 версий. После создания 50-й версии нельзя сохранить изменения, которые создали бы следующую версию. Чтобы продолжить редактировать инструкцию вы можете создать копию навыка.

Копирование навыка

При копировании создается новый навык, в который переносится только выбранная в редакторе версия. История других версий не копируется, поэтому счетчик версий нового навыка начинается заново.

Чтобы создать копию:

1. Перейдите в раздел «ИИ-сервисы» → «Навыки».

2. Откройте нужный навык и выберите версию, которую нужно скопировать.

3. Вернитесь к списку навыков, нажмите на три точки рядом с нужным навыком и выберите «Дублировать».

Копия будет создана сразу и появится в списке.

Удаление навыка

Чтобы удалить навык:

1. Перейдите в раздел «ИИ-сервисы» → «Навыки».

2. Нажмите на три точки рядом с нужным навыком и выберите «Удалить».

3. Подтвердите удаление.