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, eine REST-API aufzurufen. Verwenden Sie das Microsoft 365 Agents Toolkit , um ein Agent-Projekt, ein API-Plug-In-Manifest und eine REST-API-Implementierung als Ausgangspunkt zu generieren.
- Anforderungen unter Anforderungen für Copilot-Erweiterungsoptionen
- Visual Studio Code
- Microsoft 365 Agents Toolkit
-
Node.js 20.x oder 22.x. Um Ihre installierte Version zu bestätigen, führen Sie aus
node --version.
Erstellen des Agents und der API
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.
Ö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 neuer API starten aus.
Wählen Sie OAuth als Authentifizierungstyp aus.
Wählen Sie Ihre bevorzugte Programmiersprache aus: JavaScript oder TypeScript. Diese Anleitung setzt TypeScript voraus.
Wählen Sie einen Standort für das Agentprojekt aus.
Geben Sie als Namen für Ihr Agentprojekt ein
Repairs Agent.
Wenn Sie diese Schritte ausgeführt haben, generiert Agents Toolkit die Agent- und API-Projektdateien, einschließlich des API-Plug-In-Manifests, und öffnet das Projekt in einem neuen Visual Studio Code-Fenster. Details finden Sie in der README.md Datei im Stammverzeichnis des generierten Projekts.
Ausführen der API und Querladen des Agents
Wählen Sie im Visual Studio Code-Fenster, während das Agent-Projekt geladen ist, das Microsoft 365 Agents Toolkit-Symbol in der linken Aktivitätsleiste 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 das Symbol Ausführen und Debuggen in der linken Aktivitätsleiste.
Wählen Sie entweder Debuggen in Copilot (Edge) oder Debuggen in Copilot (Chrome) aus, und drücken Sie dann F5 , um das Debuggen zu starten.
Agents Toolkit erstellt das Projekt, erstellt ein App-Paket, das den Agent und seine API-Plug-In-Konfiguration enthält, und lädt den Agent quergeladen für Ihr Benutzerkonto. Außerdem wird die API lokal gestartet. Für die Microsoft Teams-App öffnet sich ein neues Browserfenster.
Testen der API-Aktion des Agents
Wählen Sie in Microsoft Teams in Ihrem Browser Copilot aus.
Wählen Sie in der Agentenliste auf der rechten Seite die Option Reparieren Agentlocal . Wenn die Liste nicht verfügbar ist, wählen Sie das Symbol "Copilot-Chats und mehr " in der oberen rechten Ecke aus.
Senden Sie eine Nachricht zur Reparatur an Copilot. Versuchen Sie zum Beispiel .
Which repairs are assigned to Karin?
An diesem Punkt wird die REST-API lokal auf Ihrem Entwicklungscomputer ohne Authentifizierung ausgeführt. Stellen Sie die API in Azure bereit, um eine Authentifizierung hinzuzufügen.
Bereitstellen in Azure und Aktivieren der Authentifizierung
Wählen Sie in der linken Aktivitätsleiste das Symbol "Microsoft 365 Agents Toolkit " aus.
Wählen Sie im Bereich "Lebenszyklus " die Option "Bereitstellen" aus.
Wenn Sie nach einem Ressourcengruppennamen gefragt werden, übernehmen Sie entweder den Standardwert, oder ändern Sie ihn nach Bedarf, und drücken Sie die EINGABETASTE.
Wählen Sie einen Standort für die Ressourcengruppe aus.
Überprüfen Sie die Meldung im Dialogfeld. Wenn alles richtig aussieht, wählen Sie Bereitstellen , um fortzufahren.
Warten Sie, bis die Bereitstellungsschritte abgeschlossen sind, und wählen Sie dann im Bereich "Lebenszyklus" die Option "Bereitstellen" aus.
Wenn Sie diese Schritte ausführen, stellen Sie die REST-API als Azure-Funktion mit Authentifizierung bereit. Der Agent ruft die gehostete API über seine API-Plug-In-Konfiguration auf.
Testen des Agents mit der authentifizierten API
Wählen Sie in Microsoft Teams in Ihrem Browser Copilot aus.
Wählen Sie in der Liste Agenten auf der rechten Seite die Option Repairs Agentdev .
Senden Sie eine Nachricht zur Reparatur an Copilot. Versuchen Sie zum Beispiel .
Which repairs are assigned to Issac?