Агенты

Общая информация

Агент умеет вести полноценный диалог с пользователем с поддержкой истории сообщений, ищет данные по базе знаний, Первой линии и задаёт дополнительные вопросы пользователю.

При получении запроса от пользователя агент в первую очередь проверяет наличие ответа в Первой линии.

Стоимость обработки сообщений агентом не фиксирована, а варьируется от количества действий, совершенных агентом для ответа. За каждое действие агента, требующее обращение к ИИ, взымается 1 кредит.

Настройка инструкции

Используйте настройку инструкции, чтобы ознакомить агента с вашей предметной областью, задать стиль общения и сценарии его работы. Для хорошего описания инструкции следуйте общим правилам написания инструкций к ЛЛМ:

1. Четкая инструкция: Убедитесь, что инструкция устанавливает четкую роль для агента. Это должно хорошо объяснять, что от бота ожидают пользователи.

2. Структурированные инструкции: Ваши инструкции должны включать четкие, корректные и последовательные правила для агента, чтобы улучшить его реакцию на разные запросы.

3. Предусмотрение направлений разговора: Важно предусмотреть потенциальные направления диалога и сценарии ошибок. Если вы пишите агенту какое-то условие, то важно описать оба варианта действий: когда условие выполняется и когда не выполняется.

4. Гибкость в ответах: Хорошая инструкция допускает гибкость в ответах агента, чтобы обеспечить более естественное взаимодействие с пользователем.

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

Настройки агента

Сценарии

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

• Название - должно содержать только латинские буквы или нижнее подчеркивание. Должно всегда начинаться с буквы, например: deposit
• Описание - обычно одно предложение, когда основной агент должен запускать данный сценарий, например:

Не поступил платеж с банковской карты

• Шаги - здесь вы должны описать по шагам сам сценарий, т.е. то, что агент должен делать, например:

1. Уточни город
2. Спроси какая будет посылка, в коробке или в пакете
3. Уточни вес посылки
4. Суммаризируй информацию и переведи на оператора

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

Для того, чтобы сценарный агент заработал, необходимо добавить или дополнить секцию ### Сценарные агенты ### основного агента. Например:

### Сценарные агенты ###
- "Не поступил платеж с банковской карты" - вызывай агента с именем "deposit".

Основной агент обобщает текущую беседу с клиентом и передает ее в сценарий. То есть сценарий не видит весь диалог в полном виде. При выходе из сценария сценарный агент также передает обобщенный результат основному агенту. Из-за этого могут возникать ситуации, когда какая-то информация теряется при переключениях между агентами. Чтобы этого избежать, можно использовать настройку "Совместные данные".

Навыки

На данный момент для настройки доступны четыре навыка - Полиглот, Фильтрация, Редактор и Выбор исполнителя. Вы можете в любое время включать\выключать данные навыки, а также дописывать необходимые правила для них.

Полиглот

Навык полиглот позволяет настроить языки, на которых бот может отвечать. Для того, чтобы решить, на каком языке отвечать, бот берет текст вопроса клиента и выбирает наиболее подходящий язык из списка, который был задан при настройке навыка. Если нужного языка в списке нет - бот отвечает на основном языке, который задается в общих настройках бота.

Стоимость навыка 0.1 кредит. Если навык включен, к цене любого текстового ответа бота всегда добавляется 0.1 кредита.

Фильтрация

Навык фильтрации позволяет пропускать сообщения, которые предположительно содержат спам или не должны обрабатываться вообще. Необходимо описать правила - какие сообщения относятся к спаму. После чего бот будет игнорировать все подходящие под условия сообщения. Остальные сообщения проходят на дальнейшую обработку.

Стоимость успешной фильтрации одного спам-сообщения 0.1 кредита. Вы можете настроить и включить данный навык на вкладке Навыки на странице Агенты.

Пример настройки навыка:

Правила "Спам":
  - Если это рекламный пост, рассылка - спам.
  - Если сообщение состоит только из эмодзи - спам.

Все остальные сообщения, не подходящие под правила - не спам.

Редактор

Этот навык автоматически улучшает ответы бота: он проверяет их на ошибки, галлюцинации, запрещённые слова, некорректные формулировки и приводит все тексты к единому стилю. Навык работает только с каждым отдельным ответом бота и не использует историю переписки. В разделе "Анализ ответа" можно посмотреть, каким был исходный вариант до исправлений.

Стоимость навыка - 0.1 кредит. Если навык включен, к цене любого текстового ответа бота всегда добавляется 0.1 кредита.

Выбор исполнителя

Навык выбора исполнителя позволяет настроить правила для перевода на оператора, т.е. ограничить темы, по которым бот будет отвечать. Настройка работает по аналогии с навыком фильтрации.

Стоимость успешного срабатывания данного навыка в случае перевода на оператора - 0.2 кредита.

Пример настройки навыка:

Если вопрос касается оплаты, переводи на оператора.

Все остальные вопросы переводи на бота.

Вызов функций внешних API

Агент может не только вести диалог, но и выполнять действия — например, получать данные из внешнего сервиса или создавать записи в CRM. Для этого используются функции, которые можно подключить к агенту.

Есть два типа функций:

• Встроенные функции — заранее реализованные действия, встроенные в Wikibot. Они не требуют настройки и сразу готовы к использованию (например, создание сделки в amoCRM).
• Пользовательские функции — HTTP-запросы, которые вы настраиваете самостоятельно. Подходят для интеграции со многими внешними системами через API.

Функции позволяют расширить возможности агента и автоматизировать типовые процессы.

Тестирование

На странице Агенты также доступен функционал по клонированию и удалению агентов. Данная функция позволяет улучшать и тестировать инструкцию и навыки, не влияя на текущих клиентов.

Как лучше всего тестировать агента:

1. Клонируйте текущего агента;
2. Внесите изменения в навыки, инструкцию или настройки;
3. Перейдите на вкладку тестирование, выберите нового агента и оцените результаты исправлений;
4. Если все отлично, вы можете включить нового агента в работу, старый агент будет выключен автоматически.

Полезные приёмы

• Если необходимо, чтобы бот отвечал по какой-то теме на основе своих общих знаний, то можно использовать инструкцию вида: Если пользователь спрашивает про <ваша тема>, то ты можешь использовать свои общие знания, для таких вопросов не ищи в первой линии или в базе знаний, сразу отвечай, то, что ты знаешь.

Ограничения

• На данный момент агент получает около 10-15 последних сообщений с пользователем, значение может изменяться как в меньшую так и в большую сторону.
• Для ответа на вопрос агенту доступны данные из базы знаний, которые он искал в последний раз, данные из предыдущих поисков он "забывает".
• Агент не умеет считывать информацию с каких-либо сайтов (переходить по URL), кроме той, что добавлена в Базу знаний.