Microsoft 365 Copilot aanpassen met een agent

Microsoft 365 Copilot in Power Apps kunnen gebruikers communiceren met aangepaste agents die uitbreiden wat Copilot kunnen doen. Door een agent aan te passen, kunt u op maat gemaakte ervaringen maken die passen bij de bedrijfsprocessen en gegevens van uw organisatie. Zie Agents gebruiken in Microsoft 365 Copilot voor meer informatie.

In dit artikel worden de typen agents beschreven die u kunt bouwen voor Microsoft 365 Copilot in Power Apps en helpt u bij het kiezen van de juiste benadering voor uw scenario.

Een agenttype kiezen

In de volgende tabel worden de agenttypen vergeleken die u kunt bouwen.

Agenttype Beschrijving Veelvoorkomende gebruiksvoorbeelden
Declaratieve agent Gebouwd met hulpprogramma's en sjablonen met weinig code voor snelle installatie van algemene scenario's in Microsoft 365 Copilot. Automatiseer routinetaken, beantwoord veelgestelde vragen en geef begeleide werkstromen.
Agent met aangepaste engine Gebouwd met aangepaste logica en integraties voor geavanceerde mogelijkheden die zijn afgestemd op uw bedrijf. Complexe bedrijfsprocessen, aangepaste gegevensintegraties en gespecialiseerde automatisering.
Copilot Studio agent Gebouwd en beheerd in Microsoft Copilot Studio, met integratie met Teams en Microsoft 365 voor gesprekservaringen. Interactieve chatbots, teamsamenwerking en persoonlijke ondersteuning binnen Microsoft 365-apps.

Gebruik deze resources om de beste optie voor uw organisatie te vinden:

Een manier om een declaratieve agent voor een modelgestuurde app te maken, is door Microsoft 365 Copilot rechtstreeks in uw app in te schakelen. Zie Uw app inschakelen voor Microsoft 365 Copilot voor meer informatie.

U kunt uw eigen app-specifieke agentmodus maken in Power Apps door een standaardagent te combineren met de Xrm.Copilot.* API's. De standaardagent definieert de op maat gemaakte Microsoft 365 Copilot-ervaring die wordt geopend voor gebruikers en de API's maken de bidirectionele verbinding tussen uw app en Microsoft 365 Copilot.

Een standaardagent instellen

Als u een aangepaste agent bouwt als aanvulling op uw modelgestuurde app, kunt u deze instellen als de standaardagent, zodat deze automatisch wordt geladen wanneer de app en het Microsoft 365 Copilot zijvenster worden geopend. Dit maakt uw agent het startpunt voor de ervaring en is het eerste deel van het bouwen van uw eigen agentmodus.

Wanneer u een standaardagent instelt:

  • Uw agent is geselecteerd zonder actie van de gebruiker.
  • Gebruikers gaan rechtstreeks naar de op maat gemaakte ervaring die u voor de app hebt ontworpen.
  • App-specifieke werkstromen en richtlijnen zijn gereed zodra Microsoft 365 Copilot wordt geopend.

Een standaardagent is vooral handig voor scenariogerichte agents die de kernervaring van de app uitbreiden en fungeren als de voordeur naar de app-specifieke Microsoft 365 Copilot ervaring die gebruikers moeten hebben.

Schermopname van het instellen van een standaardagent voor Microsoft 365 Copilot in uw modelgestuurde app.

Xrm.Copilot API's

Met de Xrm.Copilot.* client-API's kunnen ontwikkelaars Microsoft 365 Copilot rechtstreeks integreren in modelgestuurde app-ervaringen. Met deze API's kan uw app rechtstreeks communiceren met het Microsoft 365 Copilot zijvenster en reageren op Microsoft 365 Copilot gestuurde acties, zodat u uitgebreidere end-to-end agentische scenario's kunt maken.

Deze API's worden samen met een standaardagent gebruikt om het patroon van de agentmodus te voltooien: uw agent is het beginpunt, uw app kan prompts en context verzenden naar Microsoft 365 Copilot en Microsoft 365 Copilot acties in uw app kan aanroepen.

Zie Xrm.Copilot (client-API-verwijzing) in modelgestuurde apps voor het volledige API-gebied.

Met deze API's kunt u het volgende doen:

  • Prompts verzenden naar Microsoft 365 Copilot. Gebruik sendPromptToM365Copilot dit om een Microsoft 365 Copilot interactie vanuit uw app te starten.
  • Het Microsoft 365 Copilot zijvenster openen en beheren. Gebruik openM365CopilotPanel dit om ervoor te zorgen dat het deelvenster Microsoft 365 Copilot zichtbaar is wanneer dat nodig is.
  • Geef app-context door aan Microsoft 365 Copilot. Gebruik updateContext (preview) om extra onderbouwingssignalen vanuit uw app te verzenden.
  • Werk met agenten. Gebruik getCurrentAgent dit om te controleren welke agent actief is.
  • Microsoft 365 Copilot acties in uw app afhandelen. Gebruik addActionHandler om aangepaste handlers te registreren die acties verwerken die afkomstig zijn uit Microsoft 365 Copilot-antwoorden.

Samen maken deze API's een echte bidirectionele ervaring tussen de gebruikersinterface van de app en de agent, zodat agents ui-updates kunnen stimuleren, werkstromen kunnen activeren of aangepaste bedrijfslogica kunnen uitvoeren.

Microsoft 365 Copilot acties afhandelen met addActionHandler

Gebruik de addActionHandler API wanneer uw app gestructureerde acties moet verwerken die Microsoft 365 Copilot verzendt.

Wanneer u de payload van de actie opbouwt:

  • Stel type in op PowerApps om de hostomgeving van Power Apps als doel te gebruiken.
  • Stel action (bijvoorbeeld MyNamespace.MyMessage) in op de actionId die u registreert in addActionHandler.
  • Gebruik actionData voor de payload die uw code verwerkt en doorgeeft aan de Power Apps-host.

In de volgende secties ziet u twee ondersteunde scenario's.

Adaptieve kaarten (aanpasbare kaarten)

Microsoft 365 Copilot antwoorden kunnen Adaptieve kaarten bevatten met Action.Submit knoppen waarmee actieberichten naar de Power Apps host worden verzonden.

Voorbeeld:

{
  "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 antwoorden kunnen HTML bevatten waarmee actieberichten naar de Power Apps-host worden verzonden.

Voorbeeld:

<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

  • Agents die u ontwerpt, kunnen nog geen gebruikerscontext in de app gebruiken om hun reacties aan te passen.
  • Wanneer u een standaardagent instelt, worden de startersprompts van de agent niet weergegeven.
  • Last updated on