Lisää Foundry-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 olemassa oleva Microsoft Foundry -agentti yhdistetään, jotta pääagenttisi voi siirtää sille tehtäviä.

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.

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. Etäagentin yhdistämiseksi Agent2Agent (A2A) -protokollan kautta katso Lisää A2A-agentti yhdistetyksi agentiksi. Microsoft 365 -agenttien SDK:lla rakennetun agentin yhdistämiseksi katso Lisää Microsoft 365 -agenttien SDK -agentti yhdistetyksi agentiksi.

Vaatimukset

  • Agentti, joka on luotu GitHub Copilot -valjastuksen avulla ensisijaiseksi agentiksi. Katso Luo agentti (esiversio).
  • Olemassa oleva Foundry-agentti, joka on luotu Microsoft Foundry -portaalissa olevassa projektissa, jossa Activity-protokolla on käytössä ja agentin Agent ID on saatavilla. Foundry-agenteilla ei ole Activity-protokollaa oletuksena käytössä. Katso Ota käyttöön Activity-protokolla Foundry-agentillasi.
  • Azure AI Project -päätepisteen URL-osoite sille projektille, joka isännöi Foundry-agenttia.
  • Pääsyoikeus Foundry-projektiin. Yhteys autentikoituu Microsoft Entra ID -käyttäjätunnuksellasi.

Note

Voit yhdistää vain agentteihin, jotka on luotu nykyisessä Microsoft Foundry -portaalissa. Yhteys edellisessä portaalissa luotuun agenttiin palauttaa 404 - Version not found virheen.

Lisää Foundry-agentti

  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ää Foundry-agentti.

  6. Connect to Azure AI Foundry -vaiheessa valitse yhteys, jota tämä agentti käyttää päästäkseen Microsoft Foundryyn:

    • Valitse olemassa oleva yhteys Yhteys-luettelosta.
    • Jos yhteyttä ei ole saatavilla, valitse Luo uusi yhteys ja jatka seuraavaan vaiheeseen.

  7. Jos luot uuden yhteyden, syötä yhteyden tiedot ja valitse sitten Luo:

    • Näyttönimi (valinnainen): nimi, joka auttaa tunnistamaan tämän yhteyden myöhemmin.
    • Tunnistautumistyyppi: Microsoft Entra ID -käyttäjän kirjautuminen. Tämä arvo on asetettu sinulle.
    • Azure AI Project Endpoint: Foundry-projektin päätepisteen URL, joka isännöi agenttia.

  8. Palaa Muodosta yhteys Azure AI Foundryyn -vaiheeseen, varmista, että yhteys on valittu, ja valitse sitten Seuraava.

  9. Tarkista ja lisää -vaiheessa syötä haluamasi Foundry-agentin tiedot ja valitse sitten Lisää agentille:

    • Nimi: Agentin tekijälle näkyvä nimi.
    • Kuvaus: selkeä kuvaus siitä, milloin tätä Foundry-agenttia tulisi käyttää. 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. Lisätietoja on kohdassa Tehokkaiden metatietojen kirjoittaminen.
    • Agentin tunnus: Foundry-agentin tunnus, johon haluat muodostaa yhteyden.

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

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ä.

Ota käyttöön Activity-protokolla Foundry-agentillasi

Copilot Studio kommunikoi yhdistetyn Foundry-agentin kanssa Activity-protokollan avulla. Foundry-agenteilla tätä protokollaa ei ole oletuksena käytössä, joten sinun täytyy ottaa se käyttöön ennen kuin ensisijainen agentti voi vaihtaa viestejä Foundry-agentin kanssa. Jos Activity-protokolla ei ole käytössä, voit silti lisätä yhteyden, mutta Foundry-agentin kutsuminen epäonnistuu.

Voit ottaa Activity-protokollan käyttöön kummallakin seuraavista tavoista:

  • Julkaise Foundry-agentti Microsoft 365:een tai Microsoft Teams:iin. Kun julkaiset prompt-agentin Microsoft 365:een tai Teamsiin, Activity-protokolla ja vaadittu BotServiceRbac valtuutusmenetelmä otetaan automaattisesti käyttöön. Valitse tämä vaihtoehto, jos aiot jo julkaista agentin niillä kanavilla.

  • Ota se käyttöön manuaalisesti REST-API-kutsulla. Jos et julkaise agenttia Microsoft 365:een tai Teamsiin, kutsu Foundryn Agentit – Päivitä agentti -REST API -ohjelmointirajapintaa lisätäksesi activity-protokollan ja BotServiceRbac-valtuutusmallin agenttiin.

Lisätietoja Foundry-agentin konfiguroinnista ja jakamisesta löytyy kohdasta Määritä ja jaa Microsoft Foundry -agenttisi.

Ota Activity-protokolla käyttöön REST-API-kutsulla

Kutsu Foundryn Agentit – Päivitä agentti -REST API -ohjelmointirajapintaa. Korvaa {{endpoint}}, {{agent_name}}, ja {{token}} päätepisteellä, agentin nimellä ja pääsytunnuksella Foundry-projektissasi.

Tärkeää

Pidä responses ja Entra listoissa. Niiden poistaminen estää keskustelun Foundry-portaalin tai SDK:n agentin kanssa.

PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: Bearer {{token}}
Content-Type: application/merge-patch+json
Foundry-Features: AgentEndpoints=V1Preview

{
    "agent_endpoint": {
        "protocols": [
            "responses",
            "activity"
        ],
        "authorization_schemes": [
            {
                "type": "Entra",
                "isolation_key_source": {
                    "kind": "Entra"
                }
            },
            {
                "type": "BotServiceRbac"
            }
        ]
    }
}

Miten orkestroija ohjaa Foundry-agentin luo

Kun Foundryn agentti on lisätty, orkestrointimoottori 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 Foundry-agentista, jotta orkestroija voi määrittää tarkasti, milloin pyynnöt ohjataan sille. Vältä päällekkäisiä kuvauksia liitettyjen agenttien välillä.

Delegoinnin testaus

Kun lisäät Foundry-agentin:

  1. Valitse agentin navigointipalkista Esikatselu-välilehti.

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

  3. Varmista, että vastaus tulee Foundryn edustajalta ja on asianmukainen.

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

Jos joudut myöhemmin muuttamaan agentin tunnusta tai kuvausta, muokkaa yhdistettyä agenttia komponenttipaneelista. Katso Yhdistettyjen agenttien hallinta agentissa.

  • Viimeksi päivitetty