Brug handlinger med brugerdefinerede agenter (forhåndsversion)

Du kan udvide funktionerne i din agent ved at tilføje en eller flere handlinger. Handlinger bruges af din agent til at reagere automatisk på brugere ved hjælp af generativ orkestrering, eller du kan kalde dem eksplicit fra et emne.

Kernehandlingstyper

Hvis du aktiverer generativ orkestrering, kan din agent automatisk vælge den mest relevante handling eller emne eller søge i viden for at reagere på en bruger.

I klassisk tilstand (generativ orkestrering deaktiveret) kan en agent kun bruge emner til at svare brugeren. Du kan dog stadig designe din agent til eksplicit at kalde handlinger ud fra emner.

Handlinger er baseret på en af følgende kernehandlingstyper:

• Forudbygget connector-handling
• Brugerdefineret connector-handling
• Power Automate-cloudflow
• AI Builder prompts (inden for et emne)
• Bot Framework-færdighed
• REST API-forbindelse

Hver kernehandling indeholder yderligere oplysninger, der beskriver formålet, så agenten kan bruge generativ AI til at oprette spørgsmål. Disse spørgsmål er nødvendige for at udfylde de input, der er nødvendige for at udføre handlingen. Derfor behøver du ikke manuelt at oprette spørgsmålsnoder for at indsamle alle nødvendige input, f.eks. input i et flow. Input håndteres for dig under kørsel.

Når du bruger generativ tilstand, returnerer handlinger som standard deres oplysninger tilbage til agenten, så agenten kan generere et kontekstafhængigt svar på brugerens forespørgsel. Du kan også angive handlingen til altid at svare med det samme, enten ved at oprette en meddelelse eller oprette en eksplicit meddelelse.

Tip

Når du bruger genererede spørgsmål fra en handling, skal du informere dine brugere om, at noget af samtalen genereres af AI.

Tilføj f.eks. en ekstra meddelelse i Samtalestartsystememne. Dette emne bestemmer den meddelelse, der vises for dine brugere, når en ny samtale starter.

Tilføje en handling

1. Åbn din agent ved at vælge Agenter i venstre navigationsrude og vælge din agent på listen.

2. Vælg Handlinger for at få vist handlinger for agenten.

3. Vælg Tilføj en handling.

4. Søg efter en handling, du vil bruge, i guiden Vælg en handling , og vælg den.

   Den viste standardliste har tilgængelige Power Automate-flows og brugerdefinerede connectorer i dit miljø. Denne liste indeholder almindeligt anvendte færdigbyggede connectorer og Bot Framework-færdigheder, der er registreret hos din agent.

   

   Vigtigt!

   Nogle handlinger, der er oprettet ud fra AI-plugins, f.eks. dynamiske prompter og dem, der er baseret på Dataverse API'er, kræver godkendelse.

   Afhængigt af handlingen konfigureres din forbindelse automatisk, som vist i eksemplet. Ellers skal du følge guidens instruktioner for at konfigurere forbindelsen. Vælg Næste, når forbindelsen er konfigureret korrekt.

   

5. Gennemse konfigurationen af plug-in-handlingen, og foretag ændringer , hvis det er nødvendigt.

   Vælg Næste.

6. Vælg Afslut for at føje handlingen til din agent.

Test din handling

Hvis du har aktiveret generativ orkestrering, kaldes handlingen automatisk som svar på en relevant brugerforespørgsel.

Du kan også kalde en handling eksplicit fra et emne.

Din agent vælger og kører din handling på baggrund af navnet og beskrivelsen. Du kan udarbejde beskrivelser af høj kvalitet ved hjælp af aktivitetstilknytningen for at se, hvilke handlinger din agent har valgt på siden med handlinger.

Du kan se en vejrhandling, der testes, på dette skærmbillede:

Foretag ændringer af din handlingskonfigurationen

Der er mange måder at konfigurere din handling på. På det sidste trin i handlingsguiden, der hedder Gennemse og Afslut, kan du foretage ændringer af handlingens konfiguration ved at klikke på Rediger ud for den relevante sektion. Via skærmbilledet Gennemse input og output i guiden eller på detaljesiden for en handling, der allerede er en del af din agent, kan du administrere input- og outputparametrene for handlingen.

Handlingsdetaljer

Her kan du konfigurere detaljer om din handling, herunder visningsnavn for model og modelbeskrivelse for handlingen. Normalt er navnet og beskrivelsen udfyldt på forhånd ud fra den handling, du har valgt.

Egenskaberne Visningsnavn og Beskrivelse for hvert enkelt input hjælper din agent med at forstå formålet med inputtet, oprette et passende spørgsmål til brugeren og genkende den korrekte værdi i en brugers svar. I det følgende kan du f.eks. se standardnavnet og beskrivelsen af placeringsinputparameteren for MSN Weather-connector.

• Navn: Lokation
• Beskrivelse: Placeringen søgeforespørgsel. Gyldige input er By, Område, Stat, Land/område, Landmærke, Postnummer, breddegrad og længdegrad

Når agenten beder brugeren om en placering, opretter den et spørgsmål i stil med: Hvad er den placering, du vil kontrollere placeringen for? Du kan angive by, område, delstat, land, landmærke eller postnummer.

Du kan ændre indstillingen Identificer som til en bestemt objekttype, afhængigt af det input, der indsamles, hvilket kan hjælpe agenten med nøjagtigt at udtrække en værdi fra en brugers svar.

Inputs

Som standard er hvert input indstillet til Udfyld dynamisk med den bedste indstilling. Agenten forsøger at udtrække værdien fra den tilgængelige kontekst, f.eks. fra brugerens meddelelse. Hvis der ikke findes en passende værdi, genereres der et spørgsmål for at bede brugeren om en værdi. Du kan tilsidesætte et input med en værdi i stedet for at spørge brugeren. Hvis du vil angive en tilsidesættelse af Hvordan udfyldes dette input af agenten? skal du vælge Angiv som en værdi og angive den ønskede værdi. Denne værdi kan være en bogstavelig værdi, en eksisterende variabel eller en Power Fx-formel.

Du kan styre din agents funktionsmåde, når du beder om en værdi eller validerer en brugers svar, ved at konkfigurere flere indstillinger for input.

Output

Handlingen konfigureres som standard til automatisk at oprette et kontekstafhængigt svar for en bruger på baggrund af brugerens forespørgsel og resultatet af handlingen. Hvis en bruger f.eks. spørger: "Hvad er den aktuelle temperatur i London?", genereres der et kontekstafhængigt svar ved hjælp af GPT, f.eks. "Den aktuelle temperatur i London er 9 grader Celsius".

Du kan også vælge at udarbejde et bestemt svar, for at handlingen skal returneres. Som med bekræftelseseditoren kan du indsætte referencer til outputvariabler fra handlingen ved hjælp af variabelvælgeren som vist i dette eksempel.

Kald en handling fra et emne

Du kan kalde en handling eksplicit fra et emne, på samme måde som når du kalder andre handlingstyper, f.eks. Power Automate Flow. Afhængigt af brugen kan du bruge dit flow som en del af et bredere emne, som anvender flere noder. Eller du kan f.eks. tilføje en enkelt handlingsnode på et emne du har brug for.

Kald en handling fra et emne:

1. I Copilot Studio skal du gå til Emne-siden for den agent, du vil redigere.

2. Opret et nyt emne, og giv det et navnet Hent vejret.

3. Tilføj følgende Udløserfraser:

   • kommer der regn
   • vejrudsigten for i dag
   • hent vejret
   • hvordan er vejret

   

4. Vælg Tilføj node (+) og vælg derefter Kald en handling. Skift til fanen Plug-in-handlinger (forhåndsversion), og vælg derefter den handling, du har oprettet tidligere, Hent vejrprognose.

   

5. Din Plugin-handling (forhåndsversion) node føjes nu til dit emne.

   

6. Vælg Gem.

Tilsidesæt input, når der kaldes en handling fra et emne

Når din handling kører, genererer din agent som standard spørgsmål til brugeren om at udfylde de påkrævede input. Du kan imidlertid tilsidesætte et eller flere input og angive en eksplicit værdi i stedet for at spørge brugeren. Du kan tilsidesætte i plugin-handlingskonfigurationen i sektionen Inputs. Du kan også kun tilsidesætte værdier, når handlingen bruges fra et bestemt emne:

1. Vælg Angiv værdi på noden, og vælg det input, du vil tilsidesætte.

   

2. Indtast værdien for input ved at skrive en værdi, vælge en variabel eller bruge en formel.

   

Nu, hvor dette input tilsidesættes, beder agenten ikke brugeren om en værdi.

Aktivere godkendelse for AI-handlinger

Nogle handlinger kræver godkendelse, når de oprettes på baggrund af AI-handlinger, for at de kan fungere korrekt, f.eks. dynamisk prompt eller andre, der kalder en Dataverse API.

Handlinger køres altid under agentkørsel i brugerkonteksten og kan ikke køres, medmindre godkendelse er aktiveret. To typer godkendelsesmetoder understøttes:

1. Gå til egenskaberne for connector-handling.

2. Vælg Agentforfattergodkendelse under Slutbrugergodkendelse.

3. Publicer og test oplevelsen i agenttestruden eller på en ønsket kanal.

   

Brug flowhandlinger med brugerlegitimationsoplysninger

Flowhandlinger kan konfigureres til at bruge brugerlegitimationsoplysninger. Hvis du bruger flowet på en understøttet kanal, kræver dette ingen særlig konfiguration i din agentdialog, og brugere kan administrere deres forbindelser for et givent flow i en angivet oplevelse.

Godkendelse for handlinger baseret på plugins i biblioteket

Når handlinger oprettes på baggrund af AI-plugins, kræver de godkendelse, for at de kan fungere korrekt. Dette ses som regel med handlinger, der er baseret på spørgsmål eller andre, der kalder Dataverse API'er. Handlinger, der er baseret på plug-ins, køres altid i brugerkonteksten og kan ikke køres, medmindre godkendelse er aktiveret. To typer godkendelsesmetoder understøttes:

• Integreret godkendelse (Teams og Power Apps): Du kan bruge denne godkendelsesmetode, hvis du vil publicere din agent på en Teams-kanal. Denne metode fungerer også for helpdesk-medarbejdere, der er integreret i alle Power Platform apps, som bruger tokens, der er bygget med PPAPI-standarden.

• Manuel godkendelse (tredjepartsagenter): Denne godkendelsesmetode omfatter opsætning af en Microsoft Entra id-forbindelse.

Sådan opretter du en manuel godkendelsesforbindelse:

1. Konfigurer en Microsoft Entra ID-app.

2. Konfigurer manuel godkendelse for din agent.

3. Tillad, at din app bruger delegering til at hente et token på vegne af brugeren. Sørg for at tilføje eventuelle nødvendige områder.