SDK del agente (versión preliminar)

Reenvía las cargas de actividad del SDK de Bot Framework o Microsoft Agents a un punto de conexión del agente proporcionado por el usuario. La dirección URL del punto de conexión del agente se proporciona por llamada como parámetro de entrada. La autenticación se selecciona al crear la conexión: sin autenticación, una clave de API estática o Microsoft Entra ID OAuth (client_credentials). Cuando se selecciona OAuth, la audiencia del token de portador (dirección URL de recurso configurada en la conexión) debe coincidir con la audiencia esperada por el agente de destino.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Estándar	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Estándar	Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Estándar	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Microsoft
DIRECCIÓN URL	https://support.microsoft.com

Metadatos del conector
Publicador	Microsoft
Sitio web	https://www.microsoft.com
Directiva de privacidad	https://privacy.microsoft.com/
Categorías	Productividad

El conector del SDK del agente reenvía las cargas de actividad del SDK de Bot Framework o Microsoft Agents a un punto de conexión del agente proporcionado por el usuario. La dirección URL del punto de conexión del agente se proporciona por llamada como parámetro de entrada; La plataforma emite tokens de OAuth desde las credenciales de aplicación de Microsoft Entra ID proporcionadas por el usuario configuradas en la conexión e insertadas como token de portador en cada solicitud saliente. La audiencia del token de portador (dirección URL de recurso configurada en la conexión) debe coincidir con la audiencia esperada por el agente de destino.

Prerequisites

Un SDK de agentes de Microsoft implementado o agente de Bot Framework accesible a través de HTTPS.
Una aplicación Microsoft Entra ID registrada en el inquilino que hospeda el agente, configurada con la client_credentials concesión y el permiso para llamar al agente de destino.
Audiencia de tokens esperada del agente (normalmente el identificador de aplicación de Microsoft del agente, por ejemplo api://<appId>).

Obtención de las credenciales

Para autenticar las solicitudes de API, necesitará lo siguiente:

Identificador de inquilino de la aplicación Microsoft Entra ID.
Identificador de cliente (id. de aplicación) de la aplicación Microsoft Entra ID.
Secreto de cliente para esa aplicación.
La dirección URL del recurso que coincide con la audiencia esperada por el agente de destino (patrón de autenticación de aptitudes de Bot Framework).

Proporcione estos valores al crear una conexión. Cree una conexión por agente si las audiencias difieren.

Limitaciones y problemas conocidos

La agentEndpoint entrada debe ser una dirección URL HTTPS completa (por ejemplo, https://my-agent.azurewebsites.net). El conector anexa /api/messages y reenvía la carga de actividad.
El conector reenvía la carga de actividad as-is y no establece deliveryMode. El agente responde de forma asincrónica (entrega normal) mediante el POSTing reply activities back to the serviceUrl supplied on the inbound activity (the caller, p. ej., Microsoft Copilot Studio, proporciona una devolución de llamada serviceUrlcon clave SAS ).
Este conector está en versión preliminar. La disponibilidad y las funcionalidades están sujetas a cambios.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Clave de API	Autentíquese con una clave de API estática que el agente de destino espera en un encabezado HTTP personalizado. Especifique el nombre del encabezado (por ejemplo, x-api-key) y su valor.	Todas las regiones	No se puede compartir
Microsoft Entra ID (credenciales de cliente)	Mint OAuth bearer tokens de una aplicación de Microsoft Entra ID mediante el flujo de client_credentials. La audiencia del token de portador (DIRECCIÓN URL del recurso) debe coincidir con la audiencia esperada por el agente de destino.	Todas las regiones	No se puede compartir
Sin autenticación	Llame al punto de conexión del agente de destino sin ningún encabezado de autenticación. Úselo solo con agentes que acepten explícitamente llamadas anónimas.	Todas las regiones	Compartible
Valor predeterminado [EN DESUSO]	Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.	Todas las regiones	No se puede compartir

Clave de API

Identificador de autenticación: apiKey

Aplicable: Todas las regiones

Autentíquese con una clave de API estática que el agente de destino espera en un encabezado HTTP personalizado. Especifique el nombre del encabezado (por ejemplo, x-api-key) y su valor.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Required
Nombre del encabezado de clave de API	string	Nombre del encabezado HTTP en el que el agente de destino espera la clave de API (por ejemplo, x-api-key o Ocp-Apim-Subscription-Key).	True
Valor de clave de API	securestring	Valor de clave de API estática enviado en cada solicitud al punto de conexión del agente de destino.	True

Microsoft Entra ID (credenciales de cliente)

Identificador de autenticación: oauthClientCredentials

Aplicable: Todas las regiones

Mint OAuth bearer tokens de una aplicación de Microsoft Entra ID mediante el flujo de client_credentials. La audiencia del token de portador (DIRECCIÓN URL del recurso) debe coincidir con la audiencia esperada por el agente de destino.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Required
Inquilino	string	Identificador de inquilino de para la aplicación de Microsoft Entra ID	True
Id de cliente	string	Identificador de cliente (o aplicación) de la aplicación Microsoft Entra ID.	True
Secreto del cliente	securestring	Secreto de cliente de la aplicación Microsoft Entra ID.	True
Dirección URL del recurso	string	Audiencia del token de OAuth. Normalmente, el identificador de aplicación de Microsoft del agente de destino (por ejemplo, api://< appId> o el GUID del identificador de aplicación).	True

Sin autenticación

Identificador de autenticación: anónimo

Aplicable: Todas las regiones

Llame al punto de conexión del agente de destino sin ningún encabezado de autenticación. Úselo solo con agentes que acepten explícitamente llamadas anónimas.

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para obtener más información, consulte la información general de Connectors para aplicaciones de lienzo: Power Apps | Microsoft Docs

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Acciones

Envío de actividad al agente

Reenvía una carga del protocolo de actividad al punto de conexión del agente en {agentEndpoint}/api/messages. Cuando la conexión usa Microsoft Entra ID OAuth, la audiencia de tokens (dirección URL de recurso en la conexión) debe ser igual a la audiencia esperada por el agente de destino (patrón de autenticación de aptitudes de Bot Framework); cree una conexión por agente si las audiencias difieren. El conector reenvía la carga de actividad as-is y no establece "deliveryMode"; el agente responde de forma asincrónica (entrega normal) mediante el POSTing reply activities to the 'serviceUrl' proporcionado en la actividad entrante.

Envío de actividad al agente

Id. de la operación:: SendActivity

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Dirección URL del punto de conexión del agente	agentEndpoint	True	string	Dirección URL base del SDK de agentes de Microsoft de destino o punto de conexión de Bot Framework (por ejemplo, https://my-agent.azurewebsites.net). El conector anexa /api/messages.
			object

SDK del agente (versión preliminar)

Prerequisites

Obtención de las credenciales

Limitaciones y problemas conocidos

Creación de una conexión

Clave de API

Microsoft Entra ID (credenciales de cliente)

Sin autenticación

Valor predeterminado [EN DESUSO]

Acciones

Envío de actividad al agente

Parámetros

Devoluciones

Definiciones

object