Legg til verktøy i egendefinerte agenter

Verktøy er byggeklosser som lar agenten din samhandle med eksterne systemer. Verktøyene utvider hva agenten din kan gjøre, og agenten din kan utføre ulike handlinger som svar på brukerforespørsler eller autonome triggere. Hvert verktøy representerer en bestemt funksjon som agenten din kan utføre. For eksempel kan du utstyre agenten din med verktøy som utfører oppgaver som:

• Send e-poster ved å bruke Office 365 Outlook-connectoren
• Sjekk gjeldende værforhold og værmeldinger
• Les og skriv data fra Dataverse
• Les og legg ut meldinger til Teams

Mekanismer for å legge til verktøy til agenter

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å bruke verktøy eksplisitt fra et tema.

Ved å bruke generativ orkestrering (aktiv som standard), kan agenten din automatisk velge det mest passende verktøyet eller temaet, eller søke på tvers av kunnskap, for å svare en bruker. Denne orkestreringsmodusen skaper 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.

Du kan bruke følgende mekanismer for å legge til verktøy i agenten din:

• 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 fra et utvalg av forhåndsinnstilte tilkoblinger til tusenvis av populære API-er fra både Microsoft- og ikke-Microsoft-tjenester.
  • Custom connector: Definer en tilkobling til en tilpasset tjeneste eller system for å aktivere tilpassede verktøyvalg ved å bruke 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.
• Spørsmål: Modellbasert ledetekst på én runde som kan referere til kunnskap du oppgir 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.
• Modellkontekstprotokoll: Koble til en MCP-server for å få tilgang til verktøy og ressurser.
• Datamaskinbruk: Lar agenten din samhandle med ethvert system som har et grafisk brukergrensesnitt, for nettsteder og skrivebordsapper, velge knapper, velge menyer og skrive inn tekst i felt på skjermen.

Du kan også bruke følgende mekanismer for å legge til verktøylignende atferd til agenten din:

• Azure Bot Service ferdigheter: Beholder for et sett med relaterte verktøy gjort tilgjengelig gjennom Azure Bot Service.
• Klientverktøy: Send en hendelsesaktivitet til klienten slik at klienten utfører en handling og returnerer et svar.

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 typen verktøy du vil legge til fra listen:

   • Agentflyt
   • Omgående
   • Modellkontekstprotokoll
   • Datamaskinbruk

   For å vise hele listen, velg Se alle. Flere alternativer dukker opp:

   • Rest-API
   • Egendefinert kobling

   Se alle endres til Se mindre.

   

   Note

   Hvis organisasjonen din har blokkert et verktøy på grunn av datapolicyer, kan du ikke velge det. Lær mer i Verktøy som er blokkert av organisasjonens retningslinjer.

5. Utfør konfigurasjonstrinnene som er spesifikke for hvilken type verktøy du valgte. For eksempel, hvis du velger Prompt, utfør følgende steg:

   • Angi instruksjonene for ledeteksten
   • Velg en modell
   • Spesifiser inndataparametere (ved å velge + Legg til innhold)

   Du kan også få hjelp ved å skrive i feltet Prompt assistant .

   Som et alternativ kan du bruke en forhåndsdefinert mal for å lage en prompt ved å velge promptmal.

6. Velg Lagre for å opprette det nye verktøyet.

7. Velg Legg til og konfigurer. Verktøyet er lagt til agenten din. Konfigurasjonssiden for verktøyet ditt vises. Se og gjør endringer i verktøykonfigurasjonen din her.

Ditt nye verktøy vises på Verktøy-siden for agenten.

Verktøy blokkert av organisasjonens retningslinjer

Organisasjonen din kan bruke styringsretningslinjer for å begrense hvilke verktøy og koblinger som er tilgjengelige i Copilot Studio.

Når en datapolicy blokkerer et verktøy, vises verktøyet deaktivert i Legg-til-verktøypanelet , og du kan ikke velge det. Velg ved siden av det deaktiverte verktøyet for å se hvorfor verktøyet ikke er tilgjengelig.

Meldingen identifiserer policybegrensningen som hindrer at verktøyet kan brukes. Hvis du trenger tilgang til et blokkert verktøy, kontakt administratoren din.

Finn ut mer i Konfigurer datapolicyer for agenter.

Vis og gjør endringer i verktøykonfigurasjonen din

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

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

• Detaljer
• Inndata
• Fullføring

For MCP-servere som er koblet til som agentverktøy, er konfigurasjonssiden forskjellig fra andre verktøytyper. Detaljer-seksjonen er lik, men i stedet for Innganger og Fullføring, det finnes Verktøy og Ressurser-seksjonene med informasjon om tilgjengelige verktøy og ressurser for MCP-serveren. For mer informasjon, se Vis verktøy og ressurser i en eksisterende MCP-server.

Detaljer

Bruk Detaljer-seksjonen for å konfigurere grunnleggende detaljer om verktøyet ditt.

Se og oppdater følgende informasjon:

• 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 din skal bruke verktøyet. Skriv klare, spesifikke beskrivelser, inkludert hva verktøyet gjør og når det skal brukes.

• Flere detaljer:

  • La agenten bestemme dynamisk når verktøyet skal brukes: Når du velger dette alternativet, kan agenten bruke generativ orkestrering for å bestemme når verktøyet skal brukes. Hvis du ikke velger dette alternativet, 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.
  • Autentisering: Velg om du vil bruke brukerens (Sluttbruker) eller produsentens (Levert av produsenten) legitimasjon for verktøyet. Brukergodkjenning gjelder som standard.
  • Beskrivelse: Eventuelt legg til en beskrivelse av verktøyet agenten viser brukeren når den ønsker å kjøre verktøyet. Denne beskrivelsen lar brukeren vite hva de blir bedt om å autentisere.

Inndata

Se og konfigurer inputene for verktøyet ditt. Bruk inputene til å samle informasjon fra brukeren for å fylle ut de nødvendige inputene for verktøyet. Informasjonen vises som en tabell, med én linje for hver input.

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 agenten ikke finner en passende verdi, genererer den et spørsmål til 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 input 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 du overstyrer en input, ber ikke agenten brukeren om en verdi.

Fullføring

Velg hva du vil skal skje når verktøyet er ferdig å kjøre.

Du kan la agenten automatisk generere et kontekstuelt svar for en bruker, basert på spørringen deres og resultatet av verktøyet.

Alternativt kan du velge å skrive et spesifikt, formatert svar som verktøyet ditt skal returnere. Bruk variabelpickeren til å sette inn referanser til utdatavariabler fra verktøyet. Du kan også bruke Power Fx-formler til å formatere svaret.

Under Etter kjøring, velg hvordan verktøyet skal svare brukeren etter at verktøyet har kjørt:

• Ikke svar (standard): Agenten inkorporerer verktøyets utdata i sitt svar.
• Skriv svaret med generativ AI: AI lager et kontekstuelt svar ved hjelp av verktøyets utdata.
• Send spesifikt svar: Lag et malbasert svar med variabelinnsetting.
• Send et adaptivt kort: Lag rike, interaktive svar med knapper og handlinger.

Konfigurer hvilke utdatavariabler som skal gjøres tilgjengelige for agenten og andre verktøy.

Verktøyvalg og innsamling av inndata

Når du definerer et verktøy i Copilot Studio, gir du også informasjon som beskriver formålet. Denne informasjonen hjelper agenten med å identifisere når verktøyet skal brukes. Verktøybeskrivelsen hjelper også orkestratoren med å bruke generativ KI til å generere spørsmål etter behov for å samle inn innspill. Agenten din kan bruke spørsmål til å samle inn informasjon for å fylle ut inndataene 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 innsamling av inndata for deg under kjøretid.

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

• Verktøyets navn og beskrivelse
• Den gjeldende diskusjonskonteksten
• Brukerintensjon utledet fra budskapet deres
• Tilgjengelige inndata og utdata
• Forrige verktøybruk i samtalen

Når man bruker generativ modus, returnerer verktøyene som standard informasjonen sin tilbake til agenten. Med verktøysvaret kan agenten generere et kontekstuelt svar på brukerens forespørsel. Alternativt kan du instruere verktøyet ditt til alltid å svare umiddelbart, enten ved å generere en melding eller skrive en eksplisitt melding.

Kalle opp et eksisterende verktøy innenfor et emne

Du kan utløse et verktøy eksplisitt fra et emne. Avhengig av bruksområdet ditt, kan du bruke verktøyet ditt som en del av et bredere tema som bruker flere noder. Eller, som i det følgende eksempelet, kan det å legge til en enkelt handlingsnode (verktøy) i et emne være alt du trenger.

Slik kaller du opp et verktøy fra et emne:

1. Gå til Topics-siden for agenten du vil redigere, i Copilot Studio.

2. Lag et nytt tema, og gi det et navn, for eksempel Få været.

3. Legg til passende Utløseruttrykk. For å fortsette med det samme væreksemplet fra forrige trinn, kan utløseruttrykk inkludere:

   • 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.

5. Velg verktøyet blant de tilgjengelige verktøyene. Tre faner viser ulike typer verktøy:

   • Grunnleggende verktøy
   • Connector
   • Verktøy

   Handlingsnoden er nå lagt til i emnet.

6. Velg Lagre.

MCP-koblingsinformasjon

For MCP-kontakten kan du se navn og beskrivelser av MCP-verktøyene og ressursene som MCP-kontakten gjør tilgjengelig. Informasjonen for verktøyene og ressursene vises i en tabell, med én linje for hvert verktøy.

Godkjenningshensyn for verktøy

Noen verktøy krever autentisering for å fungere korrekt, som Dynamic Prompt eller andre verktøy som kaller et Dataverse-API. Riktig autentiseringskonfigurasjon sikrer sikkerhet samtidig som det opprettholder en problemfri brukeropplevelse.

Agenten kjører verktøy i sin kjøretid i brukerkonteksten. Du kan ikke kjøre verktøy med mindre autentisering er aktivert. Agenten støtter to typer autentiseringsmetoder:

• Sluttbrukerlegitimasjon: Agenten bruker brukerens legitimasjon for å autentisere seg med tjenesten. Denne metoden sikrer at brukerne bare får tilgang til data de har tillatelse til å se.
• Leverandørens legitimasjon: Agenten bruker forfatterens legitimasjon til å autentisere seg mot tjenesten. Bruk denne autentiseringsmodusen for delte ressurser eller når brukere ikke trenger individuell tilgang.

Test verktøyet

Ved å bruke generativ orkestrering velger orkestratoren verktøyet ditt når den anser det som relevant for en brukerforespørsel.

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

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

Du kan slå et verktøy av eller på for agenten din fra verktøykonfigurasjonssiden. Hvis du slår av et verktøy, blokkeres 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 verktøyet aktivert som standard.

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

1. Gå til megleren 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.

Slett et verktøy fra agenten din

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

1. Gå til megleren din og velg Verktøy-siden for agenten din.
2. Finn verktøyet på verktøylisten og hold musepekeren over verktøynavnet. Velg de tre prikkene (...).
3. Velg Slett. Et bekreftelsesvindu vises.
4. Velg Slett for å fjerne verktøyet.

Verktøyet forsvinner fra listen over agentverktøy.

Begrensninger på verktøy i agenter

• Når du bruker generativ orkestrering, støtter orkestratoren opptil 128 verktøy per agent. For best ytelse og resultater, begrens antall verktøy i agenten til 25 til 30.
• Når du bruker multi-agent orkestrering med barneagenter, har hver barneagent sin egen orkestrering og kan administrere sitt eget sett på opptil 128 verktøy.