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, une clé API statique ou Microsoft Entra ID OAuth (client_credentials). 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 ; Les jetons OAuth sont frappés par la plateforme à partir des informations d’identification de l’application Microsoft Entra ID fournies par l’utilisateur configurées sur la connexion et injectées en tant que jeton porteur sur chaque demande sortante. 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.
  • 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.
  • Audience de jeton attendue de l'agent (généralement l'ID d'application Microsoft de l'agent, par exempleapi://<appId>).

Obtenir vos informations d’identification

Pour authentifier vos demandes d’API, vous devez :

  1. ID de locataire de l’application Microsoft Entra ID.
  2. ID client (ID d’application) de l’application Microsoft Entra ID.
  3. Clé secrète client pour cette application.
  4. 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.

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).
  • 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
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

Clé API

ID d’authentification : apiKey

Applicable : Toutes les régions

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.

Ce n’est pas une connexion partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Catégorie Description Obligatoire
Nom de l’en-tête de clé API string Nom de l’en-tête HTTP sur lequel l’agent cible attend la clé API (par exemple, x-api-key ou Ocp-Apim-Subscription-Key). True
Valeur de clé API Securestring Valeur de clé API statique envoyée à chaque requête au point de terminaison de l’agent cible. True

Microsoft Entra ID (informations d’identification du client)

ID d’authentification : oauthClientCredentials

Applicable : Toutes les régions

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.

Ce n’est pas une connexion partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Catégorie Description Obligatoire
Locataire string ID de locataire de l’application Microsoft Entra ID True
ID du client string ID client (ou application) de l’application Microsoft Entra ID. True
Clé secrète client Securestring Clé secrète client de l’application Microsoft Entra ID. True
URL de la ressource string Audience du jeton OAuth. En règle générale, l'ID d'application Microsoft de l'agent cible (par exemple, api://< appId> ou le GUID d'ID d'application). True

Aucune authentification

ID d’authentification : anonyme

Applicable : Toutes les régions

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.

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble Connectors pour les applications de canevas - Power Apps | Microsoft Docs

Valeur par défaut [DÉCONSEILLÉE]

Applicable : Toutes les régions

Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.

Ce n’est pas une connexion partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Actions

Envoyer l’activité à l’agent

Transfère une charge utile de protocole d’activité au point de terminaison de l’agent sur {agentEndpoint}/api/messages. Lorsque la connexion utilise Microsoft Entra ID OAuth, l’audience du jeton (URL de ressource sur la connexion) doit être égale à l’audience attendue par l’agent cible (modèle d’authentification de compétence Bot Framework) ; créez une connexion par agent si les audiences diffèrent. Le connecteur transfère la charge utile d’activité as-is et ne définit pas « deliveryMode » ; l’agent répond de manière asynchrone (livraison normale) par les activités de réponse POSTing à l’objet « serviceUrl » fourni sur l’activité entrante.

Envoyer l’activité à l’agent

ID d’opération :
SendActivity

Transfère une charge utile de protocole d’activité au point de terminaison de l’agent sur {agentEndpoint}/api/messages. Lorsque la connexion utilise Microsoft Entra ID OAuth, l’audience du jeton (URL de ressource sur la connexion) doit être égale à l’audience attendue par l’agent cible (modèle d’authentification de compétence Bot Framework) ; créez une connexion par agent si les audiences diffèrent. Le connecteur transfère la charge utile d’activité as-is et ne définit pas « deliveryMode » ; l’agent répond de manière asynchrone (livraison normale) par les activités de réponse POSTing à l’objet « serviceUrl » fourni sur l’activité entrante.

Paramètres

Nom Clé Obligatoire Type Description
URL du point de terminaison de l’agent
 agentEndpoint True string

URL de base du kit sdk Microsoft Agents cible / point de terminaison Bot Framework (par exemple, https://my-agent.azurewebsites.net). Le connecteur ajoute /api/messages.
object

Retours

response
object

Définitions

Objet

Il s’agit du type 'object'.