Legg til en Agent2Agent (A2A)-agent som en tilkoblet agent (GitHub Copilot)

Bruk tilkoblede agenter til å la primæragenten delegere spesifikke oppgaver til spesialiserte agenter. Denne artikkelen viser deg hvordan du kobler til en ekstern agent som er tilgjengelig over Agent2Agent (A2A)-protokollen, slik at din primære agent kan overføre oppgaver til den.

Note

Selen som brukes til å bygge denne agenten, bruker bruksbasert fakturering. Bruk, bygging, testing og evaluering av agenter kan forbruke Copilot-kreditter. Les mer i Oversikt over bruksbasert fakturering.

A2A-protokollen er en åpen standard for kommunikasjon og samarbeid mellom agenter. Fordi det er en åpen standard, kan du koble agenter som hostes utenfor Copilot Studio og er bygget på andre rammeverk, så lenge de implementerer A2A. Copilot Studio oppdager den eksterne agenten fra sitt agentkort, og bruker deretter A2A-protokollen for å delegere oppgaver til den under kjøring.

Du legger til alle tilkoblede agenter i samme Legg til en tilkoblet agent-dialogboks. For en oversikt over tilkoblede agenter og hvordan ruting fungerer, se oversikt over tilknyttede agenter. For å koble til en annen Copilot Studio-agent, se Legg til en Copilot Studio-agent som en tilknyttet agent. For å koble til en Microsoft Foundry-agent, se Legg til en Foundry-agent som en tilkoblet agent.

Prerequisites

  • En agent opprettet med GitHub Copilot-selen for å være hovedagent. Se Opprett en agent (forhåndsversjon).
  • En fjernagent som implementerer Agent-til-agent-protokollen og er tilgjengelig fra Copilot Studio over det offentlige internett.
  • URL-en til agentkortet for den eksterne agenten, vanligvis https://<your-agent-host>/.well-known/agent-card.json.
  • Autentiseringsdetaljer som den eksterne agenten krever, hvis noen. Copilot Studio støtter ingen autentisering, API-nøkkel og OAuth 2.0.
  • For OAuth 2.0, tillatelse til å legge til en omdirigerings-URI til app-registreringen som den eksterne agentens identitetsleverandør bruker. Copilot Studio genererer omdirigerings-URL-en under veiviseren, og du må registrere den før du oppretter tilkoblingen.

Note

Siden A2A-tilkoblinger bruker den egendefinerte tilkoblingsinfrastrukturen, kan du også bruke dem til å koble til A2A-agenter som kjører lokalt eller i et virtuelt nettverk.

Legg til en Agent2Agent (A2A)-agent

Guiden veileder deg gjennom tre eller fire steg, avhengig av hvilken autentiseringsmetode du velger:

  • Hvis du velger Ingen eller API-nøkkel: Koble til en A2A-agent, koble til A2A-agenten, og deretter gjennomgå og legg til.
  • Hvis du velger OAuth 2.0: Koble til en A2A-agent, legge til omdirigerings-URL,koble til A2A-agenten, og deretter gjennomgå og legg til.

  1. Logg på Copilot Studio.

  2. Velg og åpne agenten du ønsker å bruke som primæragent.

  3. Velg fanen Bygg i agentens navigasjonsfelt.

  4. I komponentpanelet velger du Tilkoblede agenter for å åpne dialogboksen Legg til en tilkoblet agent.

  5. I dialogen velger Legg til, og deretter Legg til A2A-agent.

  6. På steget Connect to an A2A agent, skriv inn detaljene til den eksterne agenten:

    • Agentkort-URL: URL-en til den eksterne agentens agentkort, for eksempel https://agent.example.com/.well-known/agent-card.json. Copilot Studio leser kortet for å oppdage agentens endepunkt og kapasiteter.
    • Navn: navnet som vises for agentforfatteren. Hvis agentkortet inneholder et navn, fyller Copilot Studio ut dette feltet for deg.
    • Beskrivelse: en klar beskrivelse av når denne A2A-agenten skal brukes, mellom 30 og 1 000 tegn. Hvis agentkortet inneholder en beskrivelse, fyller Copilot Studio ut dette feltet for deg. Orkestratoren bruker denne beskrivelsen for å avgjøre når en forespørsel skal rutes til agenten, så gjør det spesifikt og unngå overlapp med dine andre verktøy og agenter. Lær mer om å skrive effektive metadata.

    Note

    Hvis navn og beskrivelse ikke fylles ut automatisk, kan det hende at fjernagenten ikke har agentkort, kortet kan være på en annen URL enn den du skrev inn, eller Copilot Studio kan ikke nå det. Sjekk URL-en først, og prøv å åpne agentkortet i nettleseren din. Hvis kortet ikke er tilgjengelig, skriv inn navn og beskrivelse manuelt.

  7. Under Autentisering velger du hvordan Copilot Studio autentiserer seg med den eksterne agenten og fyller deretter ut detaljene for metoden du valgte:

    Du kan ikke fortsette før autentiseringsdetaljene er fullført.

  8. Velg Neste.

  9. Hvis du valgte OAuth 2.0, vises steget Legg til omdirigert URL . Copilot Studio lager koblingen for A2A-agenten, og plattformen genererer en omdirigerings-URL for den. Registrer den URL-en hos din identitetsleverandør før du oppretter tilkoblingen:

    1. Vent til feltet for omdirigerings-URL-en fylles ut. Koblingen må eksistere før URL-en genereres.
    2. Velg kopier-knappen ved siden av feltet for å kopiere URL-en.
    3. I OAuth-appens registrering, legg til URL-en som en omdirigerings-URI, og lagre appregistreringen.
    4. Velg Neste.

    Viktig!

    Hvis du ikke registrerer omdirigerings-URL-en først, mislykkes det første forsøket på å autorisere tilkoblingen. Omdirigerings-URL-en genereres per kobling, så den er spesifikk for denne A2A-agenten og kan ikke gjenbrukes fra en annen kobling. Hvis du trenger URL-en igjen senere, velg A2A-agenten under Connected-agenter i komponentpanelet for å åpne den igjen.

  10. På steget Koble til A2A-agenten velger du tilkoblingen denne agenten bruker for å nå den eksterne agenten:

    • Velg en eksisterende tilkobling fra listen over tilgjengelige tilkoblinger.
    • Hvis ingen tilkobling er tilgjengelig, opprett en ny tilkobling. Hvis den eksterne agenten bruker API-nøkkelautentisering, legger du inn API-nøkkelverdien når du oppretter forbindelsen.

  11. Velg Neste.

  12. På trinnet Se gjennom og legg til, sjekk navnet, beskrivelsen og agentkortets URL, og velg deretter Legg til i agenten.

  13. Bekreft at den tilkoblede agenten vises under Connected agents i komponentpanelet.

Hvis du går tilbake og endrer autentiseringsinnstillingene på steget Connect to a A2A-agent, forkaster Copilot Studio kontakten som ble bygget fra de forrige innstillingene. Du må registrere en ny omdirigerings-URL og velge en tilkobling på nytt.

Note

Du er ansvarlig for nøye å gjennomgå og teste tilknyttede agenter i konteksten av dine spesifikke bruksområder, og ta alle nødvendige beslutninger og tilpasninger. Når du kobler til agenter utenfor Copilot Studio, er du ansvarlig for bruken av slike agenter. Vurderinger inkluderer å sikre:

  • Dataflyt, datahåndtering og datadeling mellom agenter passer for ditt bruksområde og oppfyller relevante krav og lover.
  • Agentene oppfyller passende standarder for kvalitet, pålitelighet, sikkerhet og troverdighet.
  • Riktige tillatelser, grenser og godkjenninger er gitt hvis det er fornuftig for ditt brukstilfelle.
  • Riktig observabilitet, identitet og sporbarhet, samt menneskelige tilsynsfunksjoner er på plass.

Konfigurer API-nøkkelgodkjenning

Når du velger API-nøkkel, velg hvor Copilot Studio sender nøkkelen ved å velge en parametertype:

  • Header: nøkkelen sendes som en forespørselsheader. I Header-navn, skriv inn navnet på headeren den eksterne agenten forventer, for eksempel x-api-key.
  • Spørringsstreng: nøkkelen sendes som en spørringsstrengparameter. I Parameter label, skriv inn navnet på spørringsstrengparameteren den eksterne agenten forventer.

Du skriver inn selve API-nøkkelverdien når du oppretter forbindelsen, ikke i dette steget. På den måten lagres nøkkelen sammen med tilkoblingen og er ikke synlig i agentkonfigurasjonen.

Konfigurer OAuth 2.0-godkjenning

Når du velger OAuth 2.0, velg en konfigurasjonstype:

  • Dynamisk: Copilot Studio registrerer en klient hos den eksterne agentens identitetsleverandør for deg. Skriv inn autorisasjons-URL-en og token-URL-en.

  • Manuelt: Bruk en appregistrering du allerede har opprettet hos den eksterne agentens identitetsleverandør. Angi følgende verdier:

    • Klient-ID: klient-ID-en til appregistreringen din.
    • Klienthemmelighet: klienthemmeligheten for appregistreringen din.
    • Autorisasjons-URL: identitetsleverandørens autorisasjonsendepunkt.
    • Token-URL: identitetsleverandørens tokenendepunkt.
    • Refresh token URL: endepunktet som brukes til å oppdatere tilgangstoken.
    • Scopes (valgfritt): scopes som skal forespørres, adskilt av mellomrom.

Bruk Dynamic når den eksterne agentens identitetsleverandør støtter dynamisk klientregistrering. Bruk Manual når du trenger å kontrollere appregistreringen, for eksempel når identitetsleverandøren din krever forhåndsregistrerte omdirigerings-URI-er eller samtykke.

Begge konfigurasjonstyper krever at du registrerer en omdirigerings-URL hos identitetsleverandøren din. Etter at du har valgt Neste, oppretter Copilot Studio koblingen og viser den genererte omdirigerings-URL-en i steget Legg til omdirigerings-URL.

Finn omdirigerings-URL-en senere

Hvis du lukker veiviseren eller mister omdirigerings-URL-en, kan du se den igjen når som helst:

  1. På Bygg-fanen, velg A2A-agenten under Connected agents i komponentpanelet.

  2. I dialogen Rediger A2A-agent , kopier verdien i feltet for omdirigerings-URL .

Omdirigerings-URL-feltet vises kun for A2A-agenter som bruker OAuth 2.0.

Hvordan orkestratoren ruter til A2A-agenten

Etter at du har lagt til A2A-agenten, bestemmer orkestreringskjøretiden automatisk når den skal delegere til den. Rutebeslutningen baseres på følgende:

  • Den tilknyttede agentens navn og beskrivelse
  • Brukerens melding og samtalekontekst
  • Instruksjonene fra primæragenten

Tips

Skriv en klar, spesifikk beskrivelse for A2A-agenten slik at orkestratoren nøyaktig kan avgjøre når forespørsler skal rutes til den. Unngå overlappende beskrivelser mellom tilkoblede agenter.

Test delegeringen

Etter at du har lagt til A2A-agenten:

  1. Velg fanen Forhåndsvisning i agentnavigasjonsfeltet.

  2. Send en melding som samsvarer med A2A-agentens domene.

  3. Verifiser at svaret kommer fra A2A-agenten og er passende.

  4. Send en melding utenfor A2A-agentens domene for å bekrefte at primæragenten håndterer den.

Hvis du må endre navn eller beskrivelse senere, rediger den tilkoblede agenten fra komponentpanelet. Se Administrer tilkoblede agenter i en agent.

Feilsøk tilkoblingen

Problem Hva du bør kontrollere
Autorisasjon av tilkoblingen feiler med en omdirigerings-URI-feil Omdirigerings-URL-en som Copilot Studio genererte er ikke registrert hos identitetsleverandøren din. Kopier URL-en fra dialogen Rediger A2A-agent , legg den til i app-registreringen din, og autoriser deretter tilkoblingen på nytt.
Omdirigerings-URL-feltet forblir tomt i veiviseren Koblingen opprettes fortsatt. Hvis steget viser en feil i stedet, velg Prøv på nytt.
Navnet og beskrivelsen fylles ikke ut fra agentkortet Sjekk at agentkortets URL er korrekt og at Copilot Studio kan nå kortet. Skriv inn navn og beskrivelse manuelt hvis kortet ikke er tilgjengelig.
Koblingen du opprettet fungerer ikke lenger etter at du redigerte veiviseren Endring av autentiseringsinnstillingene fjerner tilkoblingen som er bygd, fra de forrige innstillingene. Registrer den nye omdirigerings-URL-en og velg en tilkobling på nytt.
  • Sist oppdatert