Skip to main content

​
Что такое коннекторы данных?

Коннекторы данных — это глубоко встроенные интеграции, которые позволяют подключать ваши внешние динамические данные к нашей платформе. Отличный способ начать — вспомнить частые вопросы, на ответы на которые ваши коллеги тратят много времени, используя информацию, которая в данный момент недоступна на нашей платформе. Это могут быть вопросы, в которых клиенты просто хотят получить информацию, хранящуюся во внешней системе (например, «Доставлен ли мой заказ?»), или обновить данные во внешней системе (например, «Перенести доставку» или «Оформить возврат»).

​
Создание коннектора данных

Сначала перейдите в AI Agent > Data connectors. Здесь вы можете настраивать коннекторы данных для подключения внешних источников. Чтобы создать коннектор, нажмите New data connector. Вы также можете искать нужные коннекторы данных по их названию и статусу.
Страница коннекторов данных с поиском, фильтрами по статусу, существующими коннекторами и кнопкой New data connector.

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

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

Дайте коннектору данных название, четко отражающее его конкретную функцию (например, «retrieve_order_id»). В поле описания поясните коллегам, когда следует использовать этот коннектор и какие данные он получает (например, «Fetches order details for a provided Order ID»).
Шаг About для коннектора данных с выделенными полями названия и описания.

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

​
Подключение к API

​
API-запрос

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

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

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

Вы можете добавить дополнительные параметры к запросу, нажав Add header , а затем указав Key value pair в разделе HTTP Headers:
Полная форма подключения к API с заголовками запроса Content-Type и Accept.

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

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

Если вы выполняете запрос POST или PUT, вы сможете указать тело запроса с любыми данными, которые хотите отправить:
Страница коннектора данных, прокрученная до тела POST-запроса в формате JSON.

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

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

Затем вам потребуется протестировать ответ коннектора данных, чтобы убедиться, что он получает корректные данные из подключенной внешней системы.
Важно: Тестирование этого запроса выполняет реальное обращение к API и завершает действие настроенного коннектора данных. Например, если настроено действие DELETE через API, данные будут удалены. Попробуйте протестировать с помощью запроса GET, чтобы убедиться, что данные только считываются, а не изменяются.
Нажмите Test request , чтобы проверить правильность настройки коннектора данных.
Шаг тестирования ответа с кнопкой Test Request и неактивной кнопкой Set live.

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

​
Публикация

После успешного тестирования коннектора данных вы готовы перевести его в рабочий режим. Нажмите Set live в правом верхнем углу после успешного завершения теста. В приведенном выше непротестированном примере эта кнопка остается неактивной.

​
Перевод в черновик

Если вы хотите отключить устаревшие коннекторы данных, которые больше не нужны, вы можете перевести их в статус черновика. Для этого нажмите на коннектор данных, который хотите перевести в черновик, и выберите 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.

Система проверит наличие зависимостей у этого коннектора данных. Вам потребуется просмотреть и устранить эти зависимости перед переводом коннектора в статус черновика.