Opret plug-ins med lav kode, der skal bruges sammen med en copilot (prøveversion)

[Dette emne er til dokumentationen til den foreløbige udgivelse. Der kan forekomme ændringer.]

Copilot-handlinger er en måde at udvide egenskaberne for dine copilot bots. Med generative AI-handlinger fra Copilot opretter du brugerdefinerede handlinger, der udløses af din copilotrobot. Disse handlinger bruges til at udføre en lang række opgaver, f.eks. at sende mails, oprette poster i Microsoft Dataverse eller kalde eksterne API'er. I denne artikel opretter du en grundlæggende plug-in med lav kode, der lægger to heltal sammen og en mere kompleks plug-in, der kan bruges til at sende en meddelelse, som begge kan bruges til at oprette en handling i Microsoft Copilot Studio.

Forudsætninger for at bruge plug-in'en med Microsoft Copilot

Før du begynder, skal du sørge for, at du har følgende forudsætninger:

• Adgang til et Dataverse-miljø, der indeholder Dataverse Accelerator-appen til oprettelse af plug-ins med lav kode.
• Adgang til Copilot Studio i det samme miljø som dit Dataverse-miljø.

Eksempel på grundlæggende plug-in med lav kode

I dette eksempel opretter du en plug-in med kort kode, der tilføjer to tal og returnerer summen af disse tal. Du opretter derefter en Copilot-handling, der kalder denne plug-in med lav kode for at udføre tilføjelsen. Den copilot, du opretter, fungerer for tal og vilkårlige tekstforespørgsler, der indeholder tal og brøker, der er stavet ud.

Følg disse trin for at oprette din grundlæggende plug-in med kort kode:

1. Åbn Appen Dataverse Accelerator i dit Dataverse-miljø ved at gå til Apps>All>Dataverse Accelerator App og vælge Afspil.

2. Vælg Ny plug-in i Appen Dataverse Accelerator, og vælg Øjeblikkelig plug-in.

3. Angiv et beskrivende vist navn til din plug-in. F.eks. Sumtal, og vælg derefter Opret.

4. I sektionen Parametre:

   • Tilføj følgende inputparametre:
     • Parameternavn: Number1, Type: Flydende
     • Parameternavn: Number2, Type: Flydende
   • Tilføj følgende outputparameter:
     • Parameternavn: Resultat, type: Flydende

5. Angiv følgende kode i afsnittet Udtryk :

   {Result: Number1 + Number2}
   

   

6. Vælg Gem for at gemme plug-in'en.

Opret en copilot for at kalde din grundlæggende plug-in med lav kode

Gå til Copilot Studio, og åbn det miljø, der har plug-in'en.

1. Opret en andenpilot. Flere oplysninger: Opret og konfigurer plug-ins til copilot
2. Aktivér generative handlinger på copiloten. Flere oplysninger: Aktivér generative handlinger
3. Tilføj en generativ AI-handling. Når du tilføjer handlingen, skal du søge efter 'Udfør en ubundet handling i det valgte miljø' og vælge handlingen. Flere oplysninger: Brug generative handlinger i Microsoft Copilot Studio
4. Konfigurer handlingen med følgende oplysninger:
   • Tilføj en modelbeskrivelse, der giver copiloten besked om, hvornår denne handling skal kaldes. Brug almindeligt engelsk til at beskrive de betingelser, som denne handling skal kaldes under. Du kan f.eks. skrive "Tilføjer tal og returnerer summen af disse tal med 2 flydende talværdier". Flere oplysninger: Oprettelse af beskrivelser
   • Brug disse input:
     • Rediger Hvordan udfylder copiloten dette input for parameteren Organization tilAngiv som en værdi.
     • Vælg dit aktuelle miljø (det miljø, hvor du oprettede plug-in'en med lav kode) som værdien for parameteren Organisation .
     • Rediger Hvordan udfylder copiloten dette input for parameteren Action Name til Angiv som en værdi.
     • Vælg den plug-in med lav kode, du har oprettet som værdi for parameteren Handlingsnavn . Hvis du er usikker på, hvad navnet på din plug-in er, kan du finde det i Appen Dataverse Accelerator ved at vælge det på listen og vælge Kopiér kodestykke og derefter indsætte koden i en teksteditor.
   • Yderligere input:
     • Tilføj følgende inputparametre. Tilføjelse af yderligere input viser i øjeblikket ikke detaljer i Copilot Studio. Du kan kontrollere, at input blev tilføjet korrekt, ved at vælge Åbn koderedigering og gennemse koden, som skal vise de ekstra input under inputafsnittet i handlingen YAML:
       • Parameternavn: Number1
       • Parameternavn: Number2
5. Gem og publicer copiloten.

Test din copilothandling

Følg disse trin i ruden Test copilot i Copilot Studio.

1. Vælg minidiagramikonet øverst i chatvinduet for at starte sporingstilstanden. Dette giver dig mulighed for at bekræfte, at din handling kaldes, og bekræfter input og output for din handling. Flere oplysninger: Test af din copilot ved hjælp af generative handlinger
2. Angiv teksten i chatvinduet Tilføj 5.2 og 10.3 , og vælg Send.

Hvis alt er konfigureret korrekt, kan du se det forventede resultat på 15,5 output i chatvinduet, og sporingsruden viser input og output fra din handling. Sporingsruden ligner følgende eksempel. Du kan prøve nogle andre prompts for at teste handlingen yderligere og ændre sproget for at se, hvordan handlingen reagerer. Nogle eksempler:

• Hvis jeg har 3 æbler, og min ven giver mig 4 mere, hvor mange æbler har jeg så i alt?
• Hvis jeg har 1/2 pounds af ost, og jeg bestiller en anden 1 / 4 pounds, hvor meget ost har jeg i alt?

Eksempel på send meddelelse om plug-in med lav kode

I dette eksempel opretter du en plug-in med lavt kodeformat, der ombryder en eksisterende API til brug sammen med en copilot. Handlingen sender en meddelelse til den bruger, der er angivet i copilot-handlingen, når den bruger, der opretter handlingen, tester den i Copilot Studio. Copiloten bestemmer de påkrævede parametre fra forespørgslen i almindeligt sprog fra brugeren og sender en meddelelse ved hjælp af en Dataverse-plug-in med lavt kodeindhold til en modeldreven app i Power Apps.

Hvis du vil oprette din plug-in med kort kode, skal du følge disse trin:

1. Åbn Appen Dataverse Accelerator i dit Dataverse-miljø ved at gå til Apps>All> Dataverse Accelerator App, og vælg Afspil.

2. Vælg Ny plug-in i Appen Dataverse Accelerator, og vælg derefter Øjeblikkelig plug-in.

3. Angiv et beskrivende vist navn til din plug-in. Send f.eks. en meddelelse i appen til brugeren , og vælg Opret.

4. I sektionen Parametre:

   • Tilføj følgende inputparametre:
     • Parameternavn: Brugernavn, type: Streng
     • Parameternavn: Titel, Type: Streng
     • Parameternavn: Krop, Type: Streng
     • Parameternavn: URL-adresse, type: Streng
   • Tilføj følgende outputparameter:
     • Parameternavn: Resultat, Type: Streng

5. Angiv følgende kode i afsnittet Udtryk . Bemærk, at vi ombryder den eksisterende XSendAppNotification API med plug-in'en for at give mulighed for at finde brugere efter navn. Denne funktionsmåde hjælper, når den kaldes fra copilot, hvilket kun kan give oplysninger, som brugeren kender til personen og ikke flere esoteriske id'er for poster, som den underliggende API forventer:

   XSendAppNotification(Title,
   First(Filter(Users, UserName in 'Full Name')), 
   Body,
   [XCreateUrlAction("Click Here", Url)]
   );
   {Result: "Success"}
   

   

6. Vælg Gem for at gemme plug-in'en.

Opret en copilot for at kalde din send-meddelelse plug-in med lav kode

Gå til Copilot Studio, og åbn det miljø, der har plug-in'en.

1. Opret en andenpilot. Flere oplysninger: Opret og konfigurer plug-ins til copilot
2. Aktivér generative handlinger på copiloten. Flere oplysninger: Aktivér generative handlinger
3. Tilføj en generativ AI-handling. Når du tilføjer handlingen, skal du søge efter 'Udfør en ubundet handling i det valgte miljø' og vælge handlingen. Flere oplysninger: Brug generative handlinger i Microsoft Copilot Studio
4. Konfigurer handlingen med følgende oplysninger:
   • Tilføj en modelbeskrivelse, der giver copiloten besked om, hvornår denne handling skal kaldes. Brug almindeligt engelsk til at beskrive de betingelser, som denne handling skal kaldes under. Du kan f.eks. angive "Kalder en Dataverse-API for at sende en meddelelse til en bruger i Dataverse for at minde eller advare dem om noget vigtigt med en titel, brødtekst og eventuelt et link for at få flere oplysninger." Flere oplysninger: Oprettelse af beskrivelser
   • Brug disse input:
     • Rediger Hvordan udfylder copiloten dette input for parameteren Organization tilAngiv som en værdi.
     • Vælg dit aktuelle miljø på rullelisten (det miljø, hvor du oprettede plug-in'en med lav kode) som værdien for parameteren Organisation . Du skal placere markøren i tekstfeltet, før listen over tilgængelige miljøer kan vises.
     • Rediger Hvordan udfylder copiloten dette input for parameteren Action Name til Angiv som en værdi.
     • Vælg den plug-in med lav kode, du har oprettet som værdi for parameteren Handlingsnavn . Du skal placere markøren i tekstfeltet, før listen over tilgængelige API'er kan vises. Den værdi, der skal angives her, er skemanavnet på plug-in'en med lav kode, f.eks org_SendInAppNotificationToUser. . Hvis du er usikker på, hvad skemanavnet på din plug-in er, kan du finde det i appen Dataverse Accelerator ved at vælge det på listen og vælge Kopiér kodestykke og derefter indsætte koden i en teksteditor.
   • Yderligere input:
     • Vælg Tilføj , og tilføj følgende inputparametre. Bemærk, at tilføjelse af yderligere input i øjeblikket ikke viser detaljer i Copilot Studio. Dette er et kendt problem. Du kan kontrollere, at input blev tilføjet korrekt, ved at vælge Åbn koderedigering og gennemse koden, som skal vise de ekstra input under inputafsnittet i handlingen YAML:
       • Parameternavn: Brugernavn
       • Parameternavn: Titel
       • Parameternavn: Indhold
       • Parameternavn: URL-adresse
5. Gem og udgiv Copilot.

Test copilothandlingen til afsendelse af meddelelser

Følg disse trin i ruden Test copilot i Copilot Studio.

1. Vælg minidiagramikonet øverst i chatvinduet for at starte sporingstilstanden. Dette giver dig mulighed for at bekræfte, at din handling kaldes, og bekræfter input og output for din handling. Flere oplysninger: Test af din copilot ved hjælp af generative handlinger
2. Angiv teksten i chatvinduet Send en meddelelse til min bruger for at tjekke denne URL-adresse https://copilotstudio.microsoft.comud, og vælg derefter Send.

Hvis alt er konfigureret korrekt, kan du se, at der er sendt en meddelelse i ruden Test copilot . Meddelelsen sendes som en modeldrevet meddelelse i appen, når den angivne bruger afspiller appen.

Du kan prøve nogle andre prompts for at teste handlingen yderligere, og du kan ændre plug-in'en, så den er klogere på, hvordan den søger efter brugere, der har fået et navn, for at se, hvordan handlingen reagerer. Du kan f.eks. tilføje et trin for at søge efter brugeren efter mailadresse, hvis navnet ikke returnerer et resultat.

Se også

Brug plug-ins med lav kode i Dataverse