Se connecter à un assistant Microsoft Foundry (version préliminaire)

Note

Cet article décrit les caractéristiques utilisées dans les agents ou flux d’agents alimentés par le faisceau standard.

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Vous pouvez connecter un Agent Microsoft Foundry à votre agent personnalisé, ce qui lui permet d’appeler cet agent pour répondre à un utilisateur ou à un déclencheur.

Important

Cet article contient la documentation en préversion de Microsoft Copilot Studio et est susceptible d'être modifié.

Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que vous puissiez y accéder en avant-première et fournir des commentaires.

Si vous créez un assistant prêt pour la production, consultez Vue d’ensemble de Microsoft Copilot Studio.

Prerequisites

Avant de connecter un agent Microsoft Foundry à Copilot Studio, l’agent Foundry doit avoir activé le point de terminaison du protocole Activity. Un agent Foundry nouvellement créé n’expose par défaut que les terminaux des protocoles Réponses et A2A . Si le point d'accès Activité n'est pas activé, la connexion à Copilot Studio échoue à l'exécution avec une erreur 400. En savoir plus dans Activer les connexions A2A entrantes sur un agent Foundry.

Vous pouvez actuellement activer le point de terminaison Activity uniquement de manière programmatique, en utilisant l’API REST ou le SDK Python. Il n'y a pas d'option pour l'activer depuis le portail Microsoft Foundry. En savoir plus sur la procédure d’activation dans Configurer et partagez votre agent.

Après avoir activé le point d’accès Activité, la section Points de terminaison du portail Foundry pour l’agent continue d’afficher uniquement Réponses et A2A. Cette omission de l’interface est attendue et ne signifie pas que le changement a échoué. La connexion à Copilot Studio fonctionne après l’application de la mise à jour.

Se connecter à un agent Microsoft Foundry

  1. Accédez à la page Agents de votre agent principal, puis sélectionnez Ajouter un agent.

  2. Sous Se connecter à un assistant externe, sélectionnez Microsoft Foundry dans les types d’assistants disponibles.

  3. Sélectionnez la connexion souhaitée dans la liste des connexions disponibles ou créez une connexion entre Microsoft Foundry et votre agent Copilot Studio. Pour créer une nouvelle connexion, vous devez fournir l’URL du point de terminaison du projet Foundry.

    Note

    Lorsque vous vous connectez à des agents Microsoft Foundry à partir de Copilot Studio, vous ne pouvez vous connecter qu’aux agents créés dans le nouveau portail Microsoft Foundry. Se connecter à un agent créé dans le portail précédent entraîne une erreur indiquant 404 - Version not found.

  4. Une fois votre connexion créée, sélectionnez Suivant.

  5. Entrez un Nom et une Description appropriés pour votre assistant SDK. La description doit décrire l’objectif de votre assistant Microsoft Foundry, ce qui permet à votre assistant principal de comprendre quand il doit être utilisé. Pour plus d'informations, voir Rédaction de métadonnées efficaces.

  6. Entrez l´ID de l´assistant Microsoft Foundry auquel vous souhaitez vous connecter.

  7. Ajustez la description (si besoin) pour la rendre plus contextuelle pour l’agent principal. Par exemple, rendez la description plus spécifique si vous avez d’autres outils ou assistants où les descriptions peuvent se chevaucher. Mettez à jour la description pour que Copilot Studio comprenne quand faire appel à cet agent.

  8. Sélectionnez Ajouter un assistant.

  9. Une fois votre assistant créé, vous pouvez tester votre assistant immédiatement. Si vous devez ajuster l’ID de l’assistant ultérieurement, vous pouvez le faire à partir de la page de détails, en sélectionnant votre assistant dans la liste Agents.

Note

  • Si votre premier appel de test vers l'agent Foundry connecté échoue avec une erreur similaire à « Le connecteur 'Service de l'agent Azure AI Foundry' a renvoyé une erreur HTTP avec le code 400. Erreur interne : Le point de terminaison de l’agent <name> ne prend pas en charge l’activité. Veuillez mettre à jour le point de terminaison de l’agent pour prendre en charge ce protocole. », L’agent Foundry n’a pas activé le point de terminaison du protocole Activity . Consultez les prérequis dans cet article, puis activez le point d’accès Activité en suivant Configurer et partagez votre agent dans la documentation de Microsoft Foundry.

  • Vous êtes responsable de revoir et tester attentivement les agents connectés dans le contexte de vos cas d’usage spécifiques, et de prendre toutes les décisions et personnalisations appropriées. Lorsque vous vous connectez à des assistants en dehors de Copilot Studio, vous êtes responsable de l’utilisation de ces assistants. Les considérations incluent la garantie de :

    • Les flux de données, la gestion des données et le partage de données entre agents sont adaptés à votre cas d’utilisation et répondent aux exigences et lois pertinentes.
    • Les agents respectent des normes appropriées en matière de qualité, de fiabilité, de sécurité et de caractère digne de confiance.
    • Des autorisations, limites et approbations appropriées sont prévues, si cela convient à votre cas d’usage.
    • Une observabilité, une identité et une traçabilité appropriées, ainsi que des fonctions de surveillance humaine sont en place.
  • Last updated on