Microsoft Copilot aanpassen met een agent

Microsoft Copilot in Power Apps laat gebruikers communiceren met aangepaste agents die de mogelijkheden van Copilot uitbreiden. 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 Copilot voor meer informatie.

In dit artikel worden de typen agents beschreven die u kunt bouwen voor Microsoft Copilot in Power Apps en wordt u geholpen 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 low-codehulpmiddelen en sjablonen voor snelle configuratie van algemene scenario's in Microsoft 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:

Bekijk een overzicht en richtlijnen voor het kiezen van het type agent dat moet worden gebouwd in Microsoft Copilot agentsoverzicht.
Bouw een declaratieve agent voor Microsoft Copilot of een aangepaste engineagent voor Microsoft 365.
Gebruik Microsoft Copilot Studio om verbinding te maken en een agent in te stellen voor Teams en Microsoft 365 zodat deze beschikbaar is in Microsoft Copilot.
Bekijk de richtlijnen voor het kiezen tussen Microsoft Copilot en Copilot Studio om uw agent te bouwen.

Een manier om een declaratieve agent voor een modelgestuurde app te maken, is door Microsoft Copilot rechtstreeks in uw app in te schakelen. Zie Uw app inschakelen voor Microsoft 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 Copilot-ervaring die voor gebruikers wordt geopend en de API's maken de bidirectionele verbinding tussen uw app en Microsoft 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 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 Copilot opent.

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 Copilot-ervaring die u gebruikers wilt bieden.

Xrm.Copilot API's

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

Wanneer u deze API's gebruikt met een standaardagent, voltooien ze het patroon van de agentmodus: uw agent is het startpunt, uw app kan prompts en context verzenden naar Microsoft Copilot en Microsoft Copilot kan weer acties binnen uw app aanroepen.

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

Met deze API's kunt u het volgende doen:

Verzend prompts naar Microsoft Copilot. Gebruik sendPromptToM365Copilot om een Microsoft Copilot interactie vanuit uw app te starten.
Open en beheer het Microsoft Copilot-zijvenster. Gebruik openM365CopilotPanel dit om ervoor te zorgen dat het deelvenster Microsoft Copilot zichtbaar is wanneer dat nodig is.
Geef app-context door aan Microsoft 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 Copilot-acties in uw app afhandelen. Gebruik addActionHandler om aangepaste handlers te registreren waarmee acties worden verwerkt die worden verzonden vanuit Microsoft 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 Copilot acties verwerken met addActionHandler

Gebruik de addActionHandler API wanneer uw app gestructureerde acties moet verwerken die Microsoft 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 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 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.

Feedback

Is deze pagina nuttig?

Laatst bijgewerkt om 2026-10-10