Агенты
Настройте поведение бота
Общая информация
Агент умеет вести полноценный диалог с пользователем с поддержкой истории сообщений, ищет данные по базе знаний, Первой линии и задаёт дополнительные вопросы пользователю.
При получении запроса от пользователя агент в первую очередь проверяет наличие ответа в Первой линии.
Стоимость обработки сообщений агентом не фиксирована, а варьируется от количества действий, совершенных агентом для ответа. За каждое действие агента, требующее обращение к ИИ, взымается 1 кредит.
Если у вашего бота нет первой линии, то агент не будет искать ответы в ней. Соответственно это может снизить стоимость обработки отдельного сообщения на 1 кредит
Настройка инструкции
Используйте настройку инструкции, чтобы ознакомить агента с вашей предметной областью, задать стиль общения и сценарии его работы. Для хорошего описания инструкции следуйте общим правилам написания инструкций к ЛЛМ:
- Четкая инструкция: Убедитесь, что инструкция устанавливает четкую роль для агента. Это должно хорошо объяснять, что от бота ожидают пользователи.
- Структурированные инструкции: Ваши инструкции должны включать четкие, корректные и последовательные правила для агента, чтобы улучшить его реакцию на разные запросы.
Если пользователь обращается с просьбой найти тур, то следуй сценарию "Поиск тура"
Сценарий "Поиск тура":
- Уточни город вылета и желаемое направление
- Для поиска тура используй запрос формата: Поиск тура "Город вылета" / "Город или страна прилета" *
- При первом поиске тура не уточняй дополнительные детали
- Предоставляй туры в виде структурированного списка:
- Город вылета
- Город прилета
- Дата вылета и кол-во ночей
- Цена
- Ссылка на тур
- Если пользователь выбирает тур, то собери данные о туристах: ФИО, номер телефона, кол-во туристов
- Когда все данные собраны, то переведи диалог на оператора
В данном примере задается формат, в котором агент будет искать туры по Базе знаний. "Поиск тура" позволяет агенту выбрать документ с заголовком "Поиск тура", который должен содержать информацию о доступных турах.
- Предусмотрение направлений разговора: Важно предусмотреть потенциальные направления диалога и сценарии ошибок. Если вы пишите агенту какое-то условие, то важно описать оба варианта действий: когда условие выполняется и когда не выполняется.
Если тур не найден, не говори что нет подходящих туров. Переведи на оператора и скажи, что оператор обязательно поможет найти.
- Гибкость в ответах: Хорошая инструкция допускает гибкость в ответах агента, чтобы обеспечить более естественное взаимодействие с пользователем.
- Используйте специфические примеры: Предоставляйте конкретные примеры ожидаемого поведения в ваших инструкциях, чтобы убедиться, что агент понимает, как должен выглядеть его ответ.
Пример диалога: - тур - Добрый день, подскажите из какого города планируется вылет и какое направление Вас интересует? - Турция из Москвы - примеры туров.... - Спасибо, я выберу первый - Отлично, скажите Ваши ФИО и номер телефона, чтобы я мог забронировать тур для вас - ...
Настройки агента
Параметры, управляющие поведением агента: дата и время, случайное число, уточняющие вопросы, работа с изображениями и аудио, совместные данные и другие. Подробнее — в разделе Настройки агента.
Сценарии
Сценарные агенты позволяют разбить инструкции основного агента на логические части. Каждый сценарий — это отдельный набор шагов, который основной агент вызывает по условию. Подробнее — в разделе Сценарии.
Навыки
Навыки расширяют поведение агента: фильтрация спама, многоязычность, редактирование ответов, ограничение тем. Подробнее — в разделе Навыки.
Вызов функций внешних API
Агент может не только вести диалог, но и выполнять действия — например, получать данные из внешнего сервиса или создавать записи в CRM. Для этого используются функции, которые можно подключить к агенту.
Есть два типа функций:
- Встроенные функции — заранее реализованные действия, встроенные в Wikibot. Они не требуют настройки и сразу готовы к использованию (например, создание сделки в amoCRM).
- Пользовательские функции — HTTP-запросы, которые вы настраиваете самостоятельно. Подходят для интеграции со многими внешними системами через API.
Функции позволяют расширить возможности агента и автоматизировать типовые процессы.
Тестирование
На странице Агенты также доступен функционал по клонированию и удалению агентов. Данная функция позволяет улучшать и тестировать инструкцию и навыки, не влияя на текущих клиентов.
Как лучше всего тестировать агента:
- Клонируйте текущего агента;
- Внесите изменения в навыки, инструкцию или настройки;
- Перейдите на вкладку тестирование, выберите нового агента и оцените результаты исправлений;
- Если все отлично, вы можете включить нового агента в работу, старый агент будет выключен автоматически.
Полезные приёмы
- Если необходимо, чтобы бот отвечал по какой-то теме на основе своих общих знаний, то можно использовать инструкцию вида:
Если пользователь спрашивает про <ваша тема>, то ты можешь использовать свои общие знания, для таких вопросов не ищи в первой линии или в базе знаний, сразу отвечай, то, что ты знаешь.
Ограничения
- На данный момент агент получает около 25-30 последних сообщений с пользователем, значение может изменяться как в меньшую так и в большую сторону.
- Агент не умеет считывать информацию с каких-либо сайтов (переходить по URL), кроме той, что добавлена в Базу знаний.