
Open AI Agent > Data connectors to view Integrations, MCP servers, and Custom API connectors.
Выберите тип коннектора
Страница «Data connectors» предлагает три способа подключения внешнего сервиса:Добавление инструментов коннектора в навык ИИ-агента
Подключение сервиса не добавляет автоматически все доступные инструменты каждому ИИ-агенту. Выберите инструменты, которые каждый агент может использовать в своих навыках.- Откройте ИИ-агента, которого хотите настроить.
- В разделе Profile найдите Skills и нажмите Manage.
- Создайте навык или откройте существующий.
- В поле Step-by-Step instructions введите /.
- Разверните соответствующую группу ( Integration, MCP или Data connectors ) и выберите инструмент, который хотите вставить.
- Опишите, когда использовать инструмент, какую информацию собирать и что делать с полученным результатом.
- Сохраните навык, протестируйте его в режиме предварительного просмотра (Preview) и опубликуйте ИИ-агента, когда он будет готов.

Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration.
Пример: поиск заказа в Shopify
В этом примере создается навык, способный отвечать на вопросы о заказе клиента в Shopify и его доставке.1. Подключите Shopify Admin
- Перейдите в AI Agent > Data connectors.
- На вкладке Integrations откройте Shopify Admin и завершите процесс авторизации.
- Убедитесь, что для интеграции отображается статус Connected.
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Поиск заказа ShopifyStart trigger
Используйте этот навык, когда клиент спрашивает о статусе заказа Shopify, доставке, возврате товара или средств. Не используйте его для рекомендаций товаров, вопросов об оформлении заказа или запросов на изменение заказа.Step-by-Step instructions
- Запросите у клиента информацию, необходимую для идентификации заказа.
- Введите / и вставьте
find_ordersиз Integration · Shopify Admin. Используйте этот инструмент для поиска подходящего заказа. - Если ни один заказ не найден или найдено несколько заказов, попросите у клиента дополнительные идентификационные данные. Не пытайтесь угадать, какой заказ имеется в виду.
- Вставьте и используйте
get_orderдля найденного заказа. - Если клиент спрашивает о доставке, вставьте и используйте
get_order_fulfillments. Используйтеget_fulfillment_events, когда требуются подробности событий отслеживания. - Если клиент спрашивает о возврате товара или средств, вставьте соответствующий инструмент возврата.
- Обобщайте только ту информацию, которую вернули инструменты. Если инструмент вернул ошибку или запрошенные данные недоступны, объясните, что не можете подтвердить результат, и при необходимости передайте обращение оператору.
3. Протестируйте перед публикацией
В режиме предварительного просмотра (Preview) протестируйте как минимум следующие сценарии:- Данным клиента соответствует один заказ
- Ни один заказ не соответствует данным
- Данным соответствуют несколько заказов
- Сведения о выполнении или отслеживании недоступны
- Инструмент Shopify возвращает ошибку
- Клиент просит Агента изменить заказ, что невозможно сделать через интеграцию Shopify Admin, доступную только для чтения
Создание коннектора Custom API
Используйте коннектор Custom API, когда требуется, чтобы навык AI Agent вызывал ваш собственный HTTPS API. На вкладке Custom API выберите New data connector. Вы также можете искать существующие коннекторы Custom API по названию и фильтровать их по статусу.Open AI Agent > Data connectors, then select New data connector.
Название и описание
Укажите название коннектора, отражающее его назначение, напримерretrieve_order. В описании поясните, когда следует использовать коннектор и что он возвращает.
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 удаляет данные.
Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.
HTTP-заголовки
Выберите Add header, затем укажите каждый необходимый заголовок в виде пары «ключ-значение».Select Add header and enter each header as a key-value pair. This example has not been saved or sent.
Тело запроса
Для запросов, отправляющих данные, укажите корректное тело запроса в формате JSON, содержащее обязательные для вашего API поля.Enter valid JSON in Request Body. This fictional order example has not been sent.
Тестирование ответа
Нажмите Test request , чтобы проверить, возвращает ли коннектор ожидаемый ответ.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 или отключите его статус в списке коннекторов. Проверьте и устраните все указанные зависимости перед переводом в черновик.Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.

