Перейти к содержанию

Инструменты

Инструменты позволяют агентам SpeakNode вызывать внешние API во время разговора — получать данные, выполнять действия и взаимодействовать с вашими системами.

Создание webhook-инструмента

  1. Перейдите в раздел Tools в https://app.speaknode.com
  2. Нажмите Create Tool
  3. Заполните параметры инструмента:

Основные параметры

Поле Описание
Name Человекочитаемое название инструмента
Code Уникальный идентификатор (латиница, подчёркивания). LLM использует его для вызова инструмента
Description Описание для LLM — когда и зачем использовать инструмент. Чем точнее описание, тем корректнее агент будет вызывать инструмент

HTTP-запрос

Поле Описание
Method HTTP-метод: GET, POST, PUT, DELETE
URL Адрес эндпоинта. Поддерживает подстановку переменных

Заголовки

Кастомные HTTP-заголовки определяются через OpenAPI-схему. Это позволяет задать заголовки, значения которых LLM сформирует динамически.

Пример схемы заголовков: 

{
  "type": "object",
  "properties": {
    "X-Api-Key": {
      "type": "string",
      "description": "API ключ для аутентификации"
    }
  }
}

Тело запроса

Тело HTTP-запроса также определяется через OpenAPI-схему. Схема описывает структуру JSON, который LLM должен сформировать на основе контекста разговора.

Пример схемы тела: 

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Номер заказа клиента"
    },
    "question": {
      "type": "string",
      "description": "Вопрос клиента о заказе"
    }
  },
  "required": ["order_id"]
}

Описания в схеме

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

Pre-tool speech

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

  1. В настройках инструмента найдите поле Pre-tool speech
  2. Введите текст, который агент скажет перед вызовом

Примеры:

  • «Сейчас проверю информацию по вашему заказу...»
  • «Одну секунду, загружаю данные...»
  • «Подождите, пожалуйста, я уточняю информацию...»

Привязка инструмента к агенту

После создания инструмента его необходимо привязать к агенту:

  1. Откройте страницу агента
  2. Перейдите на вкладку Tools
  3. Нажмите Add Tool и выберите инструмент из списка
  4. Инструмент станет доступен агенту во время разговоров

Один инструмент — несколько агентов

Один инструмент можно привязать к нескольким агентам. Это удобно для общих интеграций, например проверки статуса заказа.

Системные инструменты

Помимо пользовательских webhook-инструментов, платформа предоставляет встроенные системные инструменты:

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

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

Правила переключения

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

  1. В настройках инструмента перейдите к секции Transfer Rules
  2. Нажмите Add Rule
  3. Настройте правило:
Поле Описание
Target Agent Агент, которому будет передан разговор
Condition Условие, при котором происходит переключение

Пример сценария:

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

Мультиагентные сценарии

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

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

  1. LLM анализирует контекст разговора и решает, что нужен вызов инструмента
  2. Агент произносит pre-tool speech (если настроен)
  3. Платформа формирует HTTP-запрос по OpenAPI-схеме
  4. Запрос отправляется на указанный URL
  5. Ответ передаётся обратно в LLM
  6. LLM включает полученные данные в свой следующий ответ