Пакет SDK агента (предварительная версия)

Перенаправит полезные данные действий пакета SDK для агентов Bot Framework или Microsoft в конечную точку агента, предоставленной пользователем. URL-адрес конечной точки агента предоставляется для каждого вызова в качестве входного параметра. Проверка подлинности выбирается при создании подключения: проверка подлинности, статический ключ API или Microsoft Entra ID OAuth (client_credentials). При выборе OAuth аудитория маркера носителя (URL-адрес ресурса, настроенный для подключения), должна соответствовать аудитории, ожидаемой целевым агентом.

Этот соединитель доступен в следующих продуктах и регионах:

Service	Class	Regions
Copilot Studio	Стандарт	Все регионы Power Automate за исключением следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Стандарт	Все регионы Power Apps кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Стандарт	Все регионы Power Automate за исключением следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя.	Microsoft
URL	https://support.microsoft.com

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://www.microsoft.com
Политика конфиденциальности	https://privacy.microsoft.com/
Categories	Продуктивность

Соединитель SDK агента перенаправит полезные данные действия пакета SDK Для агентов Bot Framework или Microsoft в конечную точку агента, предоставленной пользователем. URL-адрес конечной точки агента предоставляется для каждого вызова в качестве входного параметра; Маркеры OAuth вымят платформой из предоставленных пользователем Microsoft Entra ID учетных данных приложения, настроенных для подключения, и внедряются в качестве маркера носителя для каждого исходящего запроса. Аудитория маркера носителя (URL-адрес ресурса, настроенный для подключения), должна соответствовать аудитории, ожидаемой целевым агентом.

Prerequisites

• Развернутый пакет SDK для агентов Microsoft или агент Bot Framework, доступный по протоколу HTTPS.
• Приложение Microsoft Entra ID, зарегистрированное в клиенте, на котором размещен агент, настроено с предоставлением client_credentials и разрешением на вызов целевого агента.
• Ожидаемая аудитория маркеров агента (например, api://<appId>идентификатор приложения Microsoft агента).

Получите ваши учетные данные

Для проверки подлинности запросов API вам потребуется:

1. Идентификатор клиента приложения Microsoft Entra ID.
2. Идентификатор клиента (идентификатор приложения) приложения Microsoft Entra ID.
3. Секрет клиента для этого приложения.
4. URL-адрес ресурса, соответствующий аудитории целевому агенту (шаблон проверки подлинности навыка Bot Framework).

Укажите эти значения при создании подключения. Создайте одно подключение для каждого агента, если аудитории отличаются.

Известные проблемы и ограничения

• Входные agentEndpoint данные должны быть полным URL-адресом HTTPS (например, https://my-agent.azurewebsites.net). Соединитель добавляет /api/messages и перенаправит полезные данные действия.
• Соединитель перенаправит полезные данные действия as-is и не задает deliveryMode. Агент отвечает асинхронно (обычной доставкой), выполняя действия ответа POSTing обратно serviceUrl в предоставленный для входящего действия (вызывающий объект, например, Microsoft Copilot Studio, обеспечивает обратный serviceUrlвызов с ключом SAS).
• Этот соединитель находится в предварительной версии. Доступность и возможности могут быть изменены.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

Ключ API	Проверка подлинности со статическим ключом API, который целевой агент ожидает в пользовательском заголовке HTTP. Укажите имя заголовка (например, x-api-key) и его значение.	Все регионы	Недоступен для совместного использования
Microsoft Entra ID (учетные данные клиента)	Маркеры носителя OAuth мяты из приложения Microsoft Entra ID с помощью потока client_credentials. Аудитория маркера носителя (URL-адрес ресурса) должна соответствовать аудитории, ожидаемой целевым агентом.	Все регионы	Недоступен для совместного использования
Без проверки подлинности	Вызовите конечную точку целевого агента без заголовка проверки подлинности. Используйте это только с агентами, которые явно принимают анонимные вызовы.	Все регионы	Доступный для общего пользования
По умолчанию [не рекомендуется]	Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.	Все регионы	Недоступен для совместного использования

Ключ API

Идентификатор проверки подлинности: apiKey

Применимо: все регионы

Проверка подлинности со статическим ключом API, который целевой агент ожидает в пользовательском заголовке HTTP. Укажите имя заголовка (например, x-api-key) и его значение.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя.	Тип	Description	Обязательный
Имя заголовка ключа API	string	Имя заголовка HTTP, в котором целевой агент ожидает ключ API (например, x-api-key или Ocp-Apim-Subscription-Key).	True
Значение ключа API	Securestring	Значение ключа статического API, отправленное при каждом запросе в конечную точку целевого агента.	True

Microsoft Entra ID (учетные данные клиента)

Идентификатор проверки подлинности: oauthClientCredentials

Применимо: все регионы

Маркеры носителя OAuth мяты из приложения Microsoft Entra ID с помощью потока client_credentials. Аудитория маркера носителя (URL-адрес ресурса) должна соответствовать аудитории, ожидаемой целевым агентом.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя.	Тип	Description	Обязательный
Tenant	string	Идентификатор клиента для приложения Microsoft Entra ID	True
идентификатор клиента	string	Идентификатор клиента (или приложения) приложения Microsoft Entra ID.	True
Секрет клиента	Securestring	Секрет клиента приложения Microsoft Entra ID.	True
URL-адрес ресурса	string	Аудитория маркера OAuth. Обычно идентификатор приложения целевого агента Microsoft (например, api://< appId> или GUID идентификатора приложения).	True

Без аутентификации

Идентификатор проверки подлинности: анонимный

Применимо: все регионы

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

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре Connectors для приложений холста — Power Apps | Документация Майкрософт

По умолчанию [не рекомендуется]

Применимо: все регионы

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Действия

Отправка действия агенту

Перенаправляет полезные данные протокола действий в конечную точку агента в {agentEndpoint}/api/messages. Если подключение использует Microsoft Entra ID OAuth, аудитория маркеров (URL-адрес ресурса подключения) должна равенства аудитории, ожидаемой целевым агентом (шаблон проверки подлинности навыка Bot Framework); создайте одно подключение для каждого агента, если аудитория отличается. Соединитель перенаправит полезные данные действия as-is и не задает "deliveryMode"; агент отвечает асинхронно (обычной доставкой), выполняя действия ответа POSTing на запрос serviceUrl, предоставленный для входящего действия.

Отправка действия агенту

Идентификатор операции:

SendActivity

Перенаправляет полезные данные протокола действий в конечную точку агента в {agentEndpoint}/api/messages. Если подключение использует Microsoft Entra ID OAuth, аудитория маркеров (URL-адрес ресурса подключения) должна равенства аудитории, ожидаемой целевым агентом (шаблон проверки подлинности навыка Bot Framework); создайте одно подключение для каждого агента, если аудитория отличается. Соединитель перенаправит полезные данные действия as-is и не задает "deliveryMode"; агент отвечает асинхронно (обычной доставкой), выполняя действия ответа POSTing на запрос serviceUrl, предоставленный для входящего действия.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес конечной точки агента	agentEndpoint	True	string	Базовый URL-адрес целевого пакета SDK для агентов Microsoft или конечной точки Bot Framework (например, https://my-agent.azurewebsites.net). Соединитель добавляет /api/messages.
			object

Возвращаемое значение

response

object

Определения

object

Это тип object.