Tilføj en Foundry-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 eksisterende Microsoft Foundry-agent, 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.

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 forbinde en fjernagent over Agent2Agent (A2A)-protokollen, se Tilføj en A2A-agent som en tilkoblet agent. Hvis du vil oprette forbindelse til en agent, der er bygget med SDK til Microsoft 365-agenter, skal du se Tilføj en SDK til Microsoft 365-agenter-agent som en tilsluttet agent.

Forudsætninger

  • En agent oprettet med GitHub Copilot-harnesset som primær agent. Se Opret en agent (forhåndsversion).
  • En eksisterende Foundry-agent oprettet i et projekt i Microsoft Foundry-portalen, med Activity-protokollen aktiveret og agentens Agent-ID tilgængeligt. Foundry-agenter har ikke Activity-protokollen aktiveret som standard. Se Aktiver aktivitetsprotokollen på din Foundry-agent.
  • Azure AI Project endpoint-URL'en for det projekt, der hoster Foundry-agenten.
  • Tilladelse til adgang til Foundry-projektet. Forbindelsen autentificeres med dit Microsoft Entra ID-brugerlogin.

Notat

Du kan kun forbinde til agenter, der er oprettet i den nuværende Microsoft Foundry-portal. Forbindelse til en agent oprettet i den forrige portal giver en 404 - Version not found fejl.

Tilføj en Foundry-agent

  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 dialogen vælg Tilføj, og vælg derefter Tilføj Foundry-agent.

  6. På Connect to Azure AI Foundry-trinnet vælger du den forbindelse, denne agent bruger til at nå Microsoft Foundry:

    • Vælg en eksisterende forbindelse på listen Forbindelse.
    • Hvis der ikke er nogen forbindelse tilgængelig, vælg Opret ny forbindelse og fortsæt til næste trin.

  7. Hvis du opretter en ny forbindelse, indtast forbindelsesdetaljerne, og vælg derefter Opret:

    • Visningsnavn (valgfrit): et navn, der hjælper dig med at identificere denne forbindelse senere.
    • Autentificeringstype: Microsoft Entra ID brugerlogin. Denne værdi er angivet for dig.
    • Azure AI Project Endpoint: endpoint-URL'en for Foundry-projektet, der hoster agenten.

  8. Tilbage på Connect to Azure AI Foundry-trinnet, bekræft at din forbindelse er valgt, og vælg derefter Næste.

  9. På trinnet Gennemgå og tilføj skal du indtaste oplysningerne om den Foundry-agent, du vil forbinde, og derefter vælge Tilføj til agent:

    • Navn: navnet vist til agentforfatteren.
    • Beskrivelse: en klar beskrivelse af, hvornår denne Foundry-agent skal bruges. 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. Du kan få flere oplysninger under skrivning af effektive metadata.
    • Agent ID: ID'et på den Foundry-agent, du vil forbinde dig til.

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

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.

Aktivér Aktivitetsprotokollen på din Foundry-agent

Copilot Studio kommunikerer med en tilsluttet Foundry-agent ved hjælp af Activity-protokollen. Foundry-agenter har ikke denne protokol aktiveret som standard, så du skal aktivere den, før din primære agent kan udveksle beskeder med Foundry-agenten. Hvis Activity-protokollen ikke er aktiveret, kan du stadig tilføje forbindelsen, men kaldet til Foundry-agenten mislykkes.

Du kan aktivere Activity-protokollen på en af følgende måder:

  • Publicér Foundry-agenten til Microsoft 365 eller Microsoft Teams. Når du udgiver en prompt-agent til Microsoft 365 eller Teams, aktiveres Activity-protokollen og den påkrævede BotServiceRbac autorisationsordning automatisk. Vælg denne mulighed, hvis du allerede planlægger at publicere agenten til disse kanaler.

  • Aktiver det manuelt med et REST API-kald. Hvis du ikke udgiver agenten til Microsoft 365 eller Teams, så kald Foundry Agents - Opdater agent REST API for at tilføje protokollen activity og godkendelsesordningen BotServiceRbac til agenten.

Du kan få mere at vide om konfiguration og deling af din Foundry-agent i Konfigurér og del din Microsoft Foundry-agent.

Aktivér Activity-protokollen med et REST API-kald

Kald Foundry Agents - Opdater agent REST API'et. Erstat {{endpoint}}, {{agent_name}}, og {{token}} med endpoint, agentnavn og adgangstoken for dit Foundry-projekt.

Vigtig

Bevar responses og Entra i listerne. Når de fjernes, forhindres chat med agenten fra Foundry-portalen eller SDK'et.

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 sender videre til Foundry-agenten

Efter du har tilføjet Foundry-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 til Foundry-agenten, så orkestratoren præcist kan afgøre, hvornår anmodninger skal sendes til den. Undgå overlappende beskrivelser mellem tilknyttede agenter.

Test af delegering

Efter du tilføjer Foundry-agenten:

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

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

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

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

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

  • Sidst opdateret den