Bruk handlinger med egendefinerte kopiloter (forhåndsversjon)

Du kan utvide funksjonene i kopiloten ved å legge til en eller flere handlinger. Handlinger brukes av kopiloten til å gi brukere svar automatisk ved hjelp av generative handlinger, eller du kan kalle dem opp eksplisitt fra et emne.

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

Kjernehandlingstyper

Hvis du aktiverer generativ modus, kan kopiloten automatisk velge handlingen eller emnet som er mest aktuelt, for å gi en bruker svar ved kjøretid.

I klassisk modus kan en kopilot bare bruke emner til å gi brukeren svar. Du kan imidlertid likevel utforme kopiloten slik at den kaller opp handlinger eksplisitt i emner.

Handlinger er basert på en av følgende kjernehandlingstyper:

• Forhåndsbygd tilkoblingshandling
• Egendefinert tilkoblingshandling
• Power Automate-skyflyt
• AI Builder-spørsmål
• Bot Framework-ferdighet

Viktig!

Du kan ikke bruke samtalebaserte handlinger opprettet i Copilot Studio som handlinger med egendefinerte kopiloter.

Hver kjernehandling har tilleggsinformasjon som beskriver formålet med den, slik at kopiloten kan bruke generativ kunstig intelligens til å generere spørsmål. Disse spørsmålene er nødvendige for å fylle inn inndataene som trengs for å utføre handlingen. Du trenger derfor ikke å opprette spørsmålsnoder manuelt for å samle inn alle inndataverdiene som kreves, for eksempel inndataene i en flyt. Inndata håndteres for deg ved kjøretid.

Handlinger kan generere et kontekstavhengig svar på en brukers spørring ved hjelp av resultatene av handlingen. Du kan alternativt eksplisitt opprette et svar for handlingen.

Tips

Når du bruker genererte spørsmål fra en handling, må du informere brukerne om at noe av samtalen genereres av kunstig intelligens.

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

Legg til en handling

1. Åpne den egendefinerte kopiloten ved å velge Kopiloter i venstre navigasjonsrute og velge kopiloten fra listen.

2. Velg Handlinger for å vise handlinger for kopiloten.

3. Velg + Legg til en handling.

4. I veiviseren Velg en handling (forhåndsversjon) søker du etter en handling du vil bruke, og velger den.

   Standardlisten som vises, har Power Automate-flyter og egendefinerte koblinger som er tilgjengelige i miljøet ditt. Denne listen omfatter vanlige forhåndsbygde koblinger og Bot Framework-ferdigheter som er registrert i kopiloten.

   

   Viktig!

   Enkelte handlinger som opprettes fra KI-programtillegg, for eksempel dynamiske spørsmål og de som er basert på Dataverse-API-er, krever godkjenning.

   

   Tilkoblingen konfigureres automatisk, som vist i eksemplet, avhengig av handlingen. Du må alternativt konfigurere tilkoblingen hvis det finnes instruksjoner i veiviseren. Velg Neste når tilkoblingen er konfigurert.

   

5. Se gjennom og foreta endringer i konfigurasjonen av programtilleggshandlinger hvis det er nødvendig. Velg Fullfør for å legge til handlingen i kopiloten.

   Velg Neste.

Kall opp en handling

Hvis du aktiverte generative handlinger, kalles handlingen automatisk opp som svar på en relevant brukerspørring.

Du kan alternativt eksplisitt kalle opp en handling fra et emne.

Test handlingen

Oppkall av en handling

Kopiloten velger og kjører handlingen basert på navn og beskrivelse. Du kan lage beskrivelser av høy kvalitet ved å bruke den dedikerte sporingsmodusen til å se hvilke handlinger kopiloten har valgt på siden for generative handlinger.

Hvis du har lagt til en i et emne, kan du teste den ved å skrive inn en melding som ligner på et av utløseruttrykkene for dette emnet.

Du kan se en værhandling som testes, på dette skjermbildet:

Hvis du har lagt til en handling i et emne, kan du alternativt foreta testing ved å utløse emnet med et egnet utløseruttrykk.

Konfigurasjon av inndata og utdata for en handling

Gjør endringer i handlingskonfigurasjonen

Det er mange måter å konfigurere handlingen på. I det siste trinnet i handlingsveiviseren, kalt Se gjennom og fullfør, kan du gjøre endringer i handlingskonfigurasjonen ved å klikke på Rediger ved siden av den aktuelle delen.

Handlingsdetaljer

Her kan du konfigurere detaljer om handlingen, inkludert Visningsnavn for modell og Modellbeskrivelse for handlingen. Navnet og beskrivelsen blir vanligvis forhåndsutfylt for deg basert på handlingen du valgte.

Egenskapene Visningsnavn og Beskrivelse for inndata bidrar til at kopiloten forstår formålet med inndataene, genererer et passende spørsmål for brukeren og gjenkjenner den riktige verdien i svaret fra en bruker. Det følgende er for eksempel standardnavnet for og beskrivelsen av stedsinndataparameteren for MSN Vær-koblingen.

• Navn: Sted
• Beskrivelse: Søkespørringen for sted. Gyldige inndata er poststed, område, delstat, land, landemerke, postnummer, breddegrad og lengdegrad

Når brukeren blir bedt et sted, genererer kopiloten et spørsmål som ligner på følgende: Hvilket sted vil du ha værmelding om? Du kan angi poststed, område, delstat, land, landemerke eller postnummer.

Du kan også endre alternativet for Identifiser som til en bestemt enhetstype, avhengig av inndataene som samles inn, som kan hjelpe kopiloten til å trekke ut en verdi nøyaktig fra en brukers svar.

Alle inndata settes som standard til Fyll ut dynamisk med det beste alternativet. Kopiloten prøver å fylle ut verdien fra tilgjengelig kontekst, for eksempel å trekke ut en verdi fra brukerens melding. Hvis ingen passende verdi blir funnet, genererer den et spørsmål for å spørre brukeren om en verdi. Du kan overstyre inndata med en verdi i stedet for å spørre brukeren. Du kan overstyre ved å endre rullegardinlisten Hvordan fyller kopiloten ut disse inndataene? til Angi som en verdi, og angi deretter en verdi. Denne verdien kan være en litteralverdi, en eksisterende variabel eller en Power Fx-formel.

Du kan styre kopilotens funksjonalitet når den ber om en verdi eller validerer svaret fra en bruker, ved å konfigurere ytterligere innstillinger for inndata.

Utdata

Handlingen konfigureres som standard slik at den genererer et kontekstavhengig svar for en bruker, basert på spørringen til brukeren og resultatet av handlingen. Hvis en bruker for eksempel spør «Hva er den nåværende temperaturen i London?», genereres et kontekstuelt svar ved hjelp av GPT, for eksempel «Gjeldende temperatur i London er 9 grader celsius».

Du kan alternativt skrive et bestemt svar som handlingen skal returnere. Som med redigeringsprogrammet for bekreftelse kan du sette inn referanser til utdatavariabler fra handlingen som bruker variabelvelgeren, som vises i dette eksemplet.

Kall opp en handling fra et emne

Du kan eksplisitt kalle opp en handling fra et emne, som ligner på oppkall av andre handlingstyper som Power Automate-flyter. Du kan bruke Flow som en del av et mer omfattende emne, som bruker flere noder, avhengig av brukstilfellet. Eller kanskje alt du trenger, er å legge til én handlingsnode i et emne, slik som i væreksemplet.

Slik kaller du opp en handling fra et emne:

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

2. Opprett et nytt emne, og gi det navnet Få værmelding.

3. Legg til følgende Utløseruttrykk:

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

   

4. Velg Legg til node (+), og deretter velger du Kall opp en handling. Bytt til fanen Programtilleggshandlinger (forhåndsversjon), og velg deretter handlingen du opprettet tidligere, Få værmelding.

   

5. Noden Programtilleggshandling (forhåndsversjon) er nå lagt til i emnet.

   

6. Velg Lagre.

Overstyr inndata ved oppkall av en handling fra et emne

Når handlingen kjører, genererer kopiloten som standard spørsmål til brukeren for å fylle inn de nødvendige inndataene. Av og til kan det imidlertid hende at du vil overstyre inndata og angi en eksplisitt verdi i stedet for å spørre brukeren. Du kan overstyre i konfigurasjonen for programtillegg i Inndata-delen. Eller du kan overstyre bare verdier når handlingen brukes fra et bestemt emne:

1. Velg Angi verdi på noden, og velg inndataene du vil overstyre.

   

2. Angi verdien for inndataene ved å skrive inn en verdi, velge en variabel eller bruke en formel.

   

Nå som inndataene er overstyrt, ber ikke kopiloten brukeren om å angi en verdi.

Aktiver godkjenning for KI-handlinger

Enkelte handlinger krever godkjenning for å kunne fungere riktig når de opprettes basert på KI-handlinger, for eksempel dynamisk spørsmål eller andre som kaller opp en Dataverse-API.

Handlinger kjøres alltid i Microsoft Copilot-kjøretiden i sluttbrukerkonteksten og kan ikke kjøres med mindre godkjenning er aktivert. To typer godkjenningsmetoder støttes:

1. Gå til egenskapene for koblingshandling.

2. Velg Utviklergodkjenning for kopilot under Sluttbrukergodkjenning.

3. Publiser og test funksjonen i ruten for kopilottest eller i en ønsket kanal.

   

Bruk flythandlinger med sluttbrukerlegitimasjon

Flythandlinger kan konfigureres slik at de bruker sluttbrukerlegitimasjon. Hvis du bruker flyten i en støttet kanal, krever ikke dette noen spesiell konfigurasjon i kopilotdialogen, og sluttbrukerne kan administrere tilkoblingene sine for en gitt flyt i en gitt funksjon.

Godkjenning for handlinger basert på programtillegg i biblioteket

Når handlinger opprettes basert på KI-programtillegg, krever de godkjenning for å kunne fungere riktig. Dette er vanligst vedrørende handlinger basert på spørsmål eller andre som kaller opp Dataverse-API-er. Handlinger basert på programtillegg kjører alltid i sluttbrukerkonteksten og kan ikke kjøres med mindre godkjenning er aktivert. To typer godkjenningsmetoder støttes:

• Integrert godkjenning (Teams og Power Apps): Du kan bruke denne godkjenningsmetoden hvis du vil publisere kopiloten i en Teams-kanal. Denne metoden fungerer også for kopiloter som er innebygd i enhver Power Platform-app som bruker tokener bygd med PPAPI-standarden.

• Manuell godkjenning (kopiloter fra tredjeparter): Denne godkjenningsmetoden omfatter konfigurasjon av en Microsoft Entra ID-tilkobling.

Slik oppretter du en manuell autentiseringstilkobling:

1. Konfigurer en Microsoft Entra ID-app.

2. Konfigurer manuell godkjenning for Copilot Studio-kopiloten.

3. Tillat appen din å bruke delegering for å hente et token på vegne av brukeren. Sørg for å legge til eventuelle nødvendige omfang.