Legg til en Foundry-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 eksisterende Microsoft Foundry-agent 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.

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 en ekstern agent over Agent2Agent (A2A)-protokollen, se Legg til en A2A-agent som en tilkoblet agent. Hvis du vil koble til en agent bygget med SDK for Microsoft 365-agenter, kan du se Legg til en SDK for Microsoft 365-agenter-agent som en tilkoblet agent.

Prerequisites

  • En agent opprettet med GitHub Copilot-selen for å være hovedagent. Se Opprett en agent (forhåndsversjon).
  • En eksisterende Foundry-agent opprettet i et prosjekt i Microsoft Foundry-portalen, med Activity-protokollen aktivert og agentens agent-ID tilgjengelig. Foundry-agenter har ikke Activity-protokollen aktivert som standard. Se Aktiver aktivitetsprotokollen på din Foundry-agent.
  • URL-adressen til Azure AI Project-endepunktet for prosjektet som hoster Foundry-agenten.
  • Tillatelse til å få tilgang til Foundry-prosjektet. Tilkoblingen autentiseres med din Microsoft Entra ID-brukerinnlogging.

Note

Du kan bare koble til agenter opprettet i den nåværende Microsoft Foundry-portalen. Tilkobling til en agent opprettet i forrige portal gir en 404 - Version not found feilmelding.

Legg til en Foundry-agent

  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, velg Legg til, og velg deretter Legg til Foundry-agent.

  6. På trinnet Koble til Azure AI Foundry velger du tilkoblingen denne agenten bruker for å nå Microsoft Foundry:

    • Velg en eksisterende tilkobling fra Tilkobling-listen.
    • Hvis ingen tilkobling er tilgjengelig, velg Opprett ny tilkobling og fortsett til neste steg.

  7. Hvis du oppretter en ny tilkobling, skriv inn tilkoblingsdetaljene, og velg deretter Opprett:

    • Visningsnavn (valgfritt): et navn som hjelper deg å identifisere denne forbindelsen senere.
    • Autentiseringstype: Microsoft Entra ID brukerinnlogging. Denne verdien er satt for deg.
    • Azure AI-prosjektendepunkt: endepunkts-URL-en til Foundry-prosjektet som hoster agenten.

  8. Tilbake på steget Connect to Azure AI Foundry, bekreft at tilkoblingen din er valgt, og velg deretter Neste.

  9. På Se gjennom og legg til-trinnet skriver du inn detaljene for Foundry-agenten du vil koble til, og velger deretter Legg til i agent:

    • Navn: navnet som vises for agentforfatteren.
    • Beskrivelse: en klar beskrivelse av når denne Foundry-agenten bør brukes. 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. For mer informasjon, se å skrive effektive metadata.
    • Agent-ID: ID-en til Foundry-agenten du vil koble deg til.

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

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.

Aktiver aktivitetsprotokollen på din Foundry-agent

Copilot Studio kommuniserer med en tilkoblet Foundry-agent ved å bruke Activity-protokollen. Foundry-agenter har ikke denne protokollen aktivert som standard, så du må aktivere den før hovedagenten din kan utveksle meldinger med Foundry-agenten. Hvis Aktivitetsprotokollen ikke er aktivert, kan du fortsatt legge til tilkoblingen, men å kalle Foundry-agenten feiler.

Du kan aktivere Activity protocol på en av følgende måter:

  • Publiser Foundry-agenten til Microsoft 365 eller Microsoft Teams. Når du publiserer en prompt-agent til Microsoft 365 eller Teams, aktiveres Aktivitetsprotokollen og det nødvendige BotServiceRbac autorisasjonsskjemaet automatisk. Velg dette alternativet hvis du allerede planlegger å publisere agenten på disse kanalene.

  • Aktiver det manuelt med et REST API-kall. Hvis du ikke publiserer agenten til Microsoft 365 eller Teams, kaller du opp Foundry Agenter – Oppdater agent-REST-API-en for å legge til protokollen activity og autorisasjonsordningen BotServiceRbac i agenten.

Hvis du vil ha mer informasjon om hvordan du konfigurerer og deler din Foundry-agent, se Konfigurer og del din Microsoft Foundry-agent.

Aktiver Activity-protokollen med et REST API-kall

Kall opp Foundry Agenter – Oppdater agent-REST-API. Bytt ut {{endpoint}}, {{agent_name}} og {{token}} med endepunktet, agentnavnet og tilgangstokenet for Foundry-prosjektet ditt.

Viktig!

Behold responses og Entra i listene. Å fjerne dem bryter chatten med agenten fra Foundry-portalen eller SDK-en.

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"
            }
        ]
    }
}

Hvordan orkestratoren ruter til Foundry-agenten

Etter at du har lagt til Foundry-agenten, fastsetter iverksettingskjø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 Foundry-agenten slik at orkestratoren nøyaktig kan avgjøre når forespørsler skal sendes til den. Unngå overlappende beskrivelser mellom tilkoblede agenter.

Test delegeringen

Etter at du har lagt til Foundry-agenten:

  1. Velg fanen Forhåndsvisning i agentnavigasjonsfeltet.

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

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

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

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

  • Sist oppdatert