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:

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

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 mit Copilot interagieren und auf Copilot-gesteuerte Aktionen reagieren, sodass Sie umfangreichere, end-to-End-Agent-Szenarien erstellen 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 Copilot. Verwenden Sie sendPromptToM365Copilot, um über Ihre App eine Copilot-Interaktion zu starten.
  • Öffnen und steuern Sie den Copilot-Seitenbereich. Verwenden Sie openM365CopilotPanel, um sicherzustellen, dass der Copilot-Bereich bei Bedarf sichtbar ist.
  • Übergeben Sie den App-Kontext an 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 Copilot-Aktionen in Ihrer App. Verwenden Sie addActionHandler, um benutzerdefinierte Handler zu registrieren, die Aktionen verarbeiten, die in Copilot-Antworten gesendet werden.

Zusammen verbinden diese APIs Copilot Antworten wieder in Ihre App-Logik, sodass Agents UI-Updates steuern, Workflows auslösen oder benutzerdefinierte Geschäftslogik ausführen können.

Copilot-Aktionen mit addActionHandler behandeln

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

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

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>

Festlegen eines Standard-Agents

Wenn Sie einen benutzerdefinierten Agent als Begleitperson zu Ihrer modellgesteuerten App erstellen, können Sie ihn als Standard-Agent festlegen, damit er automatisch geladen wird, wenn die App und der Copilot Seitenbereich geöffnet werden.

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 Copilot geöffnet werden.

Ein Standard-Agent ist besonders nützlich für szenarioorientierte Agents, die die Kernerfahrung der App erweitern.

Screenshot, der zeigt, wie Sie einen Standard-Agent für Microsoft 365 Copilot in Ihrer modellgesteuerten App festlegen.

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