Se connecter à d’autres agents à partir d’un agent déclaratif

Lorsque les utilisateurs interagissent avec un agent déclaratif dans Microsoft 365 Copilot Chat, il peut se connecter à d’autres agents pour récupérer des informations supplémentaires ou effectuer des actions. Vous déclarez ces connexions dans le manifeste de l’agent en listant les ID de titre de l’agent dans la worker_agents propriété. Au moment de l’exécution, Copilot Chat agit en tant que courtier qui sert d’intermédiaire dans l’interaction : les utilisateurs voient l’échange d’agent à agent, mais n’ont pas besoin de sélectionner eux-mêmes les agents connectés.

Lorsqu’un utilisateur interagit avec un agent déclaratif, l’agent peut déléguer une partie de la tâche à un agent connecté. Microsoft 365 Copilot évalue les agents connectés déclarés dans le manifeste et en sélectionne un en fonction de la tâche en cours, du nom, de la description et des exemples d’invites de l’agent connecté. Copilot envoie une demande textuelle à l’agent connecté sélectionné, reçoit une réponse textuelle et incorpore cette réponse dans l’interaction continue de l’agent déclaratif avec l’utilisateur.

Quand utiliser les agents connectés

Utilisez des agents connectés pour séparer ou combiner des agents entre des fonctions ou des équipes de développement.

Allez au-delà de ce qu’un seul agent peut accomplir

Les grands modèles de langage (LLM) ont une fenêtre contextuelle et un ensemble de fonctionnalités utiles limités. La fiabilité d’un seul agent LLM commence à diminuer à mesure que d’autres documents sont récupérés ou que des outils sont activés. Si la qualité d’un agent est inférieure après l’ajout de connaissances ou de fonctionnalités, divisez certaines de ces fonctionnalités dans un autre agent et connectez-vous-y. L’agent existant envoie uniquement les informations relatives à la tâche dont il a besoin pour atteindre sa partie. L’agent connecté fonctionne dans sa propre fenêtre de contexte, sans aucun autre document ou fonctionnalité se trouvant dans la conversation utilisateur.

Intégrer des agents développés en externe

Les agents déclaratifs peuvent faciliter la collaboration avec d’autres équipes de développement. Chaque équipe de développement peut se concentrer sur les capacités et la qualité de son agent, en utilisant des agents connectés pour s’intégrer à d’autres agents. Comme avec les microservices, chaque agent peut être développé sans affecter les autres agents. Contrairement aux microservices, les agents peuvent continuer à interagir les uns avec les autres même lorsque leurs interfaces changent.

Partager les fonctionnalités d’un agent dans plusieurs scénarios

Un agent peut bien fonctionner avec un ensemble de documents et d’actions, mais cela reste difficile pour les utilisateurs. Prenons l’exemple d’un agent qui comprend les tables et les données d’une base de données relationnelle de clients et de ventes. Cet agent peut être utile à la fois pour les superviseurs de magasin pour gérer les stocks et pour les analystes commerciaux pour rendre compte aux cadres. Si cet agent pouvait être connecté à un agent adapté aux superviseurs de magasin avec des amorces de conversation et des instructions, ainsi qu’à un agent adapté aux analystes d’entreprise. Les deux types d’utilisateurs peuvent tirer davantage parti de l’utilisation d’agents adaptés à leur scénario.

Activation des agents connectés

Vous devez inscrire les agents connectés dans le registre d’agents de Microsoft Agent 365. Connectez-vous à d’autres agents en incluant les ID de titre des agents dans le manifeste de l’agent déclaratif existant. L’autre agent doit être un agent déclaratif ou avoir une carte d’agent Agent2Agent enregistrée.

Tout d’abord, obtenez l’ID de titre de l’agent pour se connecter. L’ID de titre d’un agent est une chaîne d’une seule lettre, d’un trait de soulignement et d’un GUID. Pour un agent déclaratif, trouvez-le dans la sortie de la commande Provision dans le Microsoft 365 Agents Toolkit ou en mode développeur. Pour une inscription d’agent Microsoft 365, il s’agit de la id propriété de l’objet agentRegistration.

Ajoutez l’ID de titre à la propriété worker_agents en tant que id. La worker_agents propriété a été ajoutée dans le schéma de l’agent déclaratif version 1.6.

Authentification et autorisation

La connexion à un agent déclaratif repose sur l’authentification existante de l’utilisateur à Microsoft 365 Copilot, car l’agent déclaratif s’exécute dans Microsoft 365 Copilot Chat. Pour les agents externes enregistrés dans Microsoft Agent 365, l’enregistrement de l’agent doit déclarer comment Microsoft 365 Copilot s’authentifie auprès de l’agent externe. Au lieu d’incorporer la configuration d’authentification directement dans l’enregistrement de l’agent, l’enregistrement fait référence à un enregistrement d’authentification existant via l’objet authorization dans le agentRegistration. Cette séparation permet de gérer la configuration de l’authentification indépendamment des définitions de l’agent. La conception reflète celle des manifestes de plug-in d’API.

Syntaxe

{
  "type": "None | OAuthPluginVault",
  "referenceId": "{string}"
}

La type propriété spécifie le schéma d’authentification utilisé par l’agent externe. OAuthPluginVaultutilise un enregistrement SSO de Microsoft Entra. Il s’agit referenceId de la Microsoft Entra SSO registration ID valeur générée dans le portail des développeurs Teams. Pour plus d’informations, consultez Utiliser le portail de développement Teams .

L’utilisation de l’agent connecté par un utilisateur est déterminée séparément de l’authentification. Les utilisateurs doivent avoir accès à l’agent connecté, soit en l’acquérant eux-mêmes, soit par le biais d’un déploiement administrateur. Les administrateurs doivent installer les agents externes enregistrés dans Microsoft Agent 365 pour l’utilisateur.

Meilleures pratiques

Les agents déclaratifs choisissent les agents auxquels se connecter en fonction des invites de l’agent connecté, descriptionet des nameexemples. Pour un agent déclaratif, les exemples d’invites sont le text champ de conversation_starters dans le manifeste. Pour un agentRegistration, il s’agit de la examples propriété de l’objet AgentSkill dans la carte d’agent. La description de l’agent doit décrire à la fois aux humains et aux agents ce que l’agent peut faire. Par exemple, considérez cette description pour un agent qui travaille avec des données structurées sur les ventes de jeux vidéo.

A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.

Les exemples d’invites doivent informer les utilisateurs et les agents des types d’invites que l’agent peut traiter. Étant donné que les utilisateurs peuvent utiliser des termes différents pour le même concept, envisagez de varier la formulation des amorces de conversation. Par exemple, lorsque vous travaillez sur des affaires juridiques, les bons amorces de conversation peuvent également utiliser les termes « affaire », « affaire », « client » et « problème ». Seul le text champ d’un amorce de conversation est utilisé par les agents connectés.

Limitations

• L’agent actif envoie du texte uniquement à un agent connecté. Les agents déclaratifs retournent du texte ou des cartes adaptatives. Les agents avec Agent2Agent Les cartes d’agent renvoient du texte, des fichiers binaires d’image Base64 et des fichiers binaires Base64.

• Lorsque l’utilisateur est invité à confirmer les appels du plug-in d’API de l’agent connecté, toutes les cartes adaptatives sont envoyées à l’agent actif. L’utilisateur ne voit pas le carte adaptatif ou ne peut pas utiliser de boîte de dialogue. Toutefois, l’agent actif traite le contenu des données de la carte adaptative.

Contenu connexe

• Créer des agents avec Visual Studio Code
• Tester et déboguer les agents dans Copilot Studio