Voeg een Foundry-agent toe als connected agent (Microsoft Copilot)

Gebruik verbonden agenten zodat uw primaire agent specifieke taken kan delegeren aan gespecialiseerde agenten. Dit artikel laat zien hoe je een bestaande Microsoft Foundry-agent kunt verbinden zodat je primaire agent taken aan hem kan overdragen.

Je voegt elke verbonden agent toe vanuit hetzelfde dialoogvenster Een verbonden agent toevoegen. Voor een overzicht van connected agents en hoe routing werkt, zie Connected agents overview. Om een andere Copilot Studio-agent te verbinden, zie Voeg een Copilot Studio-agent toe als een verbonden agent. Om een remote agent te verbinden via het Agent2Agent (A2A) protocol, zie Voeg een A2A-agent toe als connected agent. Om een agent te verbinden die is gebouwd met de SDK voor Microsoft 365-agenten, zie Voeg een SDK voor Microsoft 365-agenten-agent toe als verbonden agent.

Prerequisites

• Een agent die is gemaakt met het Microsoft Copilot-harnas om de primaire agent te zijn. Zie Een agent aanmaken (preview).
• Een bestaande Foundry-agent die is aangemaakt in een project in het Microsoft Foundry-portaal, met het Activity-protocol ingeschakeld en de agent-ID van de agent beschikbaar. Foundry-agenten hebben het Activity-protocol niet standaard ingeschakeld. Zie Het Activity-protocol inschakelen op je Foundry-agent.
• De Azure AI Project-endpoint-URL voor het project dat de Foundry-agent host.
• Toestemming om toegang te krijgen tot het Foundry-project. De verbinding authenticeert met je Microsoft Entra ID gebruikerslogin.

Voeg een Foundry-agent toe

1. Meld u aan bij Copilot Studio.

2. Kies en open de agent die u als primaire agent wilt gebruiken.

3. Selecteer in de navigatiebalk van de agent het tabblad Bouw .

4. Selecteer in het componentenpaneel Verbonden agenten om het dialoogvenster Een verbonden agent toevoegen te openen.

5. Selecteer in het dialoogvenster Toevoegen en vervolgens Foundry agent toevoegen.

6. Op de stap Connect to Azure AI Foundry kies je de verbinding die deze agent gebruikt om Microsoft Foundry te bereiken:

   • Selecteer een bestaande verbinding uit de lijst Verbinding.
   • Als er geen verbinding beschikbaar is, selecteer dan Nieuwe verbinding aanmaken en ga door naar de volgende stap.

7. Als je een nieuwe verbinding aanmaakt, voer dan de verbindingsgegevens in en kies dan Aanmaken:

   • Weergavenaam (optioneel): een naam die je later helpt deze verbinding te identificeren.
   • Authenticatietype: Microsoft Entra ID-gebruikersaanmelding. Deze waarde wordt voor u ingesteld.
   • Azure AI Project Endpoint: de endpoint-URL van het Foundry-project dat de agent host.

8. Terug in de stap Connect to Azure AI Foundry, bevestig dat je verbinding is geselecteerd en selecteer vervolgens Volgende.

9. Voer in de stap 'Beoordelen en toevoegen ' de gegevens in van de Foundry-agent die je wilt verbinden en selecteer vervolgens 'Toevoegen aan agent':

   • Naam: de naam die aan de auteur van de agent wordt getoond.
   • Beschrijving: een duidelijke beschrijving van wanneer deze Foundry-agent gebruikt moet worden. De orchestrator gebruikt deze beschrijving om te beslissen wanneer een verzoek naar de agent wordt gestuurd, dus maak het specifiek en voorkom overlap met je andere tools en agenten. Zie voor meer informatie Effectieve metagegevens schrijven.
   • Agent ID: het ID van de Foundry-agent waarmee je wilt verbinden.

10. Bevestig dat de verbonden agent onder Verbonden agenten in het componentenpaneel verschijnt.

Activeer het Activity-protocol op je Foundry-agent

Copilot Studio communiceert met een verbonden Foundry-agent via het Activity-protocol. Foundry-agenten hebben dit protocol standaard niet ingeschakeld, dus je moet het inschakelen voordat je primaire agent berichten kan uitwisselen met de Foundry-agent. Als het Activity-protocol niet is ingeschakeld, kun je de verbinding nog steeds toevoegen, maar het aanroepen van de Foundry-agent mislukt.

Je kunt het Activity-protocol op een van de volgende manieren inschakelen:

• Publiceer de Foundry-agent op Microsoft 365 of Microsoft Teams. Wanneer je een promptagent publiceert naar Microsoft 365 of Teams, worden het Activity-protocol en het vereiste BotServiceRbac autorisatieschema automatisch ingeschakeld. Kies deze optie als je al van plan bent de agent op die kanalen te publiceren.

• Schakel het handmatig in met een REST API-aanroep. Als je de agent niet publiceert naar Microsoft 365 of Teams, roep dan de Foundry Agents - Update agent REST API aan om het activity protocol en het BotServiceRbac autorisatieschema aan de agent toe te voegen.

Voor meer informatie over het configureren en delen van je Foundry-agent, zie Configureren en delen je Microsoft Foundry-agent.

Activeer het Activity-protocol met een REST API-aanroep

Roep de Foundry Agents - Update agent REST API aan. Vervang {{endpoint}}, {{agent_name}}, en {{token}} door het endpoint, agentnaam en toegangstoken voor je Foundry-project.

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"
            }
        ]
    }
}

Hoe de orkestrator naar de Foundry-agent routeert

Nadat je de Foundry-agent hebt toegevoegd, bepaalt de orkestratieruntime automatisch wanneer ernaar moet worden gedelegeerd. De routeringsbeslissing is gebaseerd op:

• De naam en beschrijving van de verbonden agent
• Het bericht en de gesprekscontext van de gebruiker
• De instructies van uw primaire agent

Testdelegatie

Nadat je de Foundry-agent hebt toegevoegd:

1. Selecteer op de agentnavigatiebalk het tabblad Voorbeeld.

2. Stuur een bericht dat overeenkomt met het domein van de Foundry-agent.

3. Controleer of het antwoord van de Foundry-agent komt en gepast is.

4. Stuur een bericht buiten het domein van de Foundry-agent om te bevestigen dat jouw primaire agent het afhandelt.

Als je later de Agent ID of beschrijving moet wijzigen, bewerk dan de aangesloten agent vanuit het componentenpaneel. Zie Verbonden agenten in een agent beheren.

Verwante gegevens

• Overzicht van verbonden agenten
• Voeg een Copilot Studio-agent toe als connected agent
• Voeg een A2A-agent toe als een verbonden agent
• Voeg een SDK voor Microsoft 365-agenten-agent toe als een connected agent
• Beheer verbonden agenten in een agent
• Bouw een agent
• Configureer en deel je Microsoft Foundry-agent
• Wat is de Microsoft Foundry Agent Service?