Anpassen von Microsoft 365 Copilot mit einem Agent

mit Microsoft 365 Copilot in Power Apps können Benutzer mit benutzerdefinierten Agents interagieren, die erweitern, was Copilot tun können. Durch anpassen eines Agents können Sie maßgeschneiderte Erfahrungen erstellen, die den Geschäftsprozessen und Daten Ihrer Organisation entsprechen. Weitere Informationen finden Sie unter Verwenden von Agents in Microsoft 365 Copilot.

In diesem Artikel werden die Arten von Agents beschrieben, die Sie für Microsoft 365 Copilot in Power Apps erstellen können, und hilft Ihnen bei der Auswahl des richtigen Ansatzes für Ihr Szenario.

Auswählen eines Agenttyps

In der folgenden Tabelle werden die Agenttypen verglichen, die Sie erstellen können.

Agenttyp	Beschreibung	Häufige Anwendungsfälle
Deklarativer Agent	Erstellt mit Low-Code-Tools und -Vorlagen für die schnelle Einrichtung gängiger Szenarien in Microsoft 365 Copilot.	Automatisieren Sie Routineaufgaben, beantworten Sie häufig gestellte Fragen und stellen Sie geführte Workflows bereit.
Benutzerdefinierter Engine-Agent	Mit benutzerdefinierter Logik und Integrationen entwickelt – für auf Ihr Unternehmen zugeschnittene erweiterte Funktionen.	Komplexe Geschäftsprozesse, benutzerdefinierte Datenintegrationen und spezialisierte Automatisierung.
Copilot Studio Agent	Erstellt und verwaltet in Microsoft Copilot Studio, mit Anbindung an Teams und Microsoft 365 für dialogorientierte Erlebnisse.	Interaktive Chatbots, Teamzusammenarbeit und personalisierter Support in Microsoft 365-Apps.

Verwenden Sie die folgenden Ressourcen, um die beste Option für Ihre Organisation zu finden:

Erhalten Sie eine Übersicht und Anleitungen zum Auswählen der Art des Agents, der in Microsoft 365 Copilot Agents erstellt werden soll.
Erstellen Sie einen deklarativen Agent für Microsoft 365 Copilot oder einen benutzerdefinierten Engine-Agent für Microsoft 365.
Verwenden Sie Microsoft Copilot Studio, um einen Agent für Teams zu verbinden und einzurichten, und Microsoft 365, damit er in Microsoft 365 Copilot verfügbar ist.
Lesen Sie die Anleitungen zum Auswählen zwischen Microsoft 365 Copilot und Copilot Studio, um Ihren Agent zu erstellen.

Eine Möglichkeit zum Erstellen eines deklarativen Agents für eine modellgesteuerte App besteht darin, Microsoft 365 Copilot direkt in Ihrer App zu aktivieren. Weitere Informationen finden Sie unter "Aktivieren Ihrer App für Microsoft 365 Copilot".

Sie können ihren eigenen appspezifischen Agent-Modus in Power Apps erstellen, indem Sie einen Standard-Agent mit den Xrm.Copilot.* APIs kombinieren. Der Standard-Agent definiert die angepasste Microsoft 365 Copilot Erfahrung, die für Benutzer geöffnet wird, und die APIs erstellen die bidirektionale Verbindung zwischen Ihrer App und Microsoft 365 Copilot.

Festlegen eines Standard-Agents

Wenn Sie einen benutzerdefinierten Agent als Begleitperson zu Ihrer modellgesteuerten App erstellen, können Sie ihn als Standard-Agent festlegen, sodass er automatisch geladen wird, wenn die App und der Microsoft 365 Copilot Seitenbereich geöffnet werden. Dies macht Ihren Agent zum Ausgangspunkt für die Erfahrung und ist der erste Teil des Erstellens Ihres eigenen Agent-Modus.

Wenn Sie einen Standard-Agent festlegen:

Ihr Agent wird ohne Aktion des Benutzers ausgewählt.
Benutzer gehen direkt auf die maßgeschneiderte Oberfläche, die Sie für die App entwickelt haben.
App-spezifische Workflows und Anleitungen sind bereit, sobald Microsoft 365 Copilot geöffnet wird.

Ein Standard-Agent ist besonders nützlich für szenarioorientierte Agents, die die Kernerfahrung der App erweitern und als Fronttür für die app-spezifische Microsoft 365 Copilot Benutzerumgebung fungieren.

Xrm.Copilot APIs

Mithilfe der Xrm.Copilot.* Client-APIs können Entwickler Microsoft 365 Copilot direkt in modellgesteuerte App-Oberflächen integrieren. Mit diesen APIs kann Ihre App direkt mit dem Microsoft 365 Copilot Seitenbereich interagieren und auf Microsoft 365 Copilot gesteuerten Aktionen reagieren, sodass Sie umfangreichere, end-to-End-Agent-Szenarien erstellen können.

Zusammen mit einem Standard-Agent schließen diese APIs das Agentmodusmuster ab: Ihr Agent ist der Ausgangspunkt, Ihre App kann Eingabeaufforderungen und Kontext in Microsoft 365 Copilot senden, und Microsoft 365 Copilot Aktionen zurück in Ihrer App aufrufen können.

Die vollständige API-Oberfläche finden Sie unter Xrm.Copilot (Client-API-Referenz) in modellgesteuerten Apps.

Diese APIs ermöglichen Folgendes:

Senden Sie Aufforderungen an Microsoft 365 Copilot. Verwenden Sie sendPromptToM365Copilot, um eine Microsoft 365 Copilot-Interaktion über Ihre App zu starten.
Öffnen und Steuern des Microsoft 365 Copilot Seitenbereichs. Verwenden Sie openM365CopilotPanel, um sicherzustellen, dass der Microsoft 365 Copilot-Bereich bei Bedarf sichtbar ist.
Übergeben Sie den App-Kontext an Microsoft 365 Copilot. Verwenden Sie updateContext (Vorschau), um zusätzliche Erdungssignale von Ihrer App zu senden.
Arbeiten Sie mit Agenten. Verwenden Sie getCurrentAgent diese Option, um zu überprüfen, welcher Agent aktiv ist.
Verwalten Sie Microsoft 365 Copilot-Aktionen in Ihrer App. Verwenden Sie addActionHandler, um benutzerdefinierte Handler zu registrieren, die Aktionen verarbeiten, die aus Antworten von Microsoft 365 Copilot gesendet werden.

Zusammen erstellen diese APIs eine echte bidirektionale Erfahrung zwischen der App-Benutzeroberfläche und dem Agent, sodass Agents UI-Updates steuern, Workflows auslösen oder benutzerdefinierte Geschäftslogik ausführen können.

Microsoft 365 Copilot-Aktionen mit addActionHandler verarbeiten

Verwenden Sie die addActionHandler API, wenn Ihre App strukturierte Aktionen verarbeiten muss, die Microsoft 365 Copilot ausgeben.

Beim Erstellen der Aktionsnutzlast:

Legen Sie type auf PowerApps fest, um den Power Apps Host als Ziel festzulegen.
Setzen Sie action (z. B. MyNamespace.MyMessage) auf die actionId, die Sie in addActionHandler registrieren.
Verwenden Sie actionData für die Nutzdaten, die Ihr Code verarbeitet und an den Power Apps-Host übergibt.

Die folgenden Abschnitte zeigen zwei unterstützte Szenarien.

Adaptive Karten

Antworten von Microsoft 365 Copilot können Adaptive Karten mit Action.Submit Schaltflächen enthalten, die Aktionsnachrichten an den Power Apps-Host senden.

Beispiel:

{
  "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 Antworten können HTML-Code enthalten, der Aktionsnachrichten an den host Power Apps sendet.

Beispiel:

<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 Sie erstellen, können den In-App-Benutzerkontext noch nicht verwenden, um ihre Antworten anzupassen.
Beim Festlegen eines Standard-Agenten werden die Start-Prompts des Agenten nicht angezeigt.

Feedback

War diese Seite hilfreich?

Last updated on 2026-07-15