Kit de développement logiciel (SDK) agent (préversion)

Transfère Bot Framework / Microsoft Charges utiles d’activité du KIT SDK Agents vers un point de terminaison d’agent fourni par l’utilisateur. L’URL du point de terminaison de l’agent est fournie par appel en tant que paramètre d’entrée. L’authentification est sélectionnée lors de la création de la connexion : aucune authentification, clé API statique ou Microsoft Entra ID OAuth (client_credentials ou connexion utilisateur). Lorsque OAuth est sélectionné, l’audience du jeton du porteur (URL de ressource configurée sur la connexion) doit correspondre à l’audience attendue par l’agent cible.

Ce connecteur est disponible dans les produits et régions suivants :

Service	Classe	Regions
Copilot Studio	Norme	Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD)
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD)
Power Apps	Norme	Toutes les régions Power Apps à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD)
Power Automate	Norme	Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD)

Contact
Nom	Microsoft
URL	https://support.microsoft.com

Métadonnées du connecteur
Éditeur	Microsoft
Website	https://www.microsoft.com
Politique de confidentialité	https://privacy.microsoft.com/
Catégories	Productivité

Le connecteur du Kit de développement logiciel (SDK) Agent transfère Bot Framework / Microsoft Charges utiles d’activité du KIT DE développement logiciel (SDK) Agents vers un point de terminaison d’agent fourni par l’utilisateur. L’URL du point de terminaison de l’agent est fournie par appel en tant que paramètre d’entrée. La connexion sélectionne la façon dont le connecteur s’authentifie auprès de l’agent : aucune authentification, une clé API statique, un jeton d’application uniquement Microsoft Entra ID (informations d’identification du client) ou un jeton d’utilisateur délégué Microsoft Entra ID (connexion utilisateur). Pour les deux options Microsoft Entra ID, l’audience du jeton du porteur (URL de ressource configurée sur la connexion) doit correspondre à l’audience attendue par l’agent cible.

Prerequisites

Un agent déployé Microsoft Agents SDK / Bot Framework accessible via HTTPS.
Pour Microsoft Entra ID (informations d’identification du client) : une application Microsoft Entra ID inscrite dans le locataire hébergeant l’agent, configurée avec l’octroi et l’autorisation client_credentials d’appeler l’agent cible.
Pour Microsoft Entra ID (connexion utilisateur) : application Microsoft Entra ID de l'agent (son ID d'application Microsoft) avec une clé secrète client, étendue d'API exposée pour laquelle les utilisateurs peuvent donner leur consentement, l'Microsoft Graph User.Read (« Connexion et lecture du profil utilisateur ») délégué avec consentement et https://global.consent.azure-apim.net/redirect/agentsdk ajouté en tant qu’URI de redirection web.
Pour les options de clé API et d'informations d'identification du client, l'audience de jeton attendue de l'agent (généralement l'ID d'application Microsoft de l'agent, par exemple api://<appId> ou le GUID de l'ID d'application). Pour la connexion de l’utilisateur, l’audience doit être le GUID de l’ID d’application (voir ci-dessous).

Obtenir vos informations d’identification

Microsoft Entra ID (informations d’identification du client)

Le connecteur envoie un jeton d’application uniquement. Pour authentifier vos demandes d’API, vous devez :

ID de locataire de l’application Microsoft Entra ID.
ID client (ID d’application) de l’application Microsoft Entra ID.
Clé secrète client pour cette application.
URL de ressource correspondant à l’audience attendue par l’agent cible (modèle d’authentification de compétence Bot Framework).

Fournissez ces valeurs lorsque vous créez une connexion. Créez une connexion par agent si les audiences diffèrent.

Le connecteur envoie le jeton délégué du compte connecté à la connexion, afin que l’agent puisse l’échanger pour le compte (par exemple, avec le gestionnaire Microsoft 365 Agents SDKConnectorUserAuthorization). Vous aurez besoin des éléments suivants :

ID de locataire de l'application Microsoft Entra ID de l'agent.
ID client : l'ID d'application Microsoft de l'agent. Le Microsoft 365 Agents SDK échange le jeton pour le compte de l'utilisateur uniquement lorsque le jeton a été émis à la propre application de l'agent.
Clé secrète client pour cette application.
URL de ressource : ID d'application de l'agent Microsoft (GUID), même valeur que l'ID client. Étant donné que la propre application de l'agent est à la fois le client et la ressource, Microsoft Entra nécessite le GUID ici (AADSTS90009 sinon) ; api://<appId> n'est pas pris en charge pour cette option.

Fournissez ces valeurs lorsque vous créez une connexion, puis connectez-vous et consentez à l’étendue exposée de l’agent. Créez une connexion par agent.

L’application a également besoin de l’autorisation déléguée Microsoft Graph User.Read (« Connexion et lecture du profil utilisateur ») avec consentement ; sans cela, la connexion échoue avec AADSTS90008.

Pour échanger le jeton d’une API en aval, configurez les autorisations déléguées de cette API sur l’application de l’agent et obtenez le consentement de l’utilisateur ou de l’administrateur requis. L’exposition d’une étendue sur l’API de l’agent n’accorde pas d’autorisations en aval.

Problèmes connus et limitations

L’entrée agentEndpoint doit être une URL HTTPS complète (par exemple). https://my-agent.azurewebsites.net Le connecteur ajoute /api/messages et transfère la charge utile d’activité.
Le connecteur transfère la charge utile d’activité as-is et ne définit deliveryModepas . L’agent répond de manière asynchrone (remise normale) par les activités de réponse POSTing à l’activité serviceUrl entrante fournie (l’appelant, par exemple, Microsoft Copilot Studio, fournit un rappel serviceUrlà clé SAS).
Une connexion Microsoft Entra ID (connexion utilisateur) envoie toujours le jeton délégué du compte connecté à la connexion, pour chaque appel effectué avec cette connexion, y compris les appels au nom d’autres personnes qui discutent avec l’agent. Il n’envoie pas de jeton distinct pour chaque appelant, de sorte que l’utilisateur de from l’activité peut différer de l’utilisateur dans le jeton. Autorisez les demandes uniquement en tant que compte dans le jeton validé et ne traitez pas les en-têtes de from l’activité ou les en-têtes de requête comme l’autorité de la personne de conversation. Si l’agent doit agir comme chaque personne qui discute avec elle, n’utilisez pas ce type de connexion.
Si le consentement du compte connecté est révoqué ou que sa session ne peut plus être actualisée, connectez-vous à nouveau à la connexion.
Ce connecteur est en préversion. La disponibilité et les fonctionnalités sont susceptibles de changer.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :


Clé API	Authentifiez-vous avec une clé API statique attendue par l’agent cible dans un en-tête HTTP personnalisé. Spécifiez à la fois le nom de l’en-tête (par exemple, x-api-key) et sa valeur.	Toutes les régions	Impossible à partager
Microsoft Entra ID (informations d’identification du client)	Mint OAuth bearer tokens from a Microsoft Entra ID application using the client_credentials flow. L’audience du jeton du porteur (URL de ressource) doit correspondre à l’audience attendue par l’agent cible.	Toutes les régions	Impossible à partager
Microsoft Entra ID (connexion utilisateur)	Connectez-vous via l'application Microsoft Entra ID de l'agent cible (flux de code d'autorisation) et envoyez le jeton du porteur délégué du compte connecté. Chaque appel effectué avec cette connexion utilise le compte connecté à la connexion, et non la personne qui discute avec l’agent. Pour échanger le jeton pour le compte de l’utilisateur, l’agent a besoin de ses autorisations déléguées en aval et du consentement configurés.	Toutes les régions	Impossible à partager
Aucune authentification	Appelez le point de terminaison de l’agent cible sans en-tête d’authentification. Utilisez-le uniquement avec les agents qui acceptent explicitement les appels anonymes.	Toutes les régions	Partageable
Valeur par défaut [DÉCONSEILLÉE]	Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.	Toutes les régions	Impossible à partager