Tilpas Microsoft 365 Copilot med en agent

Microsoft 365 Copilot i Power Apps giver brugerne mulighed for at interagere med brugerdefinerede agenter, der udvider det, Copilot kan gøre. Ved at tilpasse en agent kan du oprette skræddersyede oplevelser, der passer til din organisations forretningsprocesser og data. Du kan få flere oplysninger under Brug agenter i Microsoft 365 Copilot.

I denne artikel beskrives de typer agenter, du kan bygge til Microsoft 365 Copilot i Power Apps, og hjælper dig med at vælge den rigtige tilgang til dit scenarie.

Vælg en agenttype

I følgende tabel sammenlignes de agenttyper, du kan oprette.

Hvis du vil finde den bedste løsning for din organisation, skal du bruge disse ressourcer:

• Få en oversigt og vejledning til, hvordan du vælger, hvilken type agent der skal bygges i Microsoft 365 Copilot agentoversigt.
• Byg en deklarativ agent til Microsoft 365 Copilot eller en brugerdefineret programagent til Microsoft 365.
• Brug Microsoft Copilot Studio til at oprette forbindelse til og konfigurere en agent til Teams og Microsoft 365, så den er tilgængelig i Microsoft 365 Copilot.
• Gennemse vejledningen til, hvordan du vælger mellem Microsoft 365 Copilot og Copilot Studio for at bygge din agent.

En måde at oprette en deklarativ agent for en modeldrevet app på er ved at aktivere Microsoft 365 Copilot direkte i din app. Du kan få flere oplysninger under Aktivér din app for Microsoft 365 Copilot.

Du kan oprette din egen appspecifikke agenttilstand i Power Apps ved at kombinere en standardagent med Xrm.Copilot.* API'erne. Standardagenten definerer den tilpassede Microsoft 365 Copilot oplevelse, der åbnes for brugerne, og API'erne opretter den tovejsforbindelse mellem din app og Microsoft 365 Copilot.

Indstil en standardagent

Hvis du opretter en brugerdefineret agent som ledsager til din modeldrevne app, kan du angive den som standardagent, så den indlæses automatisk, når appen og Microsoft 365 Copilot siderude åbnes. Dette gør din agent til udgangspunktet for oplevelsen og er den første del af opbygningen af din egen agenttilstand.

Når du angiver en standardagent:

• Din agent vælges uden nogen handling fra brugeren.
• Brugerne går direkte til den skræddersyede oplevelse, du har designet til appen.
• Appspecifikke arbejdsprocesser og vejledninger er klar, så snart Microsoft 365 Copilot åbnes.

En standardagent er især nyttig til scenariefokuserede agenter, der udvider kerneoplevelsen af appen og fungerer som hoveddøren til den appspecifikke Microsoft 365 Copilot oplevelse, som brugerne skal have.

Xrm.Copilot API'er

Klient-API'erne Xrm.Copilot.* giver udviklere mulighed for at integrere Microsoft 365 Copilot direkte i modeldrevne appoplevelser. Med disse API'er kan din app interagere direkte med Microsoft 365 Copilot siderude og reagere på Microsoft 365 Copilot-drevne handlinger, så du kan oprette mere omfattende, komplette agentiske scenarier.

Når disse API'er bruges sammen med en standardagent, fuldfører de agenttilstandsmønsteret: Din agent er udgangspunktet, din app kan sende prompter og kontekst til Microsoft 365 Copilot, og Microsoft 365 Copilot kan aktivere handlinger tilbage i din app.

Du kan se hele API-overfladen under Xrm.Copilot (klient-API-reference) i modeldrevne apps.

Med disse API'er kan du:

• Send prompter til Microsoft 365 Copilot. Bruges sendPromptToM365Copilot til at starte en Microsoft 365 Copilot interaktion fra din app.
• Åbn og kontrollér Microsoft 365 Copilot-sideruden. Bruges openM365CopilotPanel til at sikre, at ruden Microsoft 365 Copilot er synlig, når det er nødvendigt.
• Overfør appkontekst til Microsoft 365 Copilot. Brug updateContext (prøveversion) til at sende ekstra jordforbindelsessignaler fra din app.
• Arbejd med agenter. Bruges getCurrentAgent til at kontrollere, hvilken agent der er aktiv.
• Håndter handlinger i Microsoft 365 Copilot i din app. Bruges addActionHandler til at registrere brugerdefinerede handlere, der behandler handlinger, der er sendt fra Microsoft 365 Copilot svar.

Tilsammen skaber disse API'er en ægte tovejsoplevelse mellem appbrugergrænsefladen og agenten, så agenter kan køre opdateringer af brugergrænsefladen, udløse arbejdsprocesser eller køre brugerdefineret forretningslogik.

Håndter Microsoft 365 Copilot handlinger med addActionHandler

Brug API'enaddActionHandler, når din app skal håndtere strukturerede handlinger, der Microsoft 365 Copilot udsender.

Når du opbygger handlingsnyttelasten:

• Angiv type til PowerApps for at målrette Power Apps-værten.
• Angiv action (f.eks. ) til det actionId, MyNamespace.MyMessagedu registrerer i addActionHandler.
• Brug actionData til de nyttedata, som din kode behandler og sender til Power Apps-værten.

I følgende afsnit vises to understøttede scenarier.

Adaptive kort

Microsoft 365 Copilot-svar kan indeholde Adaptive kort med knapperne Action.Submit, der sender handlingsbeskeder til Power Apps-værten.

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

Microsoft 365 Copilot svar kan omfatte HTML, der sender handlingsmeddelelser til den Power Apps vært.

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>

Begrænsninger

• Agenter, du opretter, kan endnu ikke bruge brugerkontekst i appen til at skræddersy deres svar.
• Når du angiver en standardagent, gengives starterprompten ikke fra agenten.

Relaterede oplysninger

• Tilføj Microsoft 365 Copilot for appbrugere i modeldrevne apps
• Brug Microsoft 365 Copilot i modeldrevne apps
• Tilføj Microsoft 365 Copilot for appbrugere i Canvas-apps (Prøveversion)
• Brug Microsoft 365 Copilot i canvas-apps (forhåndsvisning)
• Tilpas Microsoft 365 Copilot med en agent i lærredapps