Koble til en Microsoft Foundry-agent (forhåndsversjon)

Merknad

Denne artikkelen beskriver funksjoner som brukes i agenter eller agentstrømmer drevet av standardledningsnettet.

[Denne artikkelen er forhåndsutgitt dokumentasjon og kan endres.]

Du kan koble til en Microsoft Foundry Agent til den tilpassede agenten din, slik at den kan kalle denne agenten for å svare på en bruker eller en utløser.

Viktig

Denne artikkelen inneholder dokumentasjon for Microsoft Copilot Studio-forhåndsversjonen og kan bli endret.

Evalueringsfunksjonalitet er ikke ment for produksjonsbruk og kan ha begrensninger. Disse funksjonene er tilgjengelige før en offisielle utgivelsen slik at du kan få tidlig tilgang og gi tilbakemeldinger.

Hvis du skal bygge en produksjonsklar agent, kan du se Oversikt over Microsoft Copilot Studio.

Forutsetninger

Før du kobler en Microsoft Foundry-agent til Copilot Studio, må Foundry-agenten ha Activity-protokollens endepunkt aktivert. En nyopprettet Foundry-agent eksponerer som standard kun Responses - og A2A-protokollendepunktene . Hvis aktivitetsendepunktet ikke er aktivert, feiler tilkoblingen til Copilot Studio under kjøring med en 400-feil. Les mer i Aktiver innkommende A2A på en Foundry-agent.

Du kan for øyeblikket aktivere Activity-endepunktet kun programmessig, ved å bruke REST API eller Python SDK. Det finnes ikke noe alternativ for å aktivere det fra Microsoft Foundry-portalen. Lær mer om aktiveringsprosessen i Configure and share your agent.

Etter at du har aktivert Aktivitetsendepunktet, fortsetter Foundry-portalens Endepunktsseksjon for agenten å vise kun Svar og A2A. Denne utelatelsen av brukergrensesnittet er forventet og betyr ikke at endringen mislyktes. Tilkoblingen til Copilot Studio fungerer etter at oppdateringen er installert.

Koble deg til en Microsoft Foundry-agent

  1. Gå til Agenter-siden for hovedagenten, og velg Legg til en agent.

  2. Under Koble til en ekstern agent, velg Microsoft Foundry fra de tilgjengelige agenttypene.

  3. Velg ønsket tilkobling fra listen over tilgjengelige tilkoblinger, eller opprett en ny tilkobling mellom Microsoft Foundry og din Copilot Studio-agent. For å opprette en ny tilkobling må du oppgi URL-adressen for Foundry-prosjektets endepunkt.

    Merknad

    Når du kobler til Microsoft Foundry-agenter fra Copilot Studio, kan du bare koble til agenter som er opprettet i den nye Microsoft Foundry-portalen. Å koble til en agent opprettet i forrige portal fører til en feil som indikerer 404 - Version not found.

  4. Når tilkoblingen er opprettet, velger du Neste.

  5. Skriv inn et passende Navn og Beskrivelse for SDK-agenten din. Beskrivelsen bør beskrive formålet med Microsoft Foundry-agenten din, slik at hovedagenten din kan forstå når den skal brukes. For mer informasjon, se å skrive effektive metadata.

  6. Angi Agent-ID for Microsoft Foundry-agenten du vil koble til.

  7. Juster beskrivelsen (om nødvendig) for å gjøre den mer kontekstuell for hovedagenten. For eksempel, gjør beskrivelsen mer spesifikk hvis du har andre verktøy eller agenter der beskrivelsene kan overlappe. Oppdater beskrivelsen for å sikre at Copilot Studio kan forstå når denne agenten skal aktiveres.

  8. Velg Legg til Agent.

  9. Når agenten din er opprettet, kan du teste den umiddelbart. Hvis du trenger å justere Agent-ID senere, kan du gjøre det fra detaljsiden ved å velge agenten din fra Agenter-listen.

Merknad

  • Hvis ditt første testanrop til den tilkoblede Foundry-agenten feiler med en feil som ligner på "Koblingen 'Azure AI Foundry Agent Service' returnerte en HTTP-feil med kode 400. Indre feil: Agentens <name> endepunkt støtter ikke aktivitet. Vennligst oppdater agentendepunktet for å støtte denne protokollen.», Foundry-agenten har ikke Aktivitetsprotokoll-endepunktet aktivert. Se Forutsetninger i denne artikkelen, og aktiver deretter Aktivitetsendepunktet ved å følge Configure and share your agent i Microsoft Foundry-dokumentasjonen.

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