Tilpas Microsoft Copilot med en agent

Microsoft Copilot i Power Apps kan brugerne 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 Copilot.

Denne artikel beskriver de typer agenter, du kan bygge til Microsoft Copilot i Power Apps, og hjælper dig med at vælge den rette fremgangsmåde 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 Copilot agentoversigt.
• Byg en deklarativ agent til Microsoft Copilot eller en brugerdefineret engine-agent 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 Copilot.
• Gennemse vejledningen til, hvordan du vælger mellem Microsoft 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 Copilot direkte i din app. Du kan få flere oplysninger under Aktivér din app for Microsoft 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 Copilot oplevelse, der åbnes for brugerne, og API'erne opretter den tovejsforbindelse mellem din app og Microsoft 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 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 Copilot åbnes.

En standardagent er især nyttig til scenariefokuserede agenter, der udvider appens kerneoplevelse og fungerer som hoveddøren til den appspecifikke Microsoft Copilot-oplevelse, som du ønsker, at brugerne får.

Xrm.Copilot API'er

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

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

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 Copilot. Brug sendPromptToM365Copilot til at starte en Microsoft Copilot interaktion fra din app.
• Åbn og styr den Microsoft Copilot siderude. Brug openM365CopilotPanel til at sikre, at ruden Microsoft Copilot er synlig, når det er nødvendigt.
• Overfør appkontekst til Microsoft 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 Microsoft Copilot handlinger i din app. Brug addActionHandler til at registrere brugerdefinerede handlere, der behandler handlinger, der er sendt fra Microsoft 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 Copilot handlinger med addActionHandler

Brug API'enaddActionHandler, når din app skal håndtere strukturerede handlinger, der Microsoft 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 Copilot svar kan omfatte Adaptive kort med Action.Submit knapper, der sender handlingsmeddelelser 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 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 Copilot for appbrugere i modeldrevne apps
• Brug Microsoft Copilot i modeldrevne apps
• Tilføj Microsoft Copilot for appbrugere i canvasapps (prøveversion)
• Brug Microsoft Copilot i canvasapps (prøveversion)
• Tilpas Microsoft Copilot med en agent i canvas apps