Anpassa Microsoft 365 Copilot med en agent

Microsoft 365 Copilot i Power Apps låter användare interagera med anpassade agenter som utökar vad Copilot kan göra. Genom att anpassa en agent kan du skapa skräddarsydda upplevelser som passar organisationens affärsprocesser och data. Mer information finns i Använda agenter i Microsoft 365 Copilot.

Den här artikeln beskriver de typer av agenter som du kan skapa för Microsoft 365 Copilot i Power Apps och hjälper dig att välja rätt metod för ditt scenario.

Välj en agenttyp

I följande tabell jämförs de agenttyper som du kan skapa.

Använd följande resurser för att hitta det bästa alternativet för din organisation:

• Få en översikt och vägledning om hur du väljer vilken typ av agent som ska skapas i Microsoft 365 Copilot agentöversikt.
• Skapa en deklarativ agent för Microsoft 365 Copilot eller en anpassad motoragent för Microsoft 365.
• Använd Microsoft Copilot Studio för att ansluta och konfigurera en agent för Teams och Microsoft 365 så att den är tillgänglig i Microsoft 365 Copilot.
• Läs vägledningen om hur du väljer mellan Microsoft 365 Copilot och Copilot Studio för att skapa din agent.

Ett sätt att skapa en deklarativ agent för en modelldriven app är att aktivera Microsoft 365 Copilot direkt i din app. Mer information finns i Aktivera din app för Microsoft 365 Copilot.

Du kan skapa ett eget appspecifikt agentläge i Power Apps genom att kombinera en standardagent med API:ernaXrm.Copilot.*. Standardagenten definierar den skräddarsydda Microsoft 365 Copilot upplevelse som öppnas för användare, och API:erna skapar den dubbelriktade anslutningen mellan din app och Microsoft 365 Copilot.

Ange en standardagent

Om du skapar en anpassad agent som en följeslagare till din modelldrivna app kan du ange den som standardagent så att den läses in automatiskt när appen och fönstret på Microsoft 365 Copilot sida öppnas. Detta gör din agent till startpunkten för upplevelsen och är den första delen av att skapa ditt eget agentläge.

När du anger en standardagent:

• Din agent har valts utan någon åtgärd från användaren.
• Användarna går direkt till den skräddarsydda upplevelse som du har utformat för appen.
• Appspecifika arbetsflöden och vägledningar är klara så snart Microsoft 365 Copilot öppnas.

En standardagent är särskilt användbar för scenariofokuserade agenter som utökar appens kärnupplevelse och fungerar som ytterdörr till den appspecifika Microsoft 365 Copilot upplevelse som du vill att användarna ska ha.

Xrm.Copilot API:er

Med Xrm.Copilot.* klient-API:erna kan utvecklare integrera Microsoft 365 Copilot direkt i modelldrivna appupplevelser. Med dessa API:er kan din app interagera direkt med sidofönstret i Microsoft 365 Copilot och svara på åtgärder som drivs av Microsoft 365 Copilot, så att du kan skapa rikare, heltäckande agentscenarier.

Dessa API:er används tillsammans med en standardagent och fyller i agentlägesmönstret: din agent är startpunkten, appen kan skicka frågor och kontext till Microsoft 365 Copilot och Microsoft 365 Copilot kan anropa åtgärder i appen igen.

Fullständig API-yta finns i Xrm.Copilot (klient-API-referens) i modelldrivna appar.

Med dessa API:er kan du:

• Skicka uppmaningar till Microsoft 365 Copilot. Använd sendPromptToM365Copilot för att starta en Microsoft 365 Copilot interaktion från din app.
• Öppna och kontrollera Microsoft 365 Copilot sidofönstret. Använd openM365CopilotPanel för att se till att fönstret Microsoft 365 Copilot visas när det behövs.
• Skicka appkontexten till Microsoft 365 Copilot. Använd updateContext (förhandsversion) för att skicka extra jordningssignaler från din app.
• Arbeta med agenter. Använd getCurrentAgent för att kontrollera vilken agent som är aktiv.
• Hantera Microsoft 365 Copilot åtgärder i din app. Använd addActionHandler för att registrera anpassade hanterare som bearbetar åtgärder som skickas från Microsoft 365 Copilot svar.

Tillsammans skapar dessa API:er en sann dubbelriktad upplevelse mellan appens användargränssnitt och agenten, så att agenter kan köra uppdateringar av användargränssnittet, utlösa arbetsflöden eller köra anpassad affärslogik.

Hantera Microsoft 365 Copilot åtgärder med addActionHandler

Använd API:et addActionHandler när din app behöver hantera strukturerade åtgärder som Microsoft 365 Copilot genererar.

När du skapar åtgärdsnyttolasten:

• Ställ in type på PowerApps för att rikta mot Power Apps-värden.
• Ange action (till exempel MyNamespace.MyMessage) till det actionId som du registrerar i addActionHandler.
• Använd actionData för de data som koden bearbetar och skickar vidare till Power Apps-värden.

Följande avsnitt visar två scenarier som stöds.

Adaptiva kort

Microsoft 365 Copilot-svaren kan innehålla Adaptive Cards med knapparna Action.Submit, som skickar åtgärdsmeddelanden till värdprogrammet i Power Apps.

Exempel:

{
  "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-appar

Microsoft 365 Copilot-svar kan innehålla HTML som kan skicka åtgärdsmeddelanden till värdprogrammet för Power Apps.

Exempel:

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

Limitations

• Agenter som du skapar kan ännu inte använda användarkontexten i appen för att skräddarsy deras svar.
• När du ställer in en standardagent renderas inte startprompterna från agenten.

Relaterad information

• Lägg till Microsoft 365 Copilot för appanvändare i modelldrivna appar
• Använd Microsoft 365 Copilot i modelldrivna appar
• Lägg till Microsoft 365 Copilot för appanvändare i canvas-appar (förhandsversion)
• Använd Microsoft 365 Copilot i canvas-appar (förhandsversion)
• Anpassa Microsoft 365 Copilot med hjälp av en agent i canvasappar