Перейти к основному содержанию
Коннекторы данных позволяют AI-агентам использовать инструменты внешних сервисов. Настройте подключение один раз, а затем добавьте в навыки конкретные инструменты, необходимые каждому агенту. Откройте AI Agent > Data connectors, чтобы просматривать подключения и управлять ими.
Страница Data connectors с вкладками Integrations, MCP и Custom API и доступными интеграциями.

Open AI Agent > Data connectors to view Integrations, MCP servers, and Custom API connectors.

​
Выбор типа коннектора

На странице Data connectors доступны три способа подключения внешнего сервиса: Выберите соответствующую вкладку, чтобы найти существующее подключение или настроить новое.

​
Добавление инструментов коннектора в навык AI-агента

При подключении сервиса все доступные инструменты не добавляются автоматически каждому AI-агенту. Выберите в навыках инструменты, которые сможет использовать каждый агент.
  1. Откройте AI-агента, которого хотите настроить.
  2. В разделе Profile найдите Skills и выберите Manage.
  3. Создайте навык или откройте существующий.
  4. В поле Step-by-Step instructions введите /.
  5. Разверните соответствующую группу Integration, MCP или Data connectors, затем выберите инструмент, который хотите вставить.
  6. Объясните, когда использовать инструмент, какие данные собирать и что делать с результатом.
  7. Сохраните навык, протестируйте его в Preview и опубликуйте AI-агента, когда он будет готов.
Редактор навыка AI-агента с меню команд, содержащим инструменты Shopify Admin.

Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration.

Для каждого шага с коннектором четко опишите действия при успешном результате, пустом результате и ошибке. Не просите AI-агента делать выводы на основе данных, которые инструмент не возвращает.
Дополнительные рекомендации по триггерам, инструкциям и тестированию см. в разделе AI Skills.

​
Пример: поиск заказа Shopify

В этом примере создается навык, который может отвечать на вопросы о заказе клиента в Shopify и его доставке.

​
1. Подключите Shopify Admin

  1. Перейдите в AI Agent > Data connectors.
  2. На вкладке Integrations откройте Shopify Admin и завершите процесс авторизации.
  3. Убедитесь, что интеграция имеет статус Connected.
Shopify Admin предоставляет следующие инструменты только для чтения:
  • find_orders — поиск заказа по информации, предоставленной клиентом
  • get_order — получение выбранного заказа
  • get_order_fulfillments — получение сведений об отправке и выполнении заказа
  • get_fulfillment_events — получение событий отслеживания доставки
  • get_order_returns и get_return — получение сведений о возврате
  • get_order_refunds и get_refund — получение сведений о возмещении средств

​
2. Создайте навык

В разделе Profile AI-агента выберите Manage в блоке Skills, затем создайте навык со следующими настройками. Name
Поиск заказа Shopify
Start trigger
Используйте этот навык, когда клиент спрашивает о статусе заказа, доставки, возврата или возмещения средств в Shopify. Не используйте его для рекомендаций товаров, вопросов об оформлении покупки или запросов на изменение заказа.
Step-by-Step instructions
  1. Запросите у клиента информацию, необходимую для идентификации заказа.
  2. Введите / и вставьте find_orders из Integration · Shopify Admin. Используйте этот инструмент, чтобы найти соответствующий заказ.
  3. Если заказ не найден или найдено несколько заказов, запросите у клиента дополнительные идентификационные данные. Не пытайтесь угадать, какой заказ он имеет в виду.
  4. Вставьте и используйте get_order для найденного заказа.
  5. Если клиент спрашивает о доставке, вставьте и используйте get_order_fulfillments. Используйте get_fulfillment_events, когда нужны сведения о событиях отслеживания.
  6. Если клиент спрашивает о возврате или возмещении средств, вставьте соответствующий инструмент.
  7. Обобщайте только информацию, возвращенную инструментами. Если инструмент завершился с ошибкой или запрошенная информация недоступна, сообщите, что результат невозможно подтвердить, и при необходимости передайте диалог оператору.
После подключения Shopify Admin названия указанных инструментов появятся в меню команд /. Выбирайте команды в этом меню, а не вводите их названия как обычный текст.

​
3. Протестируйте перед публикацией

Протестируйте в Preview как минимум следующие случаи:
  • Информации клиента соответствует один заказ
  • Заказ не найден
  • Найдено несколько заказов
  • Сведения о выполнении или отслеживании недоступны
  • Инструмент Shopify возвращает ошибку
  • Клиент просит агента изменить заказ, что невозможно с интеграцией Shopify Admin, доступной только для чтения

​
Создание коннектора Custom API

Используйте коннектор Custom API, если хотите, чтобы навык AI-агента вызывал ваш собственный HTTPS API. На вкладке Custom API выберите New data connector. Вы также можете искать существующие коннекторы Custom API по названию и фильтровать их по статусу.
Полная страница Data connectors с поиском, фильтрами статуса, существующими коннекторами и New data connector.

Open AI Agent > Data connectors, then select New data connector.

​
Название и описание

Дайте коннектору название, описывающее его функцию, например retrieve_order. В описании укажите, когда следует использовать коннектор и какие данные он возвращает.
Шаг About для коннектора данных с выделенными полями названия и описания.

Describe the connector's purpose in About before configuring its API request. This draft has not been saved.

​
Настройка API-запроса

Введите HTTPS-эндпоинт и выберите метод запроса:
  • GET считывает информацию.
  • POST создает информацию.
  • PUT заменяет или обновляет информацию.
  • PATCH обновляет часть ресурса.
  • DELETE удаляет информацию.
Шаг подключения API для коннектора данных с выделенными HTTP-методом и URL.

Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.

​
HTTP-заголовки

Выберите Add header, затем введите каждый обязательный заголовок в виде пары «ключ — значение».
Полная форма подключения API с заголовками запросов Content-Type и Accept.

Select Add header and enter each header as a key-value pair. This example has not been saved or sent.

​
Тело запроса

Для запросов, отправляющих данные, введите корректное тело запроса в формате JSON с полями, необходимыми вашему API.
Страница коннектора данных, прокрученная до тела POST-запроса в формате JSON.

Enter valid JSON in Request Body. This fictional order example has not been sent.

​
Проверка ответа

Выберите Test request, чтобы убедиться, что коннектор возвращает ожидаемый ответ.
При тестировании отправляется реальный API-запрос. Запрос POST, PUT, PATCH или DELETE может создать, изменить или удалить данные. По возможности выполняйте тестирование в безопасной среде или начните с GET-запроса только для чтения.
Шаг Test response с кнопкой Test Request и отключенной кнопкой Set live.

Select Test Request to run the configured API call. No request has been run in this example.

​
Активация коннектора

После успешного тестирования выберите Set live. Активные коннекторы Custom API можно выбирать в меню команд / в инструкциях навыка. Чтобы прекратить использование коннектора Custom API, откройте его и выберите Set to draft или отключите его статус в списке коннекторов. Перед переводом коннектора в черновик проверьте и устраните все указанные зависимости.
Полный список Data connectors с переключателями Status для существующих активных коннекторов.

Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.