Tilføj en Agent2Agent (A2A) agent som en connected agent (GitHub Copilot)

Brug tilknyttede agenter til at lade din primære agent delegere specifikke opgaver til specialiserede agenter. Denne artikel viser dig, hvordan du forbinder en fjernagent, der er tilgængelig over Agent2Agent (A2A)-protokollen, så din primære agent kan overdrage opgaver til den.

Notat

Rammen, der bruges til at bygge denne agent, bruger brugsbaseret fakturering. Brug, opbygning, testning og evaluering af agenter kan forbruge Copilot Credits. Læs mere i Oversigt over forbrugsbaseret fakturering.

A2A-protokollen er en åben standard for kommunikation og samarbejde mellem agenter. Fordi det er en åben standard, kan du forbinde agenter, der hostes uden for Copilot Studio og bygger på andre frameworks, så længe de implementerer A2A. Copilot Studio opdager fjernagenten fra sit agentkort og bruger derefter A2A-protokollen til at delegere opgaver til den under kørsel.

Du tilføjer alle forbundne agenter fra den samme dialogboks Tilføj en forbunden agent . Du kan få en oversigt over forbundne agenter og, hvordan routing fungerer, i Oversigt over forbundne agenter. Hvis du vil forbinde en anden Copilot Studio-agent, se Tilføj en Copilot Studio-agent som en tilknyttet agent. Hvis du vil oprette forbindelse til en Microsoft Foundry-agent, skal du se Tilføj en Foundry-agent som en tilkoblet agent.

Forudsætninger

  • En agent oprettet med GitHub Copilot-harnesset som primær agent. Se Opret en agent (forhåndsversion).
  • En fjernagent, der implementerer Agent-til-Agent-protokollen og kan nås fra Copilot Studio over det offentlige internet.
  • URL'en til fjernagentens agentkort, typisk https://<your-agent-host>/.well-known/agent-card.json.
  • Godkendelsesoplysningerne, som den eksterne agent kræver, hvis der er nogen. Copilot Studio understøtter ingen godkendelse, API-nøgle og OAuth 2.0.
  • For OAuth 2.0 skal du have tilladelse til at tilføje en omdirigerings-URI til app-registreringen, som fjernagentens identitetsudbyder bruger. Copilot Studio genererer omdirigerings-URL'en under guiden, og du skal registrere den, før du opretter forbindelsen.

Notat

Da A2A-forbindelser bruger den brugerdefinerede connectorinfrastruktur, kan du også bruge dem til at oprette forbindelse til A2A-agenter, der kører i det lokale miljø eller i et virtuelt netværk.

Tilføj en Agent2Agent (A2A) agent

Guiden guider dig gennem tre eller fire trin, afhængigt af hvilken autentificeringsmetode du vælger:

  • Hvis du vælger Ingen eller API-nøgle: Forbind til en A2A-agent, forbind til A2A-agenten, og gennemgå og tilføj derefter.
  • Hvis du vælger OAuth 2.0: Forbind til en A2A-agent, tilføj omdirigerings-URL,forbind til A2A-agenten, og gennemgå og tilføj derefter.

  1. Log på Copilot Studio.

  2. Vælg og åbn den agent, du vil bruge som primær agent.

  3. I agentens navigationslinje skal du vælge fanen Byg.

  4. I komponentpanelet skal du vælge Forbundne agenter for at åbne dialogen Tilføj en tilsluttet agent .

  5. I dialogboksen skal du vælge Tilføj og derefter vælge Tilføj A2A-agent.

  6. I trinnet Opret forbindelse til en A2A-agent indtaster du oplysningerne for den eksterne agent:

    • Agentkortets URL: URL'en for fjernagentens agentkort, for eksempel https://agent.example.com/.well-known/agent-card.json. Copilot Studio læser kortet for at opdage agentens endpoint og kapaciteter.
    • Navn: navnet vist til agentforfatteren. Hvis agentkortet indeholder et navn, udfylder Copilot Studio dette felt for dig.
    • Beskrivelse: en klar beskrivelse af, hvornår denne A2A-agent skal bruges, mellem 30 og 1.000 tegn. Hvis agentkortet indeholder en beskrivelse, udfylder Copilot Studio dette felt for dig. Orkestratoren bruger denne beskrivelse til at beslutte, hvornår en anmodning skal videresendes til agenten, så gør den specifik og undgå overlap med dine andre værktøjer og agenter. Lær mere om at skrive effektive metadata.

    Notat

    Hvis navn og beskrivelse ikke udfyldes automatisk, har fjernagenten måske ikke et agentkort, kortet kan være på en anden URL end den, du indtastede, eller Copilot Studio kan måske ikke nå det. Tjek URL'en først, og prøv at åbne agentkortet i din browser. Hvis kortet ikke er tilgængeligt, indtast et navn og en beskrivelse manuelt.

  7. Under Autentificering skal du vælge hvordan Copilot Studio autentificerer sig med fjernagenten, og derefter udfylde detaljerne for den metode, du har valgt:

    Du kan ikke fortsætte, før autentificeringsoplysningerne er fuldførte.

  8. Vælg Næste.

  9. Hvis du har valgt OAuth 2.0, vises trinnet Tilføj URL-adresse til omdirigering. Copilot Studio opretter connectoren for A2A-agenten, og platformen genererer en omdirigerings-URL til den. Registrer den URL hos din identitetsudbyder, før du opretter forbindelsen:

    1. Vent på, at feltet Redirect URL udfyldes. Connectoren skal eksistere, før URL'en genereres.
    2. Vælg kopier-knappen ved siden af feltet for at kopiere URL'en.
    3. I din OAuth-appregistrering skal du tilføje URL'en som en omdirigerings-URI og gemme app-registreringen.
    4. Vælg Næste.

    Vigtig

    Hvis du ikke registrerer omdirigerings-URL'en først, mislykkes det første forsøg på at autorisere forbindelsen. Redirect-URL'en genereres pr. connector, så den er specifik for denne A2A-agent og kan ikke genbruges fra en anden connector. Hvis du skal bruge URL'en igen senere, vælg A2A-agenten under Connected agents i komponentpanelet for at åbne den igen.

  10. På trinnet Connect to the A2A agent vælger du den forbindelse, denne agent bruger til at nå fjernagenten:

    • Vælg en eksisterende forbindelse fra listen over tilgængelige forbindelser.
    • Hvis der ikke er nogen forbindelse, oprettes en ny forbindelse. Hvis fjernagenten bruger API-nøgleautentificering, indtaster du API-nøgleværdien, når du opretter forbindelsen.

  11. Vælg Næste.

  12. På trinnet Gennemgå og tilføj gennemgår du navnet, beskrivelsen og agentkortets URL og vælger derefter Føj til agent.

  13. Bekræft at den tilsluttede agent vises under Forbundne agenter i komponentpanelet.

Hvis du går tilbage og ændrer autentificeringsindstillingerne på Connect to an A2A agent-trinnet, kasserer Copilot Studio det stik, der blev bygget ud fra de tidligere indstillinger. Du skal registrere en ny omdirigerings-URL og vælge en forbindelse igen.

Notat

Du er ansvarlig for nøje at gennemgå og teste tilknyttede agenter i konteksten af dine specifikke anvendelsestilfælde og træffe alle relevante beslutninger og tilpasninger. Når du opretter forbindelse til agenter uden for Copilot Studio, er du ansvarlig for brugen af sådanne agenter. Overvejelser omfatter sikring af:

  • Dataflow, datahåndtering og datadeling mellem agenter er passende for dit brugsscenarie og opfylder relevante krav og love.
  • Agenter opfylder passende standarder for kvalitet, pålidelighed, sikkerhed og troværdighed.
  • Passende tilladelser, grænser og godkendelser er givet, hvis det er forsvarligt for din brug.
  • Korrekt observerbarhed, identitet og sporbarhed samt menneskelige tilsynsfunktioner er på plads.

Konfigurer godkendelse af API-nøgle

Når du vælger API-nøgle, skal du vælge, hvor Copilot Studio sender nøglen hen, ved at vælge en parametertype:

  • Header: nøglen sendes som en anmodningsheader. I Header-navn indtast navnet på den header, som den fjernagent forventer, såsom x-api-key.
  • Forespørgselsstreng: nøglen sendes som en forespørgselsstrengsparameter. I Parameter label skal du indtaste navnet på den forespørgselsstrengparameter, som den eksterne agent forventer.

Du indtaster selve API-nøgleværdien, når du opretter forbindelsen, ikke i dette trin. På den måde gemmes nøglen sammen med forbindelsen og er ikke synlig i agentkonfigurationen.

Konfigurer OAuth 2.0-godkendelse

Når du vælger OAuth 2.0, vælg en konfigurationstype:

  • Dynamisk: Copilot Studio registrerer en klient hos fjernagentens identitetsudbyder for dig. Indtast autorisations-URL'en og token-URL'en.

  • Manuel: brug en app-registrering, du allerede har oprettet hos fjernagentens identitetsudbyder. Angiv følgende værdier:

    • Klient-ID: klient-ID'et for din app-registrering.
    • Klienthemmelighed: klienthemmeligheden for din appregistrering.
    • Autorisations-URL: identitetsudbyderens autorisationsendepunkt.
    • Token URL: identitetsudbyderens token-endpoint.
    • Refresh token URL: det endepunkt, der bruges til at forny adgangstokens.
    • Scopes (valgfri): de scopes, der skal anmodes om, adskilt af mellemrum.

Brug Dynamic, når den fjernagents identitetsudbyder understøtter dynamisk klientregistrering. Brug Manual , når du skal kontrollere app-registreringen, for eksempel når din identitetsudbyder kræver forudregistrerede omdirigerings-URI'er eller samtykke.

Begge konfigurationstyper kræver, at du registrerer en omdirigerings-URL hos din identitetsudbyder. Efter du har valgt Næste, opretter Copilot Studio connectoren og viser den genererede omdirigerings-URL i Tilføj omdirigerings-URL-trin.

Find URL'en til omdirigering senere

Hvis du lukker guiden eller mister omdirigerings-URL'en, kan du se den igen når som helst:

  1. På fanen Build skal du vælge A2A-agenten under Connected agents i komponentpanelet.

  2. I dialogen Rediger A2A-agenten kopierer du værdien i feltet Redirect URL .

Redirect URL-feltet vises kun for A2A-agenter, der bruger OAuth 2.0.

Hvordan orkestratoren dirigerer til A2A-agenten

Efter du har tilføjet A2A-agenten, bestemmer orkestreringsruntimen automatisk, hvornår der skal delegeres til den. Ruteringsbeslutningen er baseret på:

  • Den tilknyttede agents navn og beskrivelse
  • Brugerens besked og samtalekontekst
  • Din primære agents instruktioner

Tip

Skriv en klar, specifik beskrivelse af A2A-agenten, så orkestratatoren præcist kan afgøre, hvornår anmodninger skal dirigeres til den. Undgå overlappende beskrivelser mellem tilknyttede agenter.

Test af delegering

Efter du har tilføjet A2A-agenten:

  1. Vælg fanen Forhåndsversion i agentens navigationsinje.

  2. Send en besked, der matcher A2A-agentens domæne.

  3. Bekræft, at svaret kommer fra A2A-agenten og er passende.

  4. Send en besked uden for A2A-agentens domæne for at bekræfte, at det håndteres af din primære agent.

Hvis du senere skal ændre navn eller beskrivelse, så rediger den tilsluttede agent fra komponentpanelet. Se Administrer forbundne agenter i en agent

Fejlsøg forbindelsen

Problem Hvad skal kontrolleres?
Godkendelse af forbindelsen fejler med en redirect URI-fejl Den omdirigerings-URL, som Copilot Studio genererede, er ikke registreret hos din identitetsudbyder. Kopier URL'en fra dialogen Rediger A2A-agent , tilføj den til din app-registrering, og autoriser derefter forbindelsen igen.
Feltet Redirect URL forbliver tomt i guiden Connectoren er stadig under oprettelse. Hvis trinet i stedet viser en fejl, vælg Prøv igen.
Navnet og beskrivelsen udfyldes ikke fra agentkortet Tjek at agentkortets URL er korrekt, og at Copilot Studio kan få adgang til kortet. Indtast navn og beskrivelse manuelt, hvis kortet ikke er tilgængeligt.
Den forbindelse, du oprettede, virker ikke længere, efter du redigerede guiden Ændring af godkendelsesindstillingerne kasserer connectoren, der er bygget ud fra de tidligere indstillinger. Registrer den nye omdirigerings-URL-adresse, og vælg en tilslutning igen.
  • Sidst opdateret den