Ajoutez un agent Foundry comme agent connecté (Microsoft Copilot)

Utilisez des assistants connectés pour permettre à votre assistant principal de déléguer des tâches spécifiques à des assistants spécialisés. Cet article vous montre comment connecter un agent Microsoft Foundry existant afin que votre agent principal puisse lui confier les tâches.

Note

Le framework utilisé pour construire cet agent utilise une facturation basée sur l’utilisation. L’utilisation, la création, le test et l’évaluation des agents peuvent consommer des crédits Copilot. En savoir plus dans Aperçu de la facturation basée sur l’utilisation.

Vous ajoutez tous les agents connectés depuis la même boîte de dialogue Ajouter un agent connecté . Pour un aperçu des agents connectés et du fonctionnement du routage, voir Aperçu des agents connectés. Pour connecter un autre agent Copilot Studio, voir Ajouter un agent Copilot Studio comme agent connecté. Pour connecter un agent distant via le protocole Agent2Agent (A2A), voir Ajouter un agent A2A comme agent connecté. Pour connecter un agent construit avec le Microsoft 365 Agents SDK, voir Ajouter un agent Microsoft 365 Agents SDK comme agent connecté.

Prerequisites

  • Un agent créé avec l’infrastructure Microsoft Copilot pour servir d’agent principal. Voir Créer un assistant (version préliminaire).
  • Un agent Foundry existant créé dans un projet du portail Microsoft Foundry, avec le protocole d'activité activé et l'ID de l’agent disponible. Les agents Foundry n’ont pas le protocole d’activité activé par défaut. Voir Activer le protocole d’activité sur votre agent Foundry.
  • L’URL du point de terminaison Azure AI Project pour le project qui héberge l’agent Foundry.
  • Permission d’accéder au projet Foundry. La connexion s’authentifie avec vos identifiants de connexion Microsoft Entra ID.

Note

Vous ne pouvez établir une connexion qu’avec les agents créés dans le portail Microsoft Foundry actuel. La connexion à un agent créé dans le portail précédent renvoie une erreur 404 - Version not found.

Ajoutez un agent Foundry

  1. Connectez-vous à Copilot Studio.

  2. Choisissez et ouvrez l’assistant que vous souhaitez utiliser comme assistant principal.

  3. Dans la barre de navigation de l’agent, sélectionnez l’onglet Build .

  4. Dans le panneau des composants, sélectionnez Assistants connectés pour ouvrir la boîte de dialogue Ajouter un assistant connecté.

  5. Dans la boîte de dialogue, sélectionnez Ajouter, puis Ajouter l’agent Foundry.

  6. À l’étape Connect to Azure AI Foundry, choisissez la connexion que cet agent utilise pour accéder à Microsoft Foundry :

    • Sélectionnez une connexion existante à partir de la liste Connection.
    • Si aucune connexion n’est disponible, sélectionnez Créer une nouvelle connexion et continuez à l’étape suivante.

  7. Si vous créez une nouvelle connexion, saisissez les détails de la connexion, puis sélectionnez Créer :

    • Nom d’affichage (optionnel) : un nom qui vous aide à identifier cette connexion plus tard.
    • Type d’authentification : Connexion utilisateur Microsoft Entra ID. Cette valeur est fixée pour vous.
    • Azure AI Project Endpoint : l’URL du point de terminaison du projet Foundry qui héberge l’agent.

  8. De retour à l’étape Connect to Azure AI Foundry, confirmez que votre connexion est sélectionnée, puis sélectionnez Suivant.

  9. À l’étape Vérifier et ajouter, saisissez les détails de l’agent Foundry que vous souhaitez connecter, puis sélectionnez Ajouter à l’agent :

    • Nom : le nom montré à l’agent auteur.
    • Description : une description claire du moment où cet agent Foundry doit être utilisé. L’orchestrateur utilise cette description pour décider quand acheminer une requête vers l’agent, donc rendez-la précise et évitez les chevauchements avec vos autres outils et agents. Pour plus d'informations, voir Rédaction de métadonnées efficaces.
    • ID agent : l’identifiant de l’agent Foundry auquel vous souhaitez vous connecter.

  10. Confirmez que l’agent connecté apparaît sous Agents connectés dans le panneau des composants.

Note

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.

Activez le protocole Activity sur votre agent Foundry

Copilot Studio communique avec un agent Foundry connecté en utilisant le protocole Activity. Les agents Foundry n’ont pas ce protocole activé par défaut, donc vous devez l’activer avant que votre agent principal puisse échanger des messages avec l’agent Foundry. Si le protocole Activity n’est pas activé, vous pouvez toujours ajouter la connexion, mais appeler l’agent Foundry échoue.

Vous pouvez activer le protocole Activité de l’une des manières suivantes :

  • Publiez l’agent Foundry dans Microsoft 365 ou Microsoft Teams. Lorsque vous publiez un agent de prompt sur Microsoft 365 ou Teams, le protocole Activity et le schéma d’autorisation requis BotServiceRbac sont automatiquement activés. Choisissez cette option si vous prévoyez déjà de publier l’agent sur ces canaux.

  • Activez-le manuellement avec un appel API REST. Si vous ne publiez pas l’agent sur Microsoft 365 ou Teams, appelez l’API REST Foundry Agents - Update agent pour ajouter le protocole activity et le schéma d’autorisation BotServiceRbac à l’agent.

Pour plus d’informations sur la configuration et le partage de votre agent Foundry, consultez Configurer et partager votre agent Microsoft Foundry.

Activez le protocole Activity avec un appel API REST

Appelez l’API REST Foundry Agents - Update agent. Remplacez {{endpoint}}, {{agent_name}} et {{token}} par le point de terminaison, le nom de l’agent et le jeton d’accès pour votre projet Foundry.

Important

Conservez responses et Entra dans les listes. Les supprimer interrompt la discussion avec l’agent depuis le portail Foundry ou le SDK.

PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: Bearer {{token}}
Content-Type: application/merge-patch+json
Foundry-Features: AgentEndpoints=V1Preview

{
    "agent_endpoint": {
        "protocols": [
            "responses",
            "activity"
        ],
        "authorization_schemes": [
            {
                "type": "Entra",
                "isolation_key_source": {
                    "kind": "Entra"
                }
            },
            {
                "type": "BotServiceRbac"
            }
        ]
    }
}

Comment l’orchestrateur redirige vers l’agent Foundry

Après avoir ajouté l’agent Foundry, le runtime d’orchestration détermine automatiquement quand il faut lui déléguer. La décision de routage repose sur :

  • Le nom et la description de l’assistant connecté
  • Le message et le contexte de la conversation de l’utilisateur
  • Les instructions de votre assistant principal

Tip

Rédigez une description claire et spécifique pour l’agent Foundry afin que l’orchestrateur puisse déterminer avec précision quand acheminer les requêtes vers lui. Évitez les descriptions qui se chevauchent entre les assistants connectés.

Délégation de test

Après avoir ajouté l’agent Foundry :

  1. Dans la barre de navigation d’assistant, sélectionnez l’onglet Aperçu.

  2. Envoyez un message correspondant au domaine de l’agent de Foundry.

  3. Vérifiez que la réponse provient de l’agent Foundry et est appropriée.

  4. Envoyez un message en dehors du domaine de l’agent Foundry pour confirmer que votre agent principal s’en occupe.

Si vous devez changer l’ID de l’agent ou la description plus tard, modifiez l’agent connecté depuis le panneau des composants. Voir Gérer les agents connectés dans un agent.

  • Dernière mise à jour :