Del via

Legge til verktøy i egendefinerte agenter

Verktøy er byggesteinene som gjør det mulig for agenten å samhandle med eksterne systemer. Verktøy utvider funksjonaliteten til agenten din, slik at den kan utføre ulike handlinger som svar på brukerforespørsler eller autonome utløsere. Hvert verktøy representerer en bestemt funksjon som agenten din kan utføre. Du kan for eksempel utstyre agenten med verktøy som gjør ting som:

  • Sende e-postmeldinger ved hjelp av Office 365 Outlook-koblingen
  • Kontroller gjeldende værforhold og prognoser
  • Lese og skrive data fra Dataverse
  • Lese og legge inn meldinger i Teams

Mekanismer for å legge til verktøy

Du kan utvide funksjonene til den egendefinerte agenten ved å legge til ett eller flere verktøy. Agenten din kan bruke verktøy til å svare brukere automatisk ved hjelp av generativ orkestrering. Du kan også kalle på verktøy eksplisitt innenfor et emne.

Med generativ orkestrering (aktiv som standard) kan agenten din automatisk velge det mest aktuelle verktøyet eller emnet, eller søke på tvers av kunnskap, for å svare en bruker. Denne orkestreringsmodusen oppretter en mer dynamisk og intelligent samtaleopplevelse.

I klassisk modus (generativ orkestrering slått av), kan en agent bare bruke emner til å svare brukeren. Du kan imidlertid fortsatt utforme agenten din for å kalle verktøy eksplisitt innenfor emner.

Det finnes flere mekanismer tilgjengelig for deg for å legge til verktøy i agenten:

  • Connector: Koble til proprietære API-er og tjenester ved å bruke Power Platform Connectors for å hente inn data eller utføre handlinger.
    • Forhåndsbygd kobling: Velg mellom et utvalg forhåndsinnstilte tilkoblinger til tusenvis av populære API-er fra både Microsoft- og ikke-Microsoft-tjenester.
    • Egendefinert kobling: Definer en tilkobling til en egendefinert tjeneste eller et system for å aktivere egendefinerte verktøyalternativer ved hjelp av Power Platform Connectors. Koblingen trenger visnings- og delingstillatelser for organisasjonen for at agenten skal kunne bruke koblingen.
  • Agentflyt: Definer en agentflyt, inkludert én eller flere handlinger som skal utføres.
  • Prompt: Enkelt runde-modellbasert prompt som kan referere til kunnskapen du gir og generere kode for å analysere data.
  • REST API: Definer en tilkobling til et REST API, og velg ett eller flere API-endepunkter og metoder som skal legges til som verktøy.
  • Model Context Protocol: Koble til en MCP-server for å få tilgang til verktøy og ressurser.
  • Datamaskinbruk: Lar agenten din interagere med ethvert system som har grafisk brukergrensesnitt, for nettsider og skrivebordsapper, ved å velge knapper, velge menyer og skrive inn tekst i felt på skjermen.

Det finnes to andre mekanismer du kan bruke til å legge til verktøylignende virkemåte for agenten:

  • Ferdigheter: Beholder for et sett med relaterte verktøy.
  • Klientverktøy: Send en hendelsesaktivitet til klienten slik at klienten utfører en handling og returnerer et svar.

Hvis du vil ha mer informasjon om ferdigheter og klientverktøy, kan du se koblingene i delen Relatert innhold .

Opprette og legge til et nytt verktøy på agentnivå

Oppretting av nye verktøy direkte i Copilot Studio effektiviserer utviklingsprosessen og sikrer riktig integrasjon med agenten din. Verktøy som legges til en agent, er tilgjengelige for automatisk orkestrering gjennom hele agentens samtaler.

  1. Åpne agenten din ved å velge Agenter i venstre navigasjonsrute og velge agenten fra listen.

  2. Gå til Verktøy-siden for agenten.

  3. Velg Legg til et verktøy.

  4. Velg Nytt verktøy i ruten Legg til verktøy.

  5. Velg hvilken type verktøy du vil legge til fra listen som vises:

    • Omgående
    • Agentstrøm
    • Datamaskinbruk
    • Egendefinert kobling
    • Modellkontekstprotokoll
    • REST- API

    Skjermbilde som viser valg for type nytt verktøy som skal legges til agenten

  6. Utfør konfigurasjonstrinnene som er spesifikke for hvilken type verktøy du valgte. Hvis du for eksempel velger Spør, må du utføre følgende trinn:

    • Definer ledetekstmalen og instruksjonene
    • Angi inndataparametere
    • Konfigurer kunnskapskilder
    • Angi svarformat og begrensninger

  7. Velg Lagre eller Publiser, etter behov, for å lage det nye verktøyet.

  8. Velg Legg til og konfigurer. Verktøyet legges til agenten din. Konfigurasjonssiden for verktøyet ditt vises. Du kan se og gjøre endringer i verktøykonfigurasjonen din her.

Du kan se det nye verktøyet på Verktøy-siden for agenten.

Vise og gjøre endringer i verktøykonfigurasjonen

Du kan når som helst vise og redigere konfigurasjonen av verktøyet: Gå til Verktøy-siden for agenten, og velg verktøyet fra listen over verktøy.

Konfigurasjonssiden for verktøyet ditt åpnes. Detaljene vises i tre inndelinger:

  • Details
  • Inndata
  • Fullføring

For MCP-servere koblet som agentverktøy, er konfigurasjonssiden annerledes enn for andre verktøytyper. Detaljer-delen er lik, men i stedet for Inndata og fullføring er det Verktøy og Ressurser-seksjoner med informasjon om tilgjengelige verktøy og ressurser for MCP-serveren. Hvis du vil ha mer informasjon, kan du se Vise verktøy og ressurser på en eksisterende MCP-server.

Details

Med Detaljer-delen kan du konfigurere grunnleggende detaljer om verktøyet.

Her kan du vise og oppdatere:

  • Navn: Navnet på verktøyet. Dette navnet vises i listen over verktøy for agenten din. Velg et navn som tydelig angir verktøyets funksjon.

  • Beskrivelse: En beskrivelse av verktøyet. Generativ orkestrering er avhengig av denne beskrivelsen for å avgjøre når agenten skal bruke verktøyet. Skriv klare, spesifikke beskrivelser, inkludert hva verktøyet gjør og når det skal brukes.

  • Flere detaljer:

    • Tillat at agenten bestemmer dynamisk når verktøyet skal brukes: Når dette alternativet er valgt, kan agenten bruke generativ orkestrering til å bestemme når verktøyet skal brukes. Hvis dette alternativet ikke er valgt, bruker agenten bare verktøyet når det eksplisitt kalles fra et emne. (Dette alternativet velges som standard når generativ orkestrering er aktivert.)
    • Spør sluttbrukeren før du kjører: I chatteopplevelsen for sluttbrukeren ber du agenten om bekreftelse før du kjører verktøyet. Dette alternativet er satt til Nei som standard.
    • Godkjenning: Velg om du vil bruke brukerens (sluttbruker) eller oppretterens legitimasjon (oppretter) for verktøyet. Brukergodkjenning gjelder som standard.
    • Beskrivelse: Du kan også legge til en beskrivelse av verktøyet agenten viser til brukeren når den vil kjøre verktøyet. Denne beskrivelsen gir brukeren beskjed om hva de blir bedt om å godkjenne.

Inndata

Her kan du vise og konfigurere inndataene for verktøyet. Inndataene brukes til å samle inn informasjon fra brukeren for å fylle ut de nødvendige inndataene for verktøyet. Informasjonen vises som en tabell, én linje for hver inndata.

Fyll ved hjelp av kolonneverdien for hver inndata er som standard satt til Dynamisk fyll med kunstig intelligens. Agenten prøver å trekke ut verdien fra den tilgjengelige konteksten, for eksempel fra brukerens melding. Hvis ingen passende verdi blir funnet, genererer den et spørsmål for å spørre brukeren om en verdi. Velg Tilpass for å få tilgang til flere finjusterte tilpassinger for inndatasamling og utfylling:

  • Visningsnavn og beskrivelse: Slik vises inndataene for brukeren.
  • Identifiser som: Hvordan brukerens svar tolkes, for eksempel som tekststreng eller tilordnet til en forhåndsdefinert enhet.
  • Prøv logikken på nytt: Hvis agenten ikke identifiserer en enhet i brukerens setning, kan den stille spørsmålet på nytt.
  • Inndatavalidering: Konfigurer ekstra valideringsvirkemåte på brukerens inndata utover standardinnstillingen for enhetstypen.

Du kan også velge å overstyre en inndata med en eksplisitt verdi i stedet for å la agenten trekke den ut. For å sette en overstyring, still Fyll ved hjelp av til egendefinert verdi, og skriv inn en verdi, velg en variabel, eller bruk en Power Fx-formel. Hvis en inndata overstyres, ber ikke agenten brukeren om en verdi.

Fullføring

Her kan du velge hva du vil skal skje når verktøyet kjøres.

Du kan få agenten til å automatisk generere et kontekstavhengig svar for en bruker, basert på spørringen og resultatet av verktøyet.

Alternativt kan du velge å redigere et bestemt, formatert svar som verktøyet skal returnere. Du kan sette inn referanser til utdatavariabler fra verktøyet ved hjelp av variabelvelgeren. Du kan også bruke Power Fx-formler til å formatere svaret.

Velg ett av de forskjellige alternativene for hvordan verktøyet skal reagere på brukeren etter at verktøyet er kjørt, under Etter kjøring:

  • Ikke svar (standard): Agenten inkorporerer verktøyutdataene i svaret
  • Skriv svaret med generativ KUNSTIG INTELLIGENS: La AI lage et kontekstavhengig svar ved hjelp av verktøyutdataene
  • Send bestemt svar: Opprett et malsvar med variabel innsetting
  • Sende et adaptivt kort: Opprette rike, interaktive svar med knapper og handlinger

Du kan også konfigurere hvilke utdatavariabler som skal gjøres tilgjengelige for agenten og andre verktøy.

Verktøyutvalg og inndatasamling

Når du definerer et verktøy i Copilot Studio, gir du også informasjon som beskriver formålet. Denne informasjonen lar agenten identifisere når verktøyet skal brukes. Verktøybeskrivelsen hjelper også orkestratoren med å bruke generativ AI til å generere spørsmål, etter behov, for å samle inn inndata. Agenten din kan bruke spørsmål for å samle informasjon for å fylle inn de innspillene som trengs for å bruke verktøyet. Derfor trenger du ikke å redigere spørsmålsnoder manuelt for å samle alle nødvendige inndata, for eksempel inndata i en flyt. Agentorkestratoren håndterer inndatainnsamling for deg under kjøring.

Agenten vurderer flere faktorer for å bestemme valg av verktøy:

  • Verktøyets navn og beskrivelse
  • Gjeldende samtalekontekst
  • Brukerhensikt avledet fra meldingen
  • Tilgjengelige inndata og utdata
  • Forrige verktøybruk i samtalen

Når du bruker generativ modus, returnerer verktøy som standard informasjonen tilbake til agenten. Med verktøysvaret kan agenten generere et kontekstavhengig svar på brukerens spørring. Alternativt kan du be verktøyet om alltid å svare umiddelbart, enten generere en melding eller redigere en eksplisitt melding.

Tips

Når du bruker genererte spørsmål fra et verktøy, informer brukerne dine om at AI har generert deler av samtalen.

Du kan for eksempel legge til en ekstra melding i samtalestartsystememnet. Dette emnet bestemmer meldingen som vises til brukerne dine når en ny samtale starter.

Kalle opp et eksisterende verktøy innenfor et emne

Du kan utløse et verktøy eksplisitt fra et emne. Avhengig av brukstilfellet kan du bruke verktøyet som en del av et bredere emne, som bruker flere noder. Eller, som i væreksemplet, kan det være alt du trenger å legge til en node i et emne.

Slik ringer du et verktøy fra et emne:

  1. I Copilot Studio går du til siden Emner for agenten du vil redigere.

  2. Opprett et nytt emne, og gi det et navn, for eksempel Få værmelding.

  3. Legg til passende utløseruttrykk. Hvis du vil fortsette med det samme væreksemplet fra forrige trinn, kan utløseruttrykk omfatte:

    • blir det regn
    • dagens værmelding
    • få værmelding
    • hvordan er været

  4. Velg Legg til node (+), og velg deretter Legg til et verktøy. Velg verktøyet fra de tilgjengelige verktøyene. Det finnes tre faner som viser ulike verktøytyper:

    • Grunnleggende verktøy
    • Kobling
    • Verktøy

    Handlingsnoden er nå lagt til i emnet.

  5. Velg Lagre.

MCP-koblingsinformasjon

For MCP-kobling kan du vise navnene og beskrivelsene av MCP-verktøyene og -ressursene som gjøres tilgjengelige av MCP-koblingen. Informasjon om verktøyene og ressursene vises i en tabell, én linje for hvert verktøy.

Godkjenningshensyn for verktøy

Noen verktøy krever godkjenning for å fungere riktig, for eksempel dynamisk ledetekst eller andre som kaller et dataverst API. Riktig godkjenningskonfigurasjon sikrer sikkerhet samtidig som du opprettholder en jevn brukeropplevelse.

Verktøy kjøres alltid i agentens kjøretid i brukerkonteksten og kan ikke kjøres med mindre godkjenning er aktivert. To typer godkjenningsmetoder støttes:

  • Brukergodkjenning: Agenten bruker brukerens legitimasjon til å godkjenne med tjenesten. Denne metoden sikrer at brukerne bare får tilgang til data de har tillatelse til å se.
  • Forfatterautentisering for Copilot: Agenten bruker forfatterens legitimasjon for å autentisere seg med tjenesten. Bruk denne godkjenningsmodusen for delte ressurser eller når brukere ikke trenger individuell tilgang.

Test verktøyet

Med generativ orkestrering velger orchestratoren verktøyet når det anser det som relevant for en brukerspørring.

Du kan også kalle et eksisterende verktøy fra et emne.

Slå et verktøy på eller av i agenten din

Du kan aktivere eller deaktivere et verktøy for agenten fra verktøykonfigurasjonssiden. Å slå av et verktøy blokkerer agenten fra å bruke verktøyet, men verktøyet er fortsatt koblet til agenten og kan slås på igjen senere. Når du legger til et verktøy i en agent, er det aktivert som standard.

Slik slår du av et verktøy i en agent:

  1. Gå til agenten din, og velg Verktøy-siden for agenten din.
  2. Velg verktøyet for å gå til verktøykonfigurasjonssiden.
  3. Øverst på konfigurasjonssiden slår du av verktøyet ved å bruke Aktivert-bryteren.
  4. Velg Lagre for å ta i bruk endringen.

Verktøyet vises fortsatt på listen over agentverktøy, men er ikke lenger aktivert.

Slette et verktøy fra agenten din

Å slå av et verktøy blokkerer verktøyet fra bruk, men gir deg også fleksibiliteten til å slå det på igjen senere. Du kan også fjerne et verktøy mer permanent fra agenten din. Slik sletter du et verktøy fra agenten din:

  1. Gå til agenten din, og velg Verktøy-siden for agenten din.
  2. Finn verktøyet på listen over verktøy og hold musepekeren over verktøynavnet. Velg ... (Flere alternativer).
  3. Velg Slett. Et bekreftelsesvindu vises.
  4. Velg Slett for å fjerne verktøyet.

Verktøyet forsvinner fra listen over agentverktøy.

Note

Du kan bare slette verktøy fra siden for agentverktøy. Du kan ikke slette verktøy fra hovedsiden for Copilot Studio Tools .

Relatert innhold

  • Last updated on