Voeg een Copilot Studio-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 andere gepubliceerde Copilot Studio-agent als connected agent kunt toevoegen en kunt verifiëren dat delegatie werkt zoals verwacht.

Note

Het framework dat wordt gebruikt om deze agent te bouwen, maakt gebruik van gebruiksgebaseerde facturering. Het gebruiken, bouwen, testen en evalueren van agenten kan Copilot Credits kosten. Lees meer in Overzicht van gebruiksgebaseerde facturering.

Je voegt elke verbonden agent toe vanuit hetzelfde dialoogvenster Een verbonden agent toevoegen. Deze richtlijn geldt ongeacht of de agent is gebouwd in Copilot Studio, gehost in Microsoft Foundry, of bereikbaar is via het Agent2Agent (A2A)-protocol. Dit artikel behandelt het verbinden van een Copilot Studio-agent. Om in plaats daarvan een Microsoft Foundry-agent te verbinden, zie Een Foundry-agent toevoegen als verbonden agent. Om een remote agent via het A2A-protocol te verbinden, 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 als primaire agent. Zie Een agent aanmaken (preview).
  • Minstens één andere agent die wordt aangedreven door de Microsoft Copilot-kabel in dezelfde omgeving. De andere agent moet zijn gepubliceerd en geconfigureerd als beschikbaar voor verbinding.
  • De maker voor de primaire agent moet de eigenaar van de verbonden agent zijn of de agent met hen laten delen.

Delen en toegang tot connectoren

Voor agenten die worden aangedreven door het Microsoft Copilot-platform maakt het delen van de primaire (ouder) agent met een gebruiker het mogelijk om zijn verbonden Copilot Studio-agenten namens de gebruiker aan te roepen. Je hoeft niet elke verbonden agent apart met die gebruiker te delen zodat delegatie via de ouder werkt. De maker heeft nog steeds de toegang nodig die in Prerequisites wordt beschreven om een verbonden agent toe te voegen.

De deelvereisten verschillen per harness:

Tuig Vereisten voor het delen voor delegatie van verbonden agents
Microsoft Copilot-harnas Deel de hoofdagent met de beoogde gebruikers of groepen. Elke verbonden Copilot Studio-agent hoeft niet apart met die gebruikers gedeeld te worden voordat de ouder het kan aanroepen.
Standaard testomgeving (klassieke ervaring) Afhankelijk van de authenticatie-instellingen moet je mogelijk de verbonden agent apart delen met eindgebruikers van de ouderagent. Lees meer in Verbinding maken met een bestaande Copilot Studio-agent.

Toestemming om een connected agent aan te roepen is niet hetzelfde als toestemming om toegang te krijgen tot de data die door zijn tools worden gebruikt. De toegang tot die gegevens blijft bepaald door de access control lists (ACL's) van de connected agent en de rechten van de identiteit die door elke verbinding wordt gebruikt. Het delen van de ouderagent overschrijft deze controles niet.

Important

Om de toegang van een connected agent tot data die de oproepende gebruiker mag benaderen te beperken, configureer je zijn tools om gebruikersauthenticatie te gebruiken. Als een tool Agent-auteurauthenticatie gebruikt, draait het met de door de auteur verstrekte inloggegevens en kan het gegevens teruggeven via de bovenliggende agent waartoe de gebruiker met zijn eigen inloggegevens geen toegang heeft. Vertrouw er niet op een verbonden agent ongedeeld te laten om die gegevens te beperken. Bekijk de authenticatie-instellingen en verbindingsrechten voordat je het bovenliggende item deelt. Lees meer in Gebruikersauthenticatie voor hulpprogramma's configureren.

Een Copilot Studio-agent toevoegen

  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. Vanuit het dialoog 'Voeg een verbonden agent toe' blader of zoek je door de beschikbare Copilot Studio-agenten en selecteer je de agent waarmee je verbinding wilt maken.

  6. Bekijk de mogelijkheden van de agent en voeg vervolgens een duidelijke beschrijving toe van wanneer de verbonden agent gebruikt moet worden.

  7. Selecteer Maak verbinding met.

  8. Bevestig dat de verbonden agent in het componentenpaneel verschijnt.

Hoe de orchestrator naar verbonden agenten routeert

Na het toevoegen van een gekoppelde agent bepaalt de orchestratieruntime automatisch wanneer naar die agent 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

Tip

Schrijf een duidelijke, specifieke beschrijving voor elke verbonden agent, zodat de orchestrator nauwkeurig kan bepalen wanneer verzoeken naar die agent moeten worden doorgestuurd. Vermijd overlappende beschrijvingen tussen verbonden agenten.

Testdelegatie

Na het toevoegen van een verbonden agent:

  1. Selecteer op de agentnavigatiebalk het tabblad Voorbeeld.

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

  3. Controleer of de respons afkomstig is van de verbonden agent en geschikt is.

  4. Stuur een bericht buiten het domein van de verbonden agent om te bevestigen dat je primaire agent het afhandelt.

Testdeling en data-toegang

Test ook delegatie als beoogde eindgebruiker, in plaats van alleen als maker:

  1. Deel de gepubliceerde ouderagent met een testgebruiker zonder de verbonden agent apart met die gebruiker te delen.

  2. Als die gebruiker stuur je een verzoek naar de bovenliggende agent die de verbonden agent vereist. Controleer of het bovenliggende systeem het kan aanroepen.

  3. Voor connected-agent tools die zijn geconfigureerd om gebruikersauthenticatie te gebruiken, test je verzoeken voor gegevens waartoe de gebruiker toegang heeft en gegevens waartoe hij geen toegang heeft. Controleer of de toegestane gegevens worden teruggegeven en dat beperkte gegevens niet worden teruggegeven.

  4. Als er verbonden agent-tools Agent-auteurauthenticatie gebruiken, controleer dan of de gegevens die met die inloggegevens worden teruggegeven geschikt zijn voor iedereen die de ouderagent kan gebruiken.

  • Laatst bijgewerkt om