Microsoft Copilot mit einem Agenten anpassen

Mit Microsoft Copilot in Power Apps können Benutzer mit benutzerdefinierten Agents interagieren, die den Funktionsumfang von Copilot erweitern. 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 Copilot.

Dieser Artikel beschreibt die Arten von Agents, die Sie für Microsoft 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 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 Anleitung dazu, wie Sie auswählen, welche Art von Agent erstellt werden soll in der Übersicht Microsoft Copilot-Agents.
Erstellen Sie einen deklarativen Agent für Microsoft Copilot oder einen benutzerdefinierten Engine-Agent für Microsoft 365.
Verwenden Sie Microsoft Copilot Studio, um einen Agent für Teams und Microsoft 365 zu verbinden und einzurichten, damit er in Microsoft Copilot verfügbar ist.
Lesen Sie die Hinweise zum Auswählen zwischen Microsoft 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 Copilot direkt in Ihrer App zu aktivieren. Weitere Informationen finden Sie unter Aktivieren Ihrer App für Microsoft 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 Copilot-Erfahrung, die Benutzern angezeigt wird, und die APIs erstellen die bidirektionale Verbindung zwischen Ihrer App und Microsoft Copilot.

Festlegen eines Standard-Agents

Wenn Sie einen benutzerdefinierten Agent als Begleiter zu Ihrer modellgesteuerten App erstellen, können Sie ihn als Standard-Agent festlegen, damit er automatisch geladen wird, wenn die App und der Microsoft 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 Copilot geöffnet wird.

Ein Standard-Agent ist besonders nützlich für szenarioorientierte Agents, die die Kernfunktionalität der App erweitern und als zentraler Zugang zur app-spezifischen Microsoft Copilot-Erfahrung fungieren, die Sie Benutzern bereitstellen möchten.

Xrm.Copilot APIs

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

Wenn Sie diese APIs mit einem Standard-Agent verwenden, schließen sie das Agentmodusmuster ab: Ihr Agent ist der Ausgangspunkt, Ihre App kann Eingabeaufforderungen und Kontext an Microsoft Copilot senden, und Microsoft Copilot kann Aktionen in Ihrer App aufrufen.

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

Diese APIs ermöglichen Folgendes:

Senden Sie Prompts an Microsoft Copilot. Verwenden Sie sendPromptToM365Copilot, um eine Microsoft-Copilot-Interaktion aus Ihrer App zu starten.
Öffnen und steuern Sie die Microsoft Copilot-Seitenleiste. Verwenden Sie openM365CopilotPanel, um sicherzustellen, dass der Bereich Microsoft Copilot bei Bedarf sichtbar ist.
Übergeben Sie den App-Kontext an Microsoft 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.
Microsoft Copilot-Aktionen in Ihrer App verarbeiten. Verwenden Sie addActionHandler, um benutzerdefinierte Handler zu registrieren, die Aktionen verarbeiten, die in Microsoft Copilot-Antworten 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 Copilot-Aktionen mit addActionHandler behandeln

Verwenden Sie die addActionHandler API, wenn Ihre App strukturierte Aktionen verarbeiten muss, die Microsoft 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

Microsoft Copilot Antworten 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 Copilot Antworten können HTML-Code enthalten, der Aktionsnachrichten an den Power Apps Host 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?

Zuletzt aktualisiert um 2026-10-10