Tilføj en SDK til Microsoft 365-agenter-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 agent, der er bygget med SDK til Microsoft 365-agenter, 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.

En agent bygget med SDK til Microsoft 365-agenter eksponerer et beskedendepunkt, der taler Activity-protokollen. Du forbinder det ved at indtaste det endpoint direkte. I modsætning til en A2A-agent offentliggør en SDK-agent ikke et agentkort, så Copilot Studio kan ikke finde navnet og beskrivelsen for dig. Du angiver selv de oplysninger.

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 oprette forbindelse til en Microsoft Foundry-agent, skal du se Tilføj en Foundry-agent som en tilkoblet agent. Hvis du vil forbinde en fjernagent over Agent2Agent (A2A)-protokollen, se Tilføj en A2A-agent som en tilkoblet agent.

Forudsætninger

  • En agent oprettet med GitHub Copilot-harnesset som primær agent. Se Opret en agent (forhåndsversion).
  • En agent bygget med SDK til Microsoft 365-agenter, implementeret og tilgængelig fra Copilot Studio.
  • Agentens beskedendepunkt-URL, typisk https://<your-agent-host>/api/messages. URL'en skal være en absolut http eller https URL.
  • Godkendelsesoplysningerne, som SDK-agenten kræver, hvis der er nogen. Copilot Studio understøtter ingen godkendelse, API-nøgle og OAuth 2.0.

Tilføj en SDK til Microsoft 365-agenter-agent

Guiden fører dig gennem tre trin: Forbind til en SDK til Microsoft 365-agenter-agent, forbind til SDK til Microsoft 365-agenter-agenten, og derefter gennemgå og tilføje.

  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 skal du vælge Add, og vælg derefter Add SDK til Microsoft 365-agenter agent.

  6. På trinnet Connect to a SDK til Microsoft 365-agenter agent indtaster du agentens detaljer:

    • URL til meddelelsesendepunkt: aktivitetsprotokollens endepunkt for din SDK-agent, for eksempel https://agent.example.com/api/messages.
    • Navn: navnet, der vises for agentforfatteren, op til 30 tegn.
    • Beskrivelse: en klar beskrivelse af, hvornår denne SDK-agent skal bruges, mellem 30 og 1.000 tegn. 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. Lær mere om at skrive effektive metadata.

  7. Under Godkendelse skal du vælge, hvordan Copilot Studio godkender med SDK-agenten, og derefter udfylde detaljerne for den metode, du har valgt:

    Du kan ikke fortsætte, før autentificeringsoplysningerne er fuldførte.

  8. Vælg Næste.

  9. I trinnet Connect to the SDK til Microsoft 365-agenter agent opretter Copilot Studio forbindelsen til agenten. Vælg derefter forbindelsen, som denne agent bruger til at nå SDK-agenten:

    • Vælg en eksisterende forbindelse fra listen over tilgængelige forbindelser.
    • Hvis der ikke er nogen forbindelse, oprettes en ny forbindelse. Hvis SDK-agenten bruger API-nøgleautentificering, indtaster du API-nøgleværdien, når du opretter forbindelsen.

    Hvis connectoren ikke kan oprettes, vælg Prøv igen.

  10. Vælg Næste.

  11. På trinnet Gennemgå og tilføj gennemgår du navnet, beskrivelsen og URL'en til beskedendepunktet, og vælg derefter Tilføj til agent.

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

Hvis du går tilbage og ændrer beskedendepunktets URL på Connect to a SDK til Microsoft 365-agenter agent step, kasserer Copilot Studio den connector, der blev bygget ud fra den tidligere URL. Du skal vælge en tilslutning igen.

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.

Konfigurer godkendelse af API-nøgle

Når du vælger API-nøgle, skal du vælge, hvor Copilot Studio sender nøglen hen, ved at vælge en parametertype:

  • Header: nøglen sendes som en anmodningsheader. I headernavnet indtast navnet på den header, som SDK-agenten forventer, såsom x-api-key.
  • Forespørgselsstreng: nøglen sendes som en forespørgselsstrengsparameter. I Parameterlabel indtast navnet på den forespørgselsstreng-parameter, som SDK-agenten forventer.

Du indtaster selve API-nøgleværdien, når du opretter forbindelsen, ikke i dette trin. På den måde gemmes nøglen sammen med forbindelsen og er ikke synlig i agentkonfigurationen.

Konfigurer OAuth 2.0-godkendelse

Når du vælger OAuth 2.0, vælg en konfigurationstype:

  • Dynamisk: Copilot Studio registrerer en klient hos SDK-agentens identitetsudbyder for dig. Indtast autorisations-URL'en og token-URL'en.

  • Manual: brug en app-registrering, du allerede har oprettet ved hjælp af SDK-agentens identitetsudbyder. Angiv følgende værdier:

    • Klient-ID: klient-ID'et for din app-registrering.
    • Klienthemmelighed: klienthemmeligheden for din appregistrering.
    • Autorisations-URL: identitetsudbyderens autorisationsendepunkt.
    • Token URL: identitetsudbyderens token-endpoint.
    • Refresh token URL: det endepunkt, der bruges til at forny adgangstokens.
    • Scopes (valgfri): de scopes, der skal anmodes om, adskilt af mellemrum.

Brug Dynamic, når SDK-agentens identitetsudbyder understøtter dynamisk klientregistrering. Brug Manual , når du skal kontrollere app-registreringen, for eksempel når din identitetsudbyder kræver forudregistrerede omdirigerings-URI'er eller samtykke.

Hvordan orkestratoren dirigerer til SDK-agenten

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

Test af delegering

Efter du har tilføjet SDK-agenten:

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

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

  3. Kontroller, at svaret kommer fra SDK-agenten og er passende.

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

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

Fejlsøg forbindelsen

Problem Hvad skal kontrolleres?
URL'en til meddelelsesendepunktet afvises URL'en skal være en absolut, http eller https URL, der peger på agentens Activity-protokol-endpoint, såsom https://agent.example.com/api/messages.
Næste forbliver utilgængelig på trinnet Opret forbindelse Navn, beskrivelse og URL'en til beskedendpointet er alle påkrævet, og beskrivelsen skal være mindst 30 tegn. Ufuldstændige godkendelsesoplysninger forhindrer også dette trin.
Oprettelsen af connectoren mislykkedes Vælg Prøv igen. Hvis det fortsætter med at fejle, så tjek at URL'en til beskedendepunktet er korrekt, og at dit miljø tillader brugerdefinerede connectorer.
Den forbindelse, du oprettede, virker ikke længere, efter du redigerede guiden Ændring af URL'en til beskedendepunktet kasserer connectoren, der er bygget fra den forrige URL. Vælg en forbindelse igen.
  • Sidst opdateret den