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.

Type af agent Beskrivende tekst Almindelige use cases
Deklarativ agent Bygget med værktøjer og skabeloner med lavt kodeformat til hurtig konfiguration af almindelige scenarier i Microsoft 365 Copilot. Automatiser rutineopgaver, besvar ofte stillede spørgsmål, og angiv automatiserede arbejdsprocesser.
Brugerdefineret programagent Bygget med brugerdefineret logik og integrationer til avancerede funktioner, der er skræddersyet til din virksomhed. Komplekse forretningsprocesser, brugerdefinerede dataintegrationer og specialiseret automatisering.
Copilot Studio agent Bygget og administreret i Microsoft Copilot Studio med integration i Teams og Microsoft 365 til samtaleoplevelser. Interaktive chatrobots, teamsamarbejde og tilpasset support i Microsoft 365-apps.

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

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

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 med Copilot og reagere på Copilot-drevne handlinger, så du kan oprette mere omfattende og komplette agentiske scenarier.

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

Med disse API'er kan du:

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

Tilsammen forbinder disse API'er Copilot svar tilbage til din applogik, så agenter kan køre opdateringer af brugergrænsefladen, udløse arbejdsprocesser eller køre brugerdefineret forretningslogik.

Håndter Copilot handlinger med addActionHandler

Brug API'enaddActionHandler, når din app skal håndtere strukturerede handlinger, der 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

Copilot-svar kan indeholde Adaptive kort med Action.Submit-knapper, der sender handlingsbeskeder til værtsprogrammet til Power Apps.

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

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>

Indstil en standardagent

Hvis du opretter en brugerdefineret agent som en ledsager til din modeldrevne app, kan du angive den som standardagent, så den indlæses automatisk, når appen og Copilot siderude åbnes.

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 Copilot åbnes.

En standardagent er især nyttig til scenariefokuserede agenter, der udvider appens kerneoplevelse.

Skærmbillede, der viser, hvordan du angiver en standardagent for Microsoft 365 Copilot i din modeldrevne app.

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.
  • Last updated on