Connect tools & data

Подключения API

Превратите любой HTTP API в функцию, которую ваш агент может вызывать в ходе разговора: вставьте команду cURL, и мастер создаст определение инструмента, параметры и аутентификацию.

API-подключения — это пользовательские HTTP-функции, которые ваши агенты могут вызывать во время разговора: искать заказ, создавать тикет, получать статус аккаунта из вашего собственного бэкенда. Вы определяете конечную точку один раз в разделе Подключения → API (/dashboard/api-connections); затем агенты, к которым подключено это подключение, могут вызывать её, когда это требуется в разговоре.

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

Быстрый способ: вставить и проанализировать#

1. Нажмите «Новое API-подключение»

   Откроется диалог с мастером. Вставьте в поле пример команды cURL, спецификацию OpenAPI/Swagger, экспорт Postman, интерфейс TypeScript или схему Zod.

2. Нажмите «Анализировать»

   ThunderPhone определит всё подключение по вставленным данным — URL, метод, заголовки и схему параметров на основе найденных параметров запроса и тела запроса. Вставленные заголовки, включая заголовки авторизации, будут перенесены в настройки конечной точки.

3. Подтвердите выделенные поля

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

4. Проверить и сохранить

   Перед сохранением выполняется тестовый запрос к вашей конечной точке. Если запрос завершится ошибкой, подключение не будет сохранено — исправьте URL, заголовки авторизации или тело запроса и повторите попытку. При успехе подключение будет сохранено со статусом Проверено.

Если мастер не сможет найти URL запроса во вставленных данных, он сообщит об этом — добавьте полный адрес конечной точки http(s) и повторите попытку.

Ручная настройка#

Нажмите Настроить вручную → в мастере (или Хотите, чтобы ИИ определил это? Попробуйте мастер →, чтобы вернуться). В конструкторе ручной настройки есть два редактора:

• Визуальный — поля формы для отображаемого имени, имени функции, URL запроса, метода (POST, GET, PUT, PATCH, DELETE), пользовательских заголовков и схемы параметров (Добавить свойство для каждого аргумента, который может передать агент).
• JSON — то же определение в виде исходного JSON для вставки или точной настройки спецификации инструмента напрямую.

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

Управление подключениями#

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

• Редактировать — снова открыть конфигурацию.
• Клонировать — создать дубликат в качестве отправной точки (копия будет иметь статус «Не проверено»).
• История версий — просмотреть предыдущие версии и восстановить одну из них в редакторе.
• Перенести — скопировать или переместить подключение в другую организацию, в которой вы состоите. При перемещении оно будет удалено отсюда; агентам, которые его использовали, может потребоваться перенастройка.
• Удалить — безвозвратно; агентов, использующих подключение, потребуется перенастроить.

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

Добавьте подключение к агенту в разделе API-подключений конструктора (Создание агента). В списке указано, какие агенты используют каждое подключение, поэтому вы сразу увидите, на что повлияет изменение.

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