Legg til agentsvar med skjemautformingen (forhåndsversjon)

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

Legg til agentsvarkomponenten i et modelldrevet appskjema, som kan kalle opp et Microsoft Copilot Studio-emne direkte og vise svaret til brukeren. Denne komponenten bygger på Agent-API-en executeEvent og forenkler bruken ved ikke å kreve en ny egendefinert komponent. Den implisitte konteksten for appen, siden og oppføringen er tilgjengelig i Copilot Studio.

Denne komponenten støtter følgende svar fra Copilot Studio:

  • Markdown
  • Dynamisk kort
  • Image
  • video

Viktig!

  • Dette er forhåndsversjonsfunksjon.
  • Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er underlagt tilleggsvilkår for bruk og er tilgjengelige før en offisielle utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.

Forutsetning

Krever at miljøinnstillingen Tillat at brukere analyserer data ved hjelp av en nettpratfunksjon drevet av kunstig intelligens i lerretsapper og modelldrevne apper er aktivert for modelldrevne apper. Mer informasjon: Miljøinnstillinger for Copilot

Legge til en komponent for agentsvar i et skjema

  1. Åpne skjemautformingen for å opprette eller redigere et skjema. Mer informasjon: Opprette et skjema eller Redigere et skjema

  2. Velg Komponent på kommandolinjen i skjemautformingen.

  3. I Komponenter-ruten utvider du Kunstig intelligens

  4. Flytt Agentsvar over til skjemalerretet.

    Agentsvar i komponentruten.

  5. I boksen Statisk verdi i dialogboksen Legg til agentsvar skriver du inn hendelsesnavnet fra emnet i Copilot Studio. Mer informasjon: Finn hendelsesnavnet for et emne i Copilot StudioKonfigurer hendelsesnavn for agentsvar

    Notat

    Alternativet Bind til tabellkolonne støttes ikke for denne komponenten.

  6. Velg Lagre og publiser på kommandolinjen.

  7. Åpne skjemaet i en modelldrevet app for å teste komponenten.

    Notat

    Forhåndsversjonen av skjemautformingen viser advarselen «Agentsvar er bare tilgjengelig når du spiller av appen» siden direkte forhåndsvisning ikke støttes ennå.

Finn hendelsesnavnet for et emne i Copilot Studio

  1. Åpne emnet i Copilot Studio, og finn Utløser-noden.

  2. Kontroller at utløsertypen er En egendefinert klienthendelse oppstår eller Hendelse mottatt.

  3. Velg Rediger i Utløser-noden.

    Utløser for egendefinert klienthendelse i Copilot Studio.

  4. I egenskapsruten Ved hendelsesaktivitet kopierer du strengverdien for egenskapen Hendelsesnavn som skal sendes fra agentsvarkomponenten. Mer informasjon: Endre utløseren for et emne

    Egenskapsruten for utløser ved hendelse i Copilot Studio.

Få tilgang til appkontekst

Når agentsvarkomponenten kaller opp Copilot Studio-emnet, sender den konteksten for appen gjennom et sett med variabler. Følgende er kontekstvariabler som er tilgjengelige som globale Copilot Studio-variabler.

Variabel Description
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID-en til tabellposten i hovedskjemaet
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logisk navn på tabellen på hovedsiden
Global.PA__Copilot_Model_PageContext.pageContext.pageName Navnet på hovedsiden
Global.PA__Copilot_Model_PageContext.pageContext.pageType Typen for hovedsiden
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Unikt navn for den modelldrevne appen

Tilgjengelighet

Når Copilot Studio-svaret er et dynamisk kort, sørger du for å følge følgende anbefalte fremgangsmåter for å få en tilgjengelig opplevelse.

Begrensninger

  • Egenskaper for komponenten for agentsvar som foreløpig ikke støttes:

    • Label
    • Skjul etikett
    • Skjul på telefon
    • Lås
    • Skrivebeskyttet
    • Komponentbredde
    • Komponenthøyde
    • Bind til tabellkolonne

  • Komponenten for agentsvar støtter ikke overføring av ytterligere kontekst til Copilot Studio. Opprett en egendefinert komponent ved å bruke Agent-API-en executeEvent for å støtte overføring av mer kontekst.

  • Komponenten for agentsvar støtter bare et skrivebeskyttet adaptivt kort. Opprett en egendefinert komponent ved å bruke Agent-API-en executeEvent for å støtte logikk på klientsiden.

  • Komponenten for agentsvar støttes ikke for mobiler eller nettbrett.

Vanlige spørsmål om agent-API-er og komponent for agentsvar

Agent-API-en executeEvent

Oversikt over den modelldrevne skjemautformingen
Legge til, konfigurere, flytte eller slette komponenter i et skjema

  • Last updated on