Opret forbindelse til en Microsoft Foundry-agent (forhåndsversion)

Bemærk

Denne artikel beskriver funktioner, der anvendes i agenter eller agentstrømme, drevet af standardledningsnettet.

[Denne artikel er foreløbig dokumentation og kan ændres.]

Du kan oprette forbindelse mellem en Microsoft Foundry-agent og din brugerdefinerede agent, så den kan kalde denne agent som svar på en bruger eller en udløser.

Vigtigt!

Denne artikel indeholder dokumentation til prøveversionen af Microsoft Copilot Studio. Der kan forekomme ændringer.

Prøveversionsfunktioner er ikke beregnet til produktionsbrug og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så du kan få tidlig adgang og give feedback.

Hvis du skal bygge en produktionsklar agent, kan du se Oversigt over Microsoft Copilot Studio.

Forudsætninger

Før du forbinder en Microsoft Foundry-agent til Copilot Studio, skal Foundry-agenten have Activity-protokollens endpoint aktiveret. En nyoprettet Foundry-agent eksponerer som standard kun Responses og A2A-protokolendepunkterne . Hvis Activity-endpointet ikke er aktiveret, fejler forbindelsen til Copilot Studio ved kørsel med en 400-fejl. Lær mere i Aktiver indkommende A2A på en Foundry-agent.

Du kan i øjeblikket kun aktivere Activity-endpointet programmæssigt ved at bruge REST API'en eller Python SDK. Der er ingen mulighed for at aktivere det via Microsoft Foundry-portalen. Lær mere om aktiveringsproceduren i Configure and share your agent.

Efter du har aktiveret Aktivitetsendepunktet, fortsætter Foundry-portalens Endpoints-sektion for agenten med kun at vise Svar og A2A. Denne UI-udeladelse er forventet og betyder ikke, at ændringen mislykkedes. Forbindelsen til Copilot Studio virker efter opdateringen er blevet installeret.

Opret forbindelse til en Microsoft Foundry-agent

  1. Gå til siden Agenter for din hovedagent, og vælg Tilføj en agent.

  2. Under Opret forbindelse til en ekstern agent skal du vælge Microsoft Foundry fra de tilgængelige agenttyper.

  3. Vælg den ønskede forbindelse på listen over tilgængelige forbindelser, eller opret en ny forbindelse mellem Microsoft Foundry og din Copilot Studio-agent. Hvis du vil oprette en ny forbindelse, skal du angive URL-adressen til slutpunktet for Microsoft Foundry-projektet.

    Bemærk

    Når du opretter forbindelse til Microsoft Foundry-agenter fra Copilot Studio, kan du kun oprette forbindelse til agenter, der er oprettet på den nye Microsoft Foundry-portal. Forbindelse til en agent oprettet i den forrige portal fører til en fejl, der indikerer 404 - Version not found.

  4. Når forbindelsen er oprettet, skal du vælge Næste.

  5. Angiv et passende Navn og en beskrivelse til SDK-agenten. Beskrivelsen skal beskrive formålet med Microsoft Foundry-agenten, så din hovedagent kan forstå, hvornår den skal bruges. Du kan få flere oplysninger under skrivning af effektive metadata.

  6. Angiv agent-id'et for den Microsoft Foundry-agent, du vil oprette forbindelse til.

  7. Juster beskrivelsen (hvis nødvendigt) for at gøre den mere kontekstuel for hovedagenten. Du kan f.eks. gøre beskrivelsen mere specifik, hvis du har andre værktøjer eller agenter, hvor beskrivelserne kan overlappe hinanden. Opdater beskrivelsen for at sikre, at Copilot Studio kan forstå, hvornår denne agent skal aktiveres.

  8. Vælg Tilføj agent.

  9. Når din agent er oprettet, kan du teste din agent med det samme. Hvis du har brug for at justere agent-id'et senere, kan du gøre det på siden med detaljer ved at vælge din agent på listen Agenter.

Bemærk

  • Hvis dit første testkald til den tilsluttede Foundry-agent fejler med en fejl svarende til "Connectoren 'Azure AI Foundry Agent Service' returnerede en HTTP-fejl med kode 400. Indre fejl: Agentens <name> endpoint understøtter ikke aktivitet. Opdater venligst agentens endpoint til at understøtte denne protokol.", Foundry-agenten har ikke Activity-protokollens endpoint aktiveret. Se Forudsætninger i denne artikel, og aktivér derefter Aktivitetsendepunktet ved at følge Konfigurér og del din agent i Microsoft Foundry-dokumentationen.

  • 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.
  • Last updated on