Lägg till en Copilot Studio-agent som en ansluten agent (Microsoft Copilot)

Använd kopplade agenter för att låta din primära agent delegera specifika uppgifter till specialiserade agenter. Den här artikeln visar hur du lägger till en annan publicerad Copilot Studio-agent som en ansluten agent och verifierar att delegeringen fungerar som förväntat.

Note

Ramverket som används för att bygga den här agenten använder användningsbaserad fakturering. Att använda, bygga, testa och utvärdera agenter kan förbruka Copilot-krediter. Läs mer i Översikt över användningsbaserad fakturering.

Du lägger till alla anslutna agenter i samma dialogruta Lägg till en ansluten agent. Denna vägledning gäller oavsett om agenten är byggd i Copilot Studio, värd i Microsoft Foundry eller nås via Agent2Agent (A2A)-protokollet. Den här artikeln handlar om hur man kopplar ihop en agent från Copilot Studio. För att istället koppla en Microsoft Foundry-agent, se Lägg till en Foundry-agent som en ansluten agent. För att ansluta en fjärragent över A2A-protokollet, se Lägg till en A2A-agent som ansluten agent. För att koppla en agent byggd med SDK för Microsoft 365-agenter, se Lägg till en SDK för Microsoft 365-agenter-agent som en ansluten agent.

Prerequisites

  • En agent skapad med Microsoft Copilot harness för att vara primär agent. Se Skapa en agent (förhandsversion).
  • Det måste finnas minst en annan agent som drivs med Microsoft Copilot-harnessen i samma miljö. Den andra agenten måste publiceras och konfigureras som tillgänglig för att kunna anslutas.
  • Skaparen av den primära agenten måste antingen vara ägare till den anslutna agenten eller ha agenten delad med sig.

Delning och anslutningsåtkomst

För agenter som drivs av Microsoft Copilot-harness gör delning av den primära (överordnade) agenten med en användare det möjligt för agenten att anropa sina anslutna Copilot Studio-agenter på användarens vägnar. Du behöver inte dela varje ansluten agent separat med den användaren för att delegering via föräldern ska fungera. Skaparen behöver fortfarande åtkomsten som beskrivs i Prerequisites för att lägga till en ansluten agent.

Delningskraven skiljer sig beroende på harness:

Sele Delningskrav för delegation av anslutna agenter
Microsoft Copilot-hanterare Dela moderagenten med de avsedda användarna eller grupperna. Varje ansluten Copilot Studio-agent behöver inte delas separat med dessa användare för att den överordnade agenten ska kunna anropa den.
Standardmiljö (klassisk upplevelse) Beroende på autentiseringsinställningen kan du behöva dela den anslutna agenten separat med slutanvändare av moderagenten. Läs mer i Anslut till en befintlig Copilot Studio-agent.

Behörighet att anropa en ansluten agent är inte samma sak som behörighet att komma åt data som används av dess verktyg. Åtkomsten till dessa data styrs fortfarande av den anslutna agentens anslutningskontrolllistor (ACL) och behörigheterna för den identitet som används av varje anslutning. Att dela den överordnade agenten åsidosätter inte dessa kontroller.

Important

För att begränsa en ansluten agents verktygsåtkomst till data som den anropande användaren har tillåtelse att komma åt, konfigurera dess verktyg att använda användarautentisering. Om ett verktyg använder autentisering för agentförfattare körs det med de uppgifter som författaren tillhandahållit och kan returnera data via den överordnade agenten som användaren inte kan komma åt med sina egna uppgifter. Lita inte på att en ansluten agent inte delas för att begränsa den datan. Granska dess autentiseringsinställningar och anslutningsbehörigheter innan du delar det överordnade objektet. Läs mer i Konfigurera användarautentisering för verktyg.

Lägga till en Copilot Studio-agent

  1. Logga in på Copilot Studio.

  2. Välj och öppna den agent du vill använda som primär agent.

  3. I agentens navigationsfält, välj fliken Bygg.

  4. I komponentpanelen, välj Anslutna agenter för att öppna dialogen Lägg till en ansluten agent.

  5. Från dialogen Lägg till en ansluten agent, bläddra bland eller sök bland tillgängliga Copilot Studio-agenter och välj den agent du vill ansluta.

  6. Gå igenom agentens funktioner och lägg sedan till en tydlig beskrivning av när den anslutna agenten ska användas.

  7. Välj Anslut.

  8. Bekräfta att den anslutna agenten visas i komponentpanelen.

Hur orkestreringen leder till anslutna agenter

När du har lagt till en ansluten agent avgör orchestreringsmiljön automatiskt när den ska delegera till agenten. Routningsbeslutet baseras på:

  • Den anslutna agentens namn och beskrivning
  • Användarens meddelande och konversationskontext
  • Instruktionerna för din primära agent

Tip

Skriv en tydlig, specifik beskrivning för varje ansluten agent så att orkestreringen noggrant kan avgöra när förfrågningar ska dirigeras till respektive agent. Undvik att beskrivningarna mellan anslutna agenter överlappar varandra.

Testdelegering

Efter att ha lagt till en ansluten agent:

  1. I agentens navigeringsfält väljer du fliken Förhandsversion.

  2. Skicka ett meddelande som matchar den anslutna agentens domän.

  3. Kontrollera att svaret kommer från den anslutna agenten och är lämpligt.

  4. Skicka ett meddelande utanför den anslutna agentens domän för att bekräfta att din primära agent hanterar det.

Testa delning och dataåtkomst

Testa också delegering som avsedd slutanvändare, snarare än bara som skapare:

  1. Dela den publicerade moderagenten med en testanvändare utan att separat dela den anslutna agenten med den användaren.

  2. Som den användaren, skicka en förfrågan till den överordnade agenten som kräver den anslutna agenten. Verifiera att den överordnade kan anropa den.

  3. För connected-agent-verktyg konfigurerade för användarautentisering, testa förfrågningar om data som användaren får komma åt och data de inte får komma åt. Kontrollera att den tillåtna datan returneras och att begränsad data inte returneras.

  4. Om några verktyg för anslutna agenter använder Agent author authentication, kontrollera att de data som returneras med dessa autentiseringsuppgifter är lämpliga för alla som kan använda den överordnade agenten.

  • Uppdaterades senast