🔧 Инструменты

Инструменты позволяют вашему агенту выполнять конкретные действия, такие как поиск знаний, обработка платежей и эскалация к людям.

Доступные инструменты

🔍 search_knowledge

Поиск в базе знаний релевантной информации

Доступно: Все типы агентов

💳 get_payment_link

Получение платёжных ссылок для продуктов или услуг

Доступно: Creator, E-commerce

🚨 escalate_to_human

Передача разговора человеку-оператору

Доступно: Все типы агентов

📅 book_appointment

Запись на приём к специалистам

Доступно: Агенты Service

🔍 search_knowledge

Автоматически ищет в вашей базе знаний, когда пользователь задаёт вопрос.

Как это работает:

  1. Пользователь задаёт вопрос
  2. Агент преобразует вопрос в вектор эмбеддинга
  3. Ищет в базе знаний топ-5 совпадений (косинусное сходство)
  4. Извлечённый контекст добавляется в промпт ИИ
  5. ИИ генерирует ответ с использованием контекста

Пример:

Пользователь: "Какая у вас политика возврата?"

[Инструмент: search_knowledge]
Запрос: "политика возврата"
Топ-3 результата:
1. "Полный возврат в течение 14 дней, если пройдено менее 20%" (95% совпадение)
2. "Свяжитесь с поддержкой в течение 14 дней для возврата" (87% совпадение)
3. "Возврат обрабатывается в течение 5-7 рабочих дней" (72% совпадение)

Ответ агента:
"Мы предлагаем полный возврат в течение 14 дней с момента покупки,
если вы прошли менее 20% курса. Свяжитесь с поддержкой по адресу
support@example.com для запроса возврата."

💡 Совет: Этот инструмент работает автоматически. Настройка не требуется. Просто убедитесь, что ваша база знаний содержит релевантный контент.

💳 get_payment_link

Получает платёжные ссылки, настроенные в параметрах вашего агента.

Как это работает:

  1. Пользователь спрашивает о продукте или услуге
  2. Агент определяет намерение купить
  3. Инструмент извлекает соответствующую платёжную ссылку
  4. Агент предоставляет ссылку пользователю

Пример:

Пользователь: "Хочу купить курс Python"

[Инструмент: get_payment_link]
Продукт: "Курс Python Mastery"
Ссылка: https://pay.link/python-course

Ответ агента:
"Отлично! Вы можете приобрести курс Python Mastery за $99 по этой ссылке:
https://pay.link/python-course

После оплаты вы получите доступ к материалам курса в течение 5 минут."

🚨 escalate_to_human

Передаёт сложные или чувствительные разговоры человеку-оператору.

Когда используется:

  • Пользователь просит «менеджера» или «оператора»
  • Обнаружены ключевые слова эскалации («возврат», «жалоба»)
  • Пользователь задаёт один и тот же вопрос несколько раз
  • Обнаружен негативный тон (расстроенный пользователь)

Пример:

Пользователь: "Я хочу поговорить с менеджером"

[Инструмент: escalate_to_human]
Причина: Обнаружено ключевое слово "менеджер"
Уведомление отправлено: @admin_username

Ответ агента:
"Я понимаю вашу ситуацию. Сейчас я передам ваш запрос менеджеру.
Он свяжется с вами в ближайшее время."

📅 book_appointment

Позволяет пользователям записываться на приём к специалистам.

Как это работает:

  1. Пользователь просит записаться на услугу
  2. Агент запрашивает предпочтения (дата, время, специалист)
  3. Инструмент проверяет доступные слоты
  4. Агент подтверждает запись
  5. Запись сохраняется в базе данных

Пример:

Пользователь: "Хочу записаться на стрижку"

Агент: "Конечно! К какому специалисту вы хотите записаться?"

Пользователь: "К Ольге"

[Инструмент: book_appointment]
Специалист: Ольга
Услуга: Стрижка
Доступные слоты: Завтра 14:00, 15:30, 17:00

Агент: "У Ольги есть свободные слоты:
• Завтра в 14:00
• Завтра в 15:30
• Завтра в 17:00

Какое время вам подходит?"

⚙️ Настройка инструментов

Большинство инструментов работают автоматически. Вот что нужно настроить:

ИнструментНастройка
search_knowledgeАвтоматически (добавьте знания)
get_payment_linkДобавьте платёжные ссылки в настройках
escalate_to_humanНастройте Telegram для уведомлений
book_appointmentДобавьте специалистов и услуги

📚 Следующие шаги

  • Эскалация — Узнайте, как работает передача человеку
  • Биллинг — Цены на токены и отслеживание затрат
  • Ваши агенты — Настройте инструменты для ваших агентов