--- title: "Подключения API" description: "Превратите любой HTTP API в функцию, которую ваш агент может вызывать в ходе разговора: вставьте команду cURL, и мастер создаст определение инструмента, параметры и аутентификацию." --- API-подключения — это пользовательские HTTP-функции, которые ваши агенты могут вызывать во время разговора: искать заказ, создавать тикет, получать статус аккаунта из вашего собственного бэкенда. Вы определяете конечную точку один раз в разделе **Подключения → API** (`/dashboard/api-connections`); затем агенты, к которым подключено это подключение, могут вызывать её, когда это требуется в разговоре. Создать подключение можно двумя способами: вставить данные, которые мастер сможет проанализировать, или настроить подключение вручную. ## Быстрый способ: вставить и проанализировать Откроется диалог с мастером. Вставьте в поле пример **команды cURL**, **спецификацию OpenAPI/Swagger**, **экспорт Postman**, **интерфейс TypeScript** или **схему Zod**. ThunderPhone определит всё подключение по вставленным данным — URL, метод, заголовки и схему параметров на основе найденных параметров запроса и тела запроса. Вставленные заголовки, включая заголовки авторизации, будут перенесены в настройки конечной точки. Определённая конфигурация откроется с выделенными предполагаемыми полями для проверки. Настройте имена, описания и типы параметров, чтобы агент понимал, когда и как вызывать функцию — описание читает модель. Перед сохранением выполняется тестовый запрос к вашей конечной точке. Если запрос завершится ошибкой, подключение не будет сохранено — исправьте URL, заголовки авторизации или тело запроса и повторите попытку. При успехе подключение будет сохранено со статусом **Проверено**. Если мастер не сможет найти URL запроса во вставленных данных, он сообщит об этом — добавьте полный адрес конечной точки `http(s)` и повторите попытку. ## Ручная настройка Нажмите **Настроить вручную →** в мастере (или **Хотите, чтобы ИИ определил это? Попробуйте мастер →**, чтобы вернуться). В конструкторе ручной настройки есть два редактора: - **Визуальный** — поля формы для отображаемого имени, имени функции, **URL** запроса, **метода** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), пользовательских **заголовков** и схемы параметров (**Добавить свойство** для каждого аргумента, который может передать агент). - **JSON** — то же определение в виде исходного JSON для вставки или точной настройки спецификации инструмента напрямую. Панель **Тестовый запрос** (необязательно) позволяет отправить настроенный запрос до сохранения и показывает статус, задержку и предварительный просмотр ответа. **Проверить и сохранить** всегда выполняет этот тест и сохраняет только при успехе. Значения заголовков доступны только для записи. После сохранения они шифруются и больше никогда не отображаются — ни в панели управления, ни в API. При редактировании подключения сохранённый заголовок отображает своё имя, точки вместо значения и пометку **Сохранено**: оставьте всё как есть, чтобы сохранить сохранённое значение, или введите новое, чтобы заменить его. Тестовые запросы и реальные вызовы используют сохранённое значение. **Клонировать** копирует сохранённые значения в новое подключение. Давайте параметрам понятные описания («Адрес электронной почты клиента, например jane@example.com»). Агент выбирает аргументы на основе этих описаний в реальном времени во время звонка. ## Управление подключениями В строке каждого подключения отображаются его статус проверки — **Проверено**, **Не проверено** или **Ошибка** — имя функции и агенты, которые его используют. В меню действий строки можно: - **Редактировать** — снова открыть конфигурацию. - **Клонировать** — создать дубликат в качестве отправной точки (копия будет иметь статус «Не проверено»). - **История версий** — просмотреть предыдущие версии и восстановить одну из них в редакторе. - **Перенести** — скопировать или переместить подключение в другую организацию, в которой вы состоите. При перемещении оно будет удалено отсюда; агентам, которые его использовали, может потребоваться перенастройка. - **Удалить** — безвозвратно; агентов, использующих подключение, потребуется перенастроить. ## Подключение к агенту Добавьте подключение к агенту в разделе API-подключений конструктора ([Создание агента](/ru/guides/build-an-agent)). В списке указано, какие агенты используют каждое подключение, поэтому вы сразу увидите, на что повлияет изменение. ## Следующие шаги Создавайте и управляйте теми же подключениями программно. Готовые подключения Google, Slack, HubSpot, Salesforce и Cal.com. Предоставьте своим агентам доступ к целому серверу инструментов. Все поля ресурса интеграции.