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

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

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

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

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

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

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

Предусмотрите для каждого шага коннектора четкий сценарий успешного выполнения, сценарий для пустого результата и сценарий обработки ошибок. Не требуйте от ИИ-агента додумывать информацию, которую инструмент не возвращает.
Дополнительные рекомендации по триггерам, инструкциям и тестированию см. в разделе 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 ИИ-агента нажмите 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 Agent вызывал ваш собственный HTTPS API. На вкладке Custom API выберите New data connector. Вы также можете искать существующие коннекторы Custom API по названию и фильтровать их по статусу.
Полная страница коннекторов данных с поиском, фильтрами статуса, существующими коннекторами и кнопкой 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 поля.
Полная страница коннектора данных с прокруткой к телу JSON-запроса POST.

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

Тестирование ответа

Нажмите Test request , чтобы проверить, возвращает ли коннектор ожидаемый ответ.
При тестировании отправляется реальный API-запрос. Запрос POST, PUT, PATCH или DELETE может создавать, изменять или удалять данные. По возможности проводите тестирование в безопасной среде или начните с запроса GET, предназначенного только для чтения.
Шаг проверки ответа с кнопкой 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 или отключите его статус в списке коннекторов. Проверьте и устраните все указанные зависимости перед переводом в черновик.
Полный список коннекторов данных с переключателями Status для существующих активных коннекторов.

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