Erstellen von Plug-Ins von einem MCP-Server für Microsoft 365 Copilot (Vorschau)

Dieser Leitfaden führt Sie durch den Prozess der Integration Ihres Diensts in Microsoft 365 Copilot durch Hinzufügen eines MCP-Servers zu einem deklarativen Agent mithilfe des Microsoft 365 Agents Toolkit. Indem Sie diese Schritte ausführen, aktivieren Sie den konversationsbasierten, KI-gestützten Zugriff auf Ihre MCP-verfügbaren Dienste für Geschäftsbenutzer.

Wichtig

Dieses Feature ist derzeit in Public Preview.

Voraussetzungen

• Unter Anforderungen für Copilot-Erweiterbarkeitsoptionen angegebene Anforderungen
• Ein GitHub-Konto
• Visual Studio Code
• Microsoft 365 Agents Toolkit , Version 6.3.x oder höher

Erstellen des Agents

1. Öffnen Sie Visual Studio Code, und wählen Sie in der linken Aktivitätsleiste das Symbol Microsoft 365 Agents Toolkit aus.

2. Wählen Sie im Aufgabenbereich Agents Toolkit die Option Create a New Agent/App (Neuen Agent/Neue App erstellen) aus.

   

3. Wählen Sie Deklarativer Agent aus.

4. Wählen Sie Aktion hinzufügen und dann Mit einem MCP-Server starten aus.

5. Geben Sie die GitHub MCP-Server-URL https://api.githubcopilot.com/mcp/ein.

   

6. Wählen Sie einen Speicherort für das Agent-Projekt aus.

7. Geben Sie einen Namen für den Agent ein.

Nachdem Sie diese Schritte ausgeführt haben, generiert das Agents Toolkit die erforderlichen Dateien für den Agent und öffnet ein neues Visual Studio Code-Fenster mit geladenem Agent-Projekt.

Hinzufügen von Tools vom MCP-Server

1. Öffnen Sie die Datei .vscode/mcp.json . Wählen Sie im Datei-Editor die Schaltfläche Start aus.

2. Wenn Sie zur Authentifizierung aufgefordert werden, wählen Sie Die Authentifizierung zulassen aus.

3. Wählen Sie im Datei-Editor die Schaltfläche ATK: Aktion aus MCP abrufen aus, und wählen Sie dann ai-plugin.json aus.

   

4. Wählen Sie Vorgänge aus, die der Agent verwenden soll. Wählen Sie für diese Übung search_repositories und search_users aus.

   

   Wichtig

   Es werden nur Tools von MCP-Servern unterstützt.

5. Wählen Sie OAuth (mit statischer Registrierung) als Authentifizierungstyp aus.

   

Registrieren einer OAuth-App bei GitHub

1. Wechseln Sie in Ihrem Browser zu https://github.com/settings/developers . Wählen Sie OAuth-Apps und dann Neue OAuth-App aus.

2. Fügen Sie einen Namen und eine Homepage-URL für Ihre App hinzu, und legen Sie als Autorisierungsrückruf-URL festhttps://teams.microsoft.com/api/platform/v1.0/oAuthRedirect. Wählen Sie Anwendung registrieren aus.

3. Nachdem die App erstellt wurde, wählen Sie Neuen geheimen Clientschlüssel generieren aus. Kopieren Sie das Geheimnis und die Client-ID , die im nächsten Abschnitt verwendet werden sollen.

Packen und Querladen des Agents

1. Öffnen Sie das Agent-Projekt in Visual Studio Code.

2. Wählen Sie in der linken Aktivitätsleiste das Symbol Microsoft 365 Agents Toolkit aus.

3. 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.

4. Vergewissern Sie sich, dass sowohl benutzerdefinierter App-Upload aktiviert als auch Copilot-Zugriff aktiviert unter Ihrem Microsoft 365-Konto angezeigt werden. Wenn dies nicht der Fall ist, wenden Sie sich an Ihren organization Administrator. Ausführliche Informationen finden Sie unter Anforderungen für Copilot-Erweiterbarkeitsoptionen.

5. Wählen Sie im Bereich Lebenszyklus die Option Bereitstellen aus.

6. Wenn Sie zur Eingabe der Client-ID für die OAuth-Registrierung aufgefordert werden, geben Sie Ihre Client-ID ein.

7. Wenn Sie zur Eingabe des geheimen Clientschlüssels für die OAuth-Registrierung aufgefordert werden, geben Sie Ihren geheimen Clientschlüssel ein.

8. Wenn Sie nach Bereichen gefragt werden, drücken Sie die EINGABETASTE , um fortzufahren.

9. Lesen Sie die Nachricht im Dialogfeld, und wählen Sie Bestätigen aus, um den Vorgang fortzusetzen.

10. Warten Sie, bis das Toolkit meldet, dass die Bereitstellung abgeschlossen ist.

Wichtig

Während sich dieses Feature in der öffentlichen Vorschau befindet, kann die Manifestüberprüfung für Funktionsparameter in den folgenden Fällen fehlschlagen.

• Geschachtelte Objekte im properties Member
• Eigenschaften im properties Member mit den Membern minimum, maximumoder default vorhanden

Wenn der Schritt während der teamsApp/validateAppPackage Bereitstellung fehlschlägt, entfernen Sie die nicht unterstützten Mitglieder, und wiederholen Sie den Bereitstellungsschritt.

Verwenden des Agents

1. Navigieren Sie in Ihrem Browser zu https://m365.cloud.microsoft/chat.

2. Suchen Sie auf der Randleiste im Abschnitt Agents nach Ihrem Agent. Er wird als Der Name aufgeführt, den Sie im Abschnitt Agent erstellen angegeben haben, wobei dev am Ende angefügt wird. Wählen Sie den Agent aus.

3. Bitten Sie den Agent, ein Repository oder einen Benutzer zu finden. Beispiel: can you find a repo for kiota?.

4. Wenn Sie dazu aufgefordert werden, wählen Sie Bei {agent-name} anmelden aus. Melden Sie sich im Popupfenster mit Ihrem GitHub-Konto an, und autorisieren Sie den Agent.

5. Wenn das Popupfenster geschlossen wird, gibt der Agent eine Antwort zurück.