Anpassa Microsoft Copilot med en agent

Microsoft 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änd agenter i Microsoft Copilot.

Den här artikeln beskriver de typer av agenter som du kan skapa för Microsoft 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 Copilot agentöversikt.
• Skapa en deklarativ agent för Microsoft 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 Copilot.
• Läs vägledningen om hur du väljer mellan Microsoft 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 Copilot direkt i din app. Mer information finns i Aktivera din app för Microsoft 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 Copilot upplevelse som öppnas för användare och API:erna skapar den dubbelriktade anslutningen mellan din app och Microsoft 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 sidopanelen i Microsoft Copilot ö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 Copilot startar.

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 Copilot upplevelse som du vill att användarna ska ha.

Xrm.Copilot API:er

Med Xrm.Copilot.* klient-API:erna kan utvecklare integrera Microsoft Copilot direkt i modellbaserade appupplevelser. Med dessa API:er kan din app interagera direkt med Microsoft Copilots sidofönster och svara på Microsoft Copilot-drivna åtgärder, så att du kan skapa mer omfattande, heltäckande agentiska scenarier.

När du använder dessa API:er med en standardagent slutför de agentlägesmönstret: din agent är startpunkten, appen kan skicka uppmaningar och kontext till Microsoft Copilot och Microsoft 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 meddelanden till Microsoft Copilot. Använd sendPromptToM365Copilot för att starta en Microsoft Copilot interaktion från din app.
• Öppna och hantera Microsoft Copilot sidofönstret. Använd openM365CopilotPanel för att se till att fönstret Microsoft Copilot visas när det behövs.
• Skicka appkontexten till Microsoft 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 Copilot åtgärder i din app. Använd addActionHandler för att registrera anpassade hanterare som bearbetar åtgärder som skickas från Microsoft 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 Copilot åtgärder med addActionHandler

Använd API:et addActionHandler när din app behöver hantera strukturerade åtgärder som Microsoft 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 Copilot svar kan innehålla Adaptive Cards med Action.Submit knappar som skickar åtgärdsmeddelanden till Power Apps-värden.

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 Copilot svar kan innehålla HTML som skickar åtgärdsmeddelanden till Power Apps-värden.

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 Copilot för appanvändare i modelldrivna appar
• Använda Microsoft Copilot i modelldrivna appar
• Lägg till Microsoft Copilot för appanvändare i arbetsyteappar (förhandsversion)
• Använd Microsoft Copilot i canvasappar (förhandsversion)
• Anpassa Microsoft Copilot med en agent i arbetsyteappar