Tilpass Microsoft Copilot med en agent

Microsoft 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 Copilot.

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

Velg en agenttype

Tabellen nedenfor sammenligner agenttypene du kan bygge.

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

• Få en oversikt og veiledning om hvordan du velger hvilken type agent som skal bygges i Microsoft Copilot agentoversikt.
• Bygg en deklarativ agent for Microsoft Copilot eller en tilpasset motoragent for Microsoft 365.
• Bruk Microsoft Copilot Studio til å koble til og konfigurere en agent for Teams og Microsoft 365 slik at den er tilgjengelig i Microsoft Copilot.
• Se gjennom veiledningen for hvordan du velger mellom Microsoft Copilot og Copilot Studio for å bygge agenten din.

Én måte å opprette en deklarativ agent for en modelldrevet app på, er å slå på Microsoft Copilot direkte i appen. Hvis du vil ha mer informasjon, se Aktiver appen for Microsoft 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 Copilot opplevelsen som åpnes for brukere, og API-ene oppretter den toveis tilkoblingen mellom appen og Microsoft 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 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 Copilot starter.

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

Xrm.Copilot API-er

Klient-API-er Xrm.Copilot.* lar utviklere integrere Microsoft Copilot direkte i modelldrevne appopplevelser. Med disse API-ene kan appen samhandle direkte med Microsoft Copilot-sideruten og svare på handlinger utløst av Microsoft Copilot, slik at du kan opprette rikere, helhetlige agentbaserte scenarier.

Når du bruker disse API-ene med en standardagent, fullfører de agentmodusmønsteret: Agenten din er utgangspunktet, appen kan sende instrukser og kontekst til Microsoft Copilot, og Microsoft 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 instrukser til Microsoft Copilot. Bruk sendPromptToM365Copilot til å starte en Microsoft Copilot samhandling fra appen.
• Åpne og kontroller sideruten Microsoft Copilot. Bruk openM365CopilotPanel for å sikre at Microsoft Copilot-ruten er synlig ved behov.
• Overfør appkontekst til Microsoft 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 Copilot-handlinger i appen din. Bruk addActionHandler til å registrere egendefinerte behandlere som behandler handlinger som sendes fra Microsoft 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.

Håndter Microsoft Copilot-handlinger med addActionHandler

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

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 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 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.

Relatert informasjon

• Legg til Microsoft Copilot for appbrukere i modelldrevne apper
• Bruk Microsoft Copilot i modelldrevne apper
• Legg til Microsoft Copilot for appbrukere i lerretsapper (forhåndsvisning)
• Bruk Microsoft Copilot i canvas-apper (forhåndsversjon)
• Tilpass Microsoft Copilot med en agent i Canvas-apper