> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Коннекторы данных

> Подключайте внешние сервисы через Integrations, MCP или Custom API и используйте их инструменты в навыках AI-агента.

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

Откройте **AI Agent > Data connectors**, чтобы просматривать подключения и управлять ими.

![Страница Data connectors с вкладками Integrations, MCP и Custom API и доступными интеграциями.](https://mintcdn.com/lchnan/RNoD5r5OXiTray6k/product-assets/english-help-2026-10-30/data-connectors-integrations.png?fit=max\&auto=format\&n=RNoD5r5OXiTray6k\&q=85\&s=f70d467e86e5027f147b3b063f161a36)

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

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

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

| Тип | Назначение |
| - | - |
| **Integrations** | Подключение поддерживаемого сервиса с помощью пошагового процесса авторизации. Например, Shopify Admin предоставляет инструменты только для чтения заказов, отслеживания доставки, возвратов и возмещения средств. |
| **MCP** | Подключение MCP-сервера и предоставление AI-агентам доступа к инструментам, которые он предлагает. |
| **Custom API** | Создание пользовательского HTTP-запроса к HTTPS-эндпоинту, когда требуется подключить собственный API. |

Выберите соответствующую вкладку, чтобы найти существующее подключение или настроить новое.

## Добавление инструментов коннектора в навык 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.](https://mintcdn.com/lchnan/RNoD5r5OXiTray6k/product-assets/english-help-2026-10-30/shopify-skill-command-menu.png?fit=max\&auto=format\&n=RNoD5r5OXiTray6k\&q=85\&s=beb0f5f6d2938e563088e177eca982c4)

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

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

Дополнительные рекомендации по триггерам, инструкциям и тестированию см. в разделе [AI Skills](https://docs.ycloud.com/ru/documentation/agents/ai-agent/ai-skills.md).

## Пример: поиск заказа 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. Обобщайте только информацию, возвращенную инструментами. Если инструмент завершился с ошибкой или запрошенная информация недоступна, сообщите, что результат невозможно подтвердить, и при необходимости передайте диалог оператору.

> [!NOTE]
>
> После подключения 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.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-list-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=1e69a488687c963b905ed5916ebd9b9c)

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

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

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

![Шаг About для коннектора данных с выделенными полями названия и описания.](https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-about-annotated.svg?fit=max\&auto=format\&n=gXEJIQXV2JH2VUQJ\&q=85\&s=a57c6777577f87f55494f26d51d28eb2)

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.](https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-api-annotated.svg?fit=max\&auto=format\&n=gXEJIQXV2JH2VUQJ\&q=85\&s=5effb08c414cdb9ecc3bce86ed58e377)

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

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

Выберите **Add header**, затем введите каждый обязательный заголовок в виде пары «ключ — значение».

![Полная форма подключения API с заголовками запросов Content-Type и Accept.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-headers-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=f23c6cb0a8f850aa38a904ed0d1900cf)

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

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

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

![Страница коннектора данных, прокрученная до тела POST-запроса в формате JSON.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-body-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=5099ae99db2d135e6253c53ecefb9937)

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

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

Выберите **Test request**, чтобы убедиться, что коннектор возвращает ожидаемый ответ.

> [!WARNING]
>
> **При тестировании отправляется реальный API-запрос.** Запрос POST, PUT, PATCH или DELETE может создать, изменить или удалить данные. По возможности выполняйте тестирование в безопасной среде или начните с GET-запроса только для чтения.

![Шаг Test response с кнопкой Test Request и отключенной кнопкой Set live.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-test-entry-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=087754abdc3b082833f41e0822a3261c)

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 для существующих активных коннекторов.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-status-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=36fb2456c31e1e068179cc06e978feed)

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.