Tilpasse Microsoft 365 Copilot med en agent

Microsoft 365 Copilot i Power Apps lar brukere samhandle med egendefinerte agenter som utvider det Copilot kan gjøre. Ved å tilpasse en agent kan du opprette skreddersydde opplevelser som passer organisasjonens forretningsprosesser og data. Hvis du vil ha mer informasjon, kan du se Bruke agenter i Microsoft 365 Copilot.

Denne artikkelen beskriver hvilke typer agenter du kan bygge for Microsoft 365 Copilot i Power Apps, og hjelper deg med å velge riktig fremgangsmåte for scenarioet.

Velg en agenttype

Tabellen nedenfor sammenligner agenttypene du kan bygge.

Agenttype Description Vanlige brukstilfeller
Deklarativ agent Bygget med lavkodeverktøy og maler for hurtigoppsett av vanlige scenarioer i Microsoft 365 Copilot. Automatiser rutinemessige oppgaver, svar vanlige spørsmål og gi veiledede arbeidsflyter.
Egendefinert motoragent Bygget med egendefinert logikk og integreringer for avanserte funksjoner som er skreddersydd for bedriften din. Komplekse forretningsprosesser, egendefinerte dataintegreringer og spesialisert automatisering.
Copilot Studio agent Bygget og administrert i Microsoft Copilot Studio, med integrering i Teams og Microsoft 365 for samtaleopplevelser. Interaktive chatboter, teamsamarbeid og tilpasset støtte i Microsoft 365-apper.

Hvis du vil finne det beste alternativet for organisasjonen, kan du bruke disse ressursene:

Én måte å opprette en deklarativ agent for en modelldrevet app på, er å slå på Microsoft 365 Copilot direkte i appen. Hvis du vil ha mer informasjon, kan du se Aktivere appen for Microsoft 365 Copilot.

Du kan opprette din egen appspesifikke agentmodus i Power Apps ved å kombinere en standardagent med Xrm.Copilot.* API-ene. Standardagenten definerer den skreddersydde Microsoft 365 Copilot opplevelsen som åpnes for brukere, og API-ene oppretter den toveis tilkoblingen mellom appen og Microsoft 365 Copilot.

Angi en standardagent

Hvis du bygger en egendefinert agent som en følgesvenn til den modelldrevne appen, kan du angi den som standardagent, slik at den lastes inn automatisk når appen og den Microsoft 365 Copilot sideruten åpnes. Dette gjør din agent til utgangspunktet for opplevelsen og er den første delen av å bygge din egen agentmodus.

Når du angir en standardagent:

  • Agenten din er valgt uten noen handling fra brukeren.
  • Brukere går direkte til den skreddersydde opplevelsen du har utformet for appen.
  • Appspesifikke arbeidsflyter og veiledning er klare så snart Microsoft 365 Copilot åpnes.

En standardagent er spesielt nyttig for scenariofokuserte agenter som utvider kjerneopplevelsen til appen og fungerer som inngangsdør til den appspesifikke Microsoft 365 Copilot opplevelsen du vil at brukerne skal ha.

Skjermbilde som viser hvordan du angir en standardagent for Microsoft 365 Copilot i den modelldrevne appen.

Xrm.Copilot API-er

Klient-API-er Xrm.Copilot.* lar utviklere integrere Microsoft 365 Copilot direkte i modelldrevne appopplevelser. Med disse API-ene kan appen samhandle direkte med Microsoft 365 Copilot sideruten og svare på Microsoft 365 Copilot-drevne handlinger, slik at du kan opprette rikere, ende-til-ende agentiske scenarier.

Disse API-ene brukes sammen med en standardagent, og fullfører agentmodusmønsteret: Agenten din er utgangspunktet, appen kan sende ledetekster og kontekst inn i Microsoft 365 Copilot, og Microsoft 365 Copilot kan aktivere handlinger i appen igjen.

Hvis du vil ha hele API-overflaten, kan du se Xrm.Copilot (klient-API-referanse) i modelldrevne apper.

Disse API-ene lar deg:

  • Send meldinger til Microsoft 365 Copilot. Brukes sendPromptToM365Copilot til å starte en Microsoft 365 Copilot samhandling fra appen.
  • Åpne og kontroller sideruten Microsoft 365 Copilot. Bruk openM365CopilotPanel til å sørge for at Microsoft 365 Copilot-ruten er synlig når det er nødvendig.
  • Send appkontekst til Microsoft 365 Copilot. Bruk updateContext (forhåndsvisning) til å sende ekstra jordingssignaler fra appen.
  • Arbeid med agenter. Bruk getCurrentAgent denne til å kontrollere hvilken agent som er aktiv.
  • Håndter Microsoft 365 Copilot handlinger i appen. Brukes addActionHandler til å registrere egendefinerte behandlere som behandler handlinger som sendes fra Microsoft 365 Copilot svar.

Sammen oppretter disse API-ene en ekte toveis opplevelse mellom brukergrensesnittet for apper og agenten, slik at agenter kan drive oppdateringer av brukergrensesnittet, utløse arbeidsflyter eller kjøre egendefinert forretningslogikk.

Behandle Microsoft 365 Copilot handlinger med addActionHandler

addActionHandler Bruk API-en når appen må håndtere strukturerte handlinger som Microsoft 365 Copilot avgir.

Når du bygger nyttelasten for handlingen:

  • Sett type til PowerApps for å målrette mot verten for Power Apps.
  • Angi action (for eksempel MyNamespace.MyMessage) til actionId du registrerer i addActionHandler.
  • Bruk actionData for nyttelasten som koden behandler og sender til verten for Power Apps.

Avsnittene nedenfor viser to scenarioer som støttes.

Dynamiske kort

Microsoft 365 Copilot svar kan inkludere Dynamiske kort med Action.Submit knapper som sender handlingsmeldinger til Power Apps verten.

Eksempel:

{
  "type": "AdaptiveCard",
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Click Go and I will send data to the host to process.",
      "wrap": true,
      "id": "txtSendMessage"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Submit",
          "title": "Go",
          "id": "btnGo",
          "data": {
            "type": "PowerApps",
            "action": "MyNamespace.MyMessage",
            "actionData": {
              "foo": "bar"
            }
          }
        }
      ]
    }
  ]
}

MCP-apper

Microsoft 365 Copilot svar kan inkludere HTML som sender handlingsmeldinger til Power Apps verten.

Eksempel:

<Button
  appearance="outline"
  icon={<ArrowLeft24Regular />}
  onClick={() => {
    try {
      const message = {
        eventName: 'powerapps.copilot.chat.action',
        action: 'MyNamespace.MyMessage',
        actionData: {
          foo: 'bar'
        },
      };
      window.parent.parent.postMessage(message, '*');
    } catch (error) {
      // eslint-disable-next-line no-console
      console.error('Error posting HOST_ACTION message to parent window:', error);
    }
  }}
>
  Test
</Button>

Begrensninger

  • Agenter du redigerer, kan ennå ikke bruke brukerkontekst i appen til å skreddersy svarene deres.
  • Når du angir en standardagent, gjengis ikke startmeldingene fra agenten.
  • Last updated on