Lisää Agent2Agent (A2A) -agentti yhdistetyksi agentiksi (GitHub Copilot)

Käytä yhdistettyjä agentteja, jotta pääagenttisi voi delegoida erityisiä tehtäviä erikoistuneille agenteille. Tässä artikkelissa näytetään, miten yhdistät etäagentin, joka on käytettävissä Agent2Agent (A2A) -protokollan kautta, jotta pääagenttisi voi siirtää tehtävät sille.

Note

Tämän agentin rakentamiseen käytetyssä ympäristössä käytetään käyttöön perustuvaa laskutusta. Agenttien käyttäminen, rakentaminen, testaaminen ja arviointi saattaa kuluttaa Copilot-krediittejä. Lue lisää Yleiskatsauksesta käyttöperusteisesta laskutuksesta.

A2A-protokolla on avoin standardi viestintään ja yhteistyöhön agenttien välillä. Koska kyseessä on avoin standardi, voit yhdistää agentteja, jotka on isännöity Copilot Studio:n ulkopuolella ja jotka perustuvat muihin kehyksiin, kunhan ne toteuttavat A2A:n. Copilot Studio löytää etäagentin agenttikortiltaan ja käyttää A2A-protokollaa delegoidakseen tehtäviä sille ajonaikaisesti.

Lisäät kaikki yhdistetyt agentit samasta Lisää yhdistetty agentti -dialogista. Yleiskatsauksen yhdistetyistä agenteista ja reitityksen toiminnasta saat artikkelista Connected agents overview. Toisen Copilot Studio -agentin yhdistämiseksi katso Lisää Copilot Studio -agentti yhdistetyksi agentiksi. Microsoft Foundry -agentin yhdistämiseksi katso Lisää Foundry-agentti yhdistetyksi agentiksi.

Vaatimukset

  • Agentti, joka on luotu GitHub Copilot -valjastuksen avulla ensisijaiseksi agentiksi. Katso Luo agentti (esiversio).
  • Etäagentti, joka toteuttaa Agent-to-Agent-protokollan ja on saavutettavissa Copilot Studio:sta julkisen internetin kautta.
  • Etäagentin agenttikortin URL, tyypillisesti https://<your-agent-host>/.well-known/agent-card.json.
  • Etäagentin tarvitsemat todennustiedot, jos niitä on. Copilot Studio tukee todennuksen jättämistä pois, ohjelmistorajapinta-avainta ja OAuth 2.0 -protokollaa.
  • OAuth 2.0:lle oikeus lisätä uudelleenohjauksen URI sovellusrekisteröintiin, jota etäagentin tunnistetietojen tarjoaja käyttää. Copilot Studio luo uudelleenohjauksen URL-osoitteen ohjatun toiminnon aikana, ja se on rekisteröitävä ennen yhteyden luomista.

Note

Koska A2A-yhteydet käyttävät mukautettua liitininfrastruktuuria, voit käyttää niitä myös yhteyden muodostamiseen A2A-agentteihin, jotka toimivat paikallisesti tai näennäisverkossa.

Lisää Agent2Agent (A2A) -agentti

Ohjattu toiminto ohjaa sinut kolmen tai neljän vaiheen läpi valitsemastasi tunnistautumistavasta riippuen:

  • Jos valitset Ei mitään tai API-avain: Yhdistä A2A-agenttiin, Yhdistä kyseiseen A2A-agenttiin, sitten Tarkista ja lisää.
  • Jos valitset OAuth 2.0: Yhdistä A2A-agenttiin, Lisää redirect URL, Yhdistä A2A-agenttiin, sitten Tarkista ja lisää.

  1. Kirjaudu sisään Copilot Studio.

  2. Valitse ja avaa agentti, jota haluat käyttää ensisijaisena agenttina.

  3. Agentin navigointipalkista valitse Build-välilehti .

  4. Valitse komponenttipaneelista Yhdistetyt agentit avataksesi Lisää yhdistetty agentti -valintaikkunan.

  5. Valintaikkunassa valitse Lisää, ja sitten Lisää A2A-agentti.

  6. Yhdistä A2A-agenttiin -vaiheessa syötä etäagentin tiedot:

    • Agenttikortin URL: etäagentin agenttikortin URL, esimerkiksi https://agent.example.com/.well-known/agent-card.json. Copilot Studio lukee kortin selvittääkseen agentin päätepisteen ja kyvyt.
    • Nimi: Agentin tekijälle näkyvä nimi. Jos agenttikortissa on nimi, Copilot Studio täyttää tämän kentän puolestasi.
    • Kuvaus: selkeä kuvaus siitä, milloin tätä A2A-agenttia tulisi käyttää, 30–1 000 merkkiä. Jos agenttikortissa on kuvaus, Copilot Studio täyttää tämän kentän puolestasi. Orkestroija käyttää tätä kuvausta päättääkseen, milloin pyyntö reititetään agentille, joten tee siitä tarkka ja vältä päällekkäisyyttä muiden työkalujen ja agenttien kanssa. Lue lisää tehokkaiden metatietojen kirjoittamisesta.

    Note

    Jos nimeä ja kuvausta ei täytetä automaattisesti, etäagentilla ei välttämättä ole agenttikorttia, kortti voi olla eri URL-osoitteessa kuin syötit, tai Copilot Studio ei välttämättä pääse siihen käsiksi. Tarkista ensin URL ja kokeile avata agenttikortti selaimessasi. Jos korttia ei ole saatavilla, syötä nimi ja kuvaus manuaalisesti.

  7. Määritä Todennus-kohdassa, miten Copilot Studio todennetaan etäagentille, ja täytä sitten valitun menetelmän tiedot seuraavasti:

    Et voi jatkaa ennen kuin todennustiedot ovat valmiit.

  8. Valitse Seuraava.

  9. Jos valitsit OAuth 2.0, Lisää uudelleenohjauksen URL-osoite -vaihe ilmestyy. Copilot Studio luo liittimen A2A-agentille, ja alusta generoi sille uudelleenohjaus-URL:n. Rekisteröi kyseinen URL identiteettipalveluntarjoajallesi ennen yhteyden luomista:

    1. Odota, että Redirect URL -kenttä täyttyy. Liittimen täytyy olla olemassa ennen kuin URL generoidaan.
    2. Napsauta kopiointipainiketta kentän vierestä kopioidaksesi URL-osoitteen.
    3. OAuth-sovelluksen rekisteröinnissä lisää URL ohjaus-URI:ksi ja tallenna sovellusrekisteröinti.
    4. Valitse Seuraava.

    Tärkeää

    Jos et rekisteröi uudelleenohjaus-URL:ää ensin, ensimmäinen yritys valtuuttaa yhteys epäonnistuu. Uudelleenohjaus-URL generoidaan liitinkohtaisesti, joten se on tälle A2A-agentille spesifinen eikä sitä voi käyttää uudelleen toisessa liittimessä. Jos tarvitset URL-osoitteen myöhemmin uudelleen, valitse A2A-agentti komponenttipaneelin Connected agents -kohdasta avataksesi sen uudelleen.

  10. Yhdistä A2A-agenttiin -vaiheessa valitse yhteys, jota agentti käyttää etäagentin saavuttamiseen:

    • Valitse olemassa oleva yhteys saatavilla olevien yhteyksien listalta.
    • Jos yhteyttä ei ole saatavilla, luo uusi yhteys. Jos etäagentti käyttää API-avaimen tunnistautumista, syötät API-avaimen arvon yhteyden luomisen yhteydessä.

  11. Valitse Seuraava.

  12. Tarkista ja lisää -vaiheessa tarkista nimi, kuvaus ja agenttikortin URL, ja valitse sitten Lisää agentille.

  13. Vahvista, että yhdistetty agentti näkyy komponenttipaneelin Yhdistetyt agentit -kohdassa.

Jos palaat takaisin ja muutat todennusasetuksia vaiheessa Connect to an A2A agent, Copilot Studio hylkää aiempien asetusten perusteella rakennetun liittimen. Sinun täytyy rekisteröidä uusi uudelleenohjaus-osoite ja valita yhteys uudelleen.

Note

Sinun vastuullasi on tarkastella ja testata yhdistetyt agentit huolellisesti omien käyttötapaustesi kontekstissa sekä tehdä kaikki tarvittavat päätökset ja mukautukset. Kun muodostat yhteyden Copilot Studion ulkopuolisiin agentteihin, olet vastuussa tällaisten agenttien käytöstä. Huomioitaviin asioihin kuuluu varmistaa:

  • Datavirrat, datan käsittely ja tiedon jakaminen agenttien välillä sopivat käyttötapaukseesi ja täyttävät asiaankuuluvat vaatimukset ja lait.
  • Välittäjät täyttävät asianmukaiset laatu-, luotettavuus-, turvallisuus- ja luotettavuusvaatimukset.
  • Sopivat luvat, rajat ja hyväksynnät annetaan, jos ne sopivat käyttötapaukseesi.
  • Asianmukainen havaittavuus, identiteetti ja jäljitettävyys sekä ihmisen valvontatoiminnot ovat käytössä.

Ohjelmointirajapinta-avaimen todentamisen määrittäminen

Kun valitset API-avaimen, valitse mihin Copilot Studio lähettää avaimen valitsemalla parametrityypin:

  • Otsake: avain lähetetään pyyntöotsikona. Otsikon nimeen syötä sen otsikon nimi, jota etäagentti odottaa, esimerkiksi x-api-key.
  • kyselymerkkijono: avain lähetetään kyselymerkkijonon parametrina. Kirjoita kohtaan Parametrin tunniste sen kyselymerkkijonoparametrin nimi, jota etäagentti odottaa.

Syötät API-avaimen arvon itse yhteyden luomisen yhteydessä, ei tässä vaiheessa. Näin avain tallennetaan yhteyden mukana eikä näy agentin konfiguraatiossa.

OAuth 2.0 -todennuksen määrittäminen

Kun valitset OAuth 2.0:n, valitse konfiguraatiotyyppi:

  • Dynaaminen: Copilot Studio rekisteröi asiakasohjelman etäagentin tunnistetietojen toimittajan avulla käyttäjän puolesta. Syötä valtuutuksen URL ja tokenin URL.

  • Manuaalinen: Etäagentin tunnistetietojen tarjoajan avulla luodon sovelluksen rekisteröinnin käyttäminen. Syötä seuraavat arvot:

    • Asiakastunnus: sovelluksen rekisteröinnin asiakastunnus.
    • Asiakasohjelman salasana: Sovelluksen rekisteröinnin asiakasohjelman salasana.
    • Valtuutus-URL: identiteettipalveluntarjoajan valtuutuspäätepiste.
    • Token URL: identiteettipalveluntarjoajan tokenin päätepiste.
    • Refresh token URL: päätepiste, jota käytetään käyttöoikeustokenien päivittämiseen.
    • Scopes (valinnainen): pyydettävät scopet, erotettuna välilyönnein.

Käytä Dynamic, kun etäagentin identiteettipalveluntarjoaja tukee dynaamista asiakasrekisteröintiä. Käytä Manual, kun sinun täytyy hallita sovelluksen rekisteröintiä, esimerkiksi kun henkilöllisyyspalveluntarjoajasi vaatii ennakkorekisteröityjä uudelleenohjaus-URI-osoitteita tai suostumusta.

Kumpikin konfiguraatiotyyppi vaatii uudelleenohjaus-URL:n rekisteröimistä identiteettipalveluntarjoajallesi. Kun valitset Next-painikkeen, Copilot Studio luo liittimen ja näyttää generoidun uudelleenohjaus-URL-osoitteen Add redirect URL -vaiheessa.

Selvitä uudelleenohjaus-URL myöhemmin

Jos suljet ohjatun toiminnon tai menetät uudelleenohjaus-URL:n, voit katsoa sitä uudelleen milloin tahansa:

  1. Valitse Build-välilehdellä A2A-agentti komponenttipaneelista kohdan Connected agents alta.

  2. Kopioi arvo Redirect URL -kentästä Muokkaa A2A-agenttia -valintaikkunassa.

Redirect URL-kenttä näkyy vain A2A-agenteissa, jotka käyttävät OAuth 2.0:aa.

Miten orkestroija reitittää A2A-agentille

Kun lisäät A2A-agentin, orkestroinnin ajonaikainen ympäristö määrittää automaattisesti, milloin sille delegoidaan. Reitityspäätös perustuu:

  • Yhdistetyn agentin nimi ja kuvaus
  • Käyttäjän viesti ja keskustelun konteksti
  • Ensisijaisen agenttisi ohjeet

Vinkki

Kirjoita selkeä ja tarkka kuvaus jokaiselle A2A-agentille, jotta orkestroija voi tarkasti määrittää, milloin pyynnöt reititetään sille. Vältä päällekkäisiä kuvauksia liitettyjen agenttien välillä.

Delegoinnin testaus

Kun lisäät A2A-agentin:

  1. Valitse agentin navigointipalkista Esikatselu-välilehti.

  2. Lähetä viesti, joka vastaa A2A-agentin domainia.

  3. Varmista, että vastaus tulee A2A-agentilta ja on asianmukainen.

  4. Lähetä viesti A2A-agentin domainin ulkopuolelle varmistaaksesi, että pääasiallinen agenttisi hoitaa asian.

Jos sinun täytyy myöhemmin muuttaa nimeä tai kuvausta, muokkaa yhdistettyä agenttia komponenttipaneelista. Katso Yhdistettyjen agenttien hallinta agentissa.

Yhteyden vianmääritys

Ongelma Tarkistettavat tehtävät
Yhteyden valtuuttaminen epäonnistuu uudelleenohjaus-URI-virheen vuoksi Copilot Studio:n luoma uudelleenohjaus-osoite ei ole rekisteröity identiteettipalveluntarjoajallesi. Kopioi URL-osoite Muokkaa A2A-agenttia -valintaikkunasta, lisää se sovelluksen rekisteröintiin ja valtuuta yhteys uudelleen.
Uudelleenohjauksen URL-osoite -kenttä pysyy tyhjänä ohjatussa toiminnossa Liitin on vielä luomisvaiheessa. Jos vaihe näyttää virheen, valitse Retry.
Nimeä ja kuvausta ei täytetä agenttikortista Tarkista, että agenttikortin URL-osoite on oikea ja että Copilot Studio voi tavoittaa kortin. Syötä nimi ja kuvaus manuaalisesti, jos korttia ei ole saatavilla.
Luotu yhteys ei toimi ohjatun toiminnon muokkaamisen jälkeen Tunnistautumisasetusten muuttaminen hylkää aiemmista asetuksista rakennetun liittimen. Rekisteröi uusi uudelleenohjaus-osoite ja valitse yhteys uudelleen.
  • Viimeksi päivitetty