Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wichtig
MCP- und API-Plug-Ins stellen Aktionen in deklarativen Agents bereit. Es handelt sich nicht um eigenständige, installierbare Plugin-Pakete: Nur der enthaltende Agent kann auf seine Funktionen und Tools zugreifen. Informationen über die Beziehung zwischen Paket- und Aktionsmanifest finden Sie unter Plugins und deklarative Agent-Aktionen.
Tipp
Empfohlen: Beginnen Sie mit Work IQ Dev Tools für unterstützte Pro-Code-, deklarative Agent- und Plug-In-Szenarien. Siehe WIQD-Schnellstart. Toolkitbasierte Anweisungen bleiben für vorhandene Projekte und Workflows verfügbar, die sie erfordern. Überprüfen Sie die Unterstützung der Funktionen und der Zielerfahrung , bevor Sie ein Tool auswählen: WIQD ist nicht für benutzerdefinierte Engine-Agenten vorgesehen.
API-Plug-Ins ermöglichen es einem deklarativen Agenten, Ihre vorhandene REST-API aufzurufen. Verwenden Sie das Microsoft 365 Agents Toolkit , um ein Agentprojekt mit einer API-Aktionsintegration basierend auf der OpenAPI-Spezifikation Ihrer API zu erstellen.
Voraussetzungen
- Anforderungen unter Anforderungen für Copilot-Erweiterungsoptionen
- Eine vorhandene REST-API mit einer OpenAPI-Spezifikation (in dieser exemplarischen Vorgehensweise wird die Beispiel-API für die Budgetverfolgung verwendet)
- Visual Studio Code
- Microsoft 365 Agents Toolkit
Tipp
Um die besten Ergebnisse zu erzielen, stellen Sie sicher, dass Ihre OpenAPI-Spezifikation den Richtlinien folgt, die unter So machen Sie ein OpenAPI-Dokument bei der Erweiterung von Copilot effektiv beschrieben.
Um dieser Anleitung zu folgen, laden Sie die Budget-Tracker-Beispiel-API herunter, und konfigurieren Sie sie für die Ausführung auf Ihrem lokalen Entwicklungscomputer. Erstellen Sie das Beispiel mindestens einmal, um die BudgetTracker.json Datei für die API zu generieren.
Erstellen des Agents und des API-Plug-Ins
Hinweis
Die Screenshots und Verweise auf die Benutzeroberfläche in diesem Artikel verwenden eine Releaseversion des Microsoft 365 Agents Toolkit. Vorabversionen können von der dargestellten Benutzeroberfläche abweichen.
Die Konfiguration des API-Plug-Ins umfasst Folgendes:
- Die OpenAPI-Spezifikation für die REST-API.
- Ein Plug-in-Manifest , das auf die enthaltene OpenAPI-Spezifikation verweist und die verfügbaren Vorgänge, die Authentifizierungsmethode und die Antwortformate beschreibt.
Fügen Sie diese Dateien zusammen mit dem App-Manifest, der Agent-Definition und den Symbolen in das App-Paket des Agents ein. Das API-Plug-In-Manifest selbst ist kein installierbares Paket.
Öffne Visual Studio Code. Wenn Agents Toolkit noch nicht installiert ist, finden Sie Installationsanweisungen unter Installieren von Agents Toolkit .
Wählen Sie in der linken Aktivitätsleiste das Symbol "Microsoft 365 Agents Toolkit " aus.
Wählen Sie im Aufgabenbereich Agents-Toolkit die Option "Neue Agentin/App erstellen " aus.
Wählen Sie Deklarativer Agent aus.
Wählen Sie Aktion hinzufügen und dann Mit einem OpenAPI-Beschreibungsdokument starten aus.
Wählen Sie Durchsuchen aus, und navigieren Sie zum Speicherort der OpenAPI-Spezifikation aus dem Budget Tracker-Beispiel unter ./openapi/BudgetTracker.json.
Wählen Sie alle Vorgänge aus, die für das Plug-In aktiviert werden sollen.
Wählen Sie einen Standort für das Agentprojekt aus.
Geben Sie als Namen für das Agentprojekt ein
Budget Tracker.
Wenn Sie diese Schritte ausgeführt haben, generiert Agents Toolkit das Agent-Projekt und seine API-Plug-In-Konfiguration und öffnet das Projekt in einem neuen Visual Studio Code-Fenster.
Hinweis
Der Beweisschlüssel für den Codeaustausch (PKCE) ist standardmäßig aktiviert. Wenn Ihr Identitätsserver PKCE nicht unterstützt, deaktivieren Sie es, indem Sie die folgende Zeile zu m365agents.yml im Agentprojekt hinzufügen.
isPKCEEnabled: false
Bereitstellen und Querladen des Agents
Durch das Querladen werden der enthaltende Agent und seine API-Aktion für Entwicklungstests verfügbar gemacht. Das API-Plug-In wird nicht als eigenständige Funktion installiert. Diese Prozedur ist keine allgemeine Verteilungsmethode für ein komponiertes Plugin-Paket. Informationen zu Freigabe- und Veröffentlichungsrouten finden Sie unter Auswählen, wie Sie Ihr Plug-in veröffentlichen und verteilen möchten.
Öffne das Agent-Projekt in Visual Studio Code.
Wählen Sie in der linken Aktivitätsleiste das Symbol "Microsoft 365 Agents Toolkit " aus.
Wählen Sie im Bereich "Konten " die Option "Bei Microsoft 365 anmelden" aus. (Wenn Sie bereits angemeldet sind, fahren Sie mit dem nächsten Schritt fort.)
Vergewissern Sie sich, dass unter Ihrem Microsoft 365-Konto sowohl benutzerdefinierter App-Upload aktiviert als auch Copilot-Zugriff aktiviert angezeigt werden. Wenn dies nicht der Fall ist, wenden Sie sich an den Administrator Ihrer organization. Weitere Informationen finden Sie unter Anforderungen für Copilot-Erweiterungsoptionen.
Wählen Sie im Bereich "Lebenszyklus " die Option "Bereitstellen" aus.
Wenn Sie aufgefordert werden, die Client-ID für die OAuth-Registrierung einzugeben, geben Sie Ihre Plug-in-Client-ID ein.
Wenn Sie aufgefordert werden, den geheimen Clientschlüssel für die OAuth-Registrierung einzugeben, geben Sie Ihren geheimen Plug-In-Clientschlüssel ein.
Lesen Sie die Meldung im Dialogfeld, und wählen Sie "Bestätigen " aus, um fortzufahren.
Warten Sie, bis das Toolkit meldet, dass die Bereitstellung abgeschlossen ist.
Ihr Agent steht jetzt zum Testen mit Ihrem Benutzerkonto in Microsoft 365 Copilot in Microsoft Teams zur Verfügung.
Testen der API-Aktion des Agents
Öffnen Sie Teams in Ihrem Browser und melden Sie sich mit dem Microsoft 365-Konto an, das Sie zum Querladen Ihres Agents verwendet haben.
Wählen Sie in der linken Aktivitätsleiste "Chat" aus.
Wählen Sie Copilot im Chat-Bereich aus.
Wählen Sie auf der rechten Seite in der Liste der Agents die Option Budget-Tracker aus. Wenn die Liste nicht verfügbar ist, wählen Sie das Symbol "Copilot-Chats und mehr " in der oberen rechten Ecke aus.
Stellen Sie eine Frage zu Budgets. Versuchen Sie zum Beispiel .
How much is left in the Fourth Coffee lobby renovation budget?Wenn Sie dazu aufgefordert werden, wählen Sie "Immer zulassen " oder "Einmal zulassen " aus, um fortzufahren.Wenn Sie zur Anmeldung aufgefordert werden, wählen Sie Bei Budgettracker anmelden aus.