Erstellen eines Plug-Ins für einen deklarativen Agent von einem MCP-Server

In diesem Leitfaden erfahren Sie, wie Sie Ihren Dienst mit einem deklarativen Agent für Microsoft 365 Copilot integrieren, indem Sie einen MCP-Server mithilfe des Microsoft 365 Agents Toolkit als Plug-In hinzufügen. Mit diesen Schritten ermöglichen Sie Geschäftsbenutzern den KI-gestützten Zugriff auf Ihre MCP-exponierten Dienste.

In dieser exemplarischen Vorgehensweise wird der MCP-Server auf GitHub als Beispiel verwendet. Der GitHub-MCP-Server ist ein von GitHub bereitgestellter und gewarteter Remote-MCP-Server, der Tools für die Arbeit mit Repositorys, Issues, Pull Requests und anderen GitHub-Features bereitstellt. Sie verwenden es hier, um einen Agenten zu erstellen, der GitHub-Repositorys und Benutzer über Eingabeaufforderungen in natürlicher Sprache durchsuchen kann. Sie können die gleichen Schritte auf Ihrem eigenen MCP-Server ausführen.

Erstellen und verwenden Sie das Plug-In in vier Schritten: Erstellen Sie einen OAuth-Client für die Authentifizierung, erstellen Sie den Agenten, veröffentlichen und querladen Sie den Agent und verwenden Sie den Agenten.

Voraussetzungen

Stellen Sie zunächst sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Anforderungen unter Anforderungen für Copilot-Erweiterungsoptionen
• Visual Studio Code
• Microsoft 365 Agents Toolkit Version 6.12.0 oder höher

Zum Abschließen des GitHub-Beispiels in dieser exemplarischen Vorgehensweise benötigen Sie auch ein GitHub-Konto. Es ist kein GitHub-Konto erforderlich, um ein Plug-In von Ihrem eigenen MCP-Server aus zu erstellen.

Schritt 1: Erstellen eines OAuth-Clients für die Authentifizierung

Der GitHub MCP-Server erfordert, dass sich jeder Benutzer anmeldet, bevor Daten zurückgegeben werden, daher benötigt das Plug-In einen OAuth-Client. Verwenden Sie in diesem Leitfaden OAuth (mit statischer Registrierung). Wenn Sie den Agent erstellen und diesen Authentifizierungstyp auswählen, werden Sie sofort vom Agents-Toolkit zur Eingabe dieser Werte aufgefordert. Erstellen Sie also zuerst den Client. Copilot verwendet dann die Registrierung, um jedes Mal, wenn der Agent den MCP-Server aufruft, ein Zugriffstoken im Namen des angemeldeten Benutzers abzurufen.

So erstellen Sie einen OAuth-Client:

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

2. Fügen Sie einen Namen und eine Homepage-URL für Ihre App hinzu und legen Sie 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 den geheimen Schlüssel und die Client-ID, die beim Erstellen des Agents eingegeben werden sollen.

Schritt 2: Erstellen des Agents

So erstellen Sie den Agent:

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

2. Wählen Sie im Aufgabenbereich Agents-Toolkit die Option "Neue Agentin/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 URL https://api.githubcopilot.com/mcp/des GitHub MCP-Servers ein.

   

6. Wählen Sie den Authentifizierungstyp aus. Wählen Sie für diese Übung OAuth (mit statischer Registrierung) aus.

   

7. Wenn Sie dazu aufgefordert werden, geben Sie die Client-ID aus der registrierten OAuth-App und dann den geheimen Clientschlüssel ein.

8. Wenn Sie zur Eingabe von Bereichen aufgefordert werden, drücken Sie die EINGABETASTE , um fortzufahren.

9. Wählen Sie einen Standort für das Agentprojekt aus.

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

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

Agents Toolkit konfiguriert das generierte Plug-In-Manifest (ai-plugin.json) für die dynamische Toolerkennung, sodass der Agent die Tools des MCP-Servers – einschließlich aller Tools, die UI-Widgets (MCP-Apps) zurückgeben – zur Laufzeit auflöst und Sie Tools nicht manuell hinzufügen. Informationen zum Anheften eines festen, zusammengestellten Satzes von Tools finden Sie stattdessen unter Konfigurieren angehefteter Tools mit dem Agents Toolkit.

Schritt 3: Veröffentlichen und Querladen des Agent

So veröffentlichen Sie den Agent und laden ihn quer:

1. Wählen Sie im Bereich "Agents Toolkit-Konten " die Option Bei Microsoft 365 anmelden aus. (Wenn Sie bereits angemeldet sind, fahren Sie mit dem nächsten Schritt fort.)

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

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

4. Lesen Sie die Meldung im Dialogfeld, und wählen Sie "Bestätigen " aus, um fortzufahren.

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

Schritt 4: Verwenden des Agents

So verwenden Sie den Agent:

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

2. Suchen Sie im Abschnitt "Agents " auf der Seitenleiste Ihren Agenten. Er wird als der Name aufgeführt, den Sie in Schritt 2 angegeben haben: Agent erstellen, mit dev Anfügung am Ende. 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 Anmelden bei {agent-name}. Melden Sie sich im Popupfenster mit Ihrem GitHub-Konto an und autorisieren Sie den Agenten.

5. Wenn sich das Popupfenster schließt, gibt der Agent eine Antwort zurück.

   

6. Wenn das Tool, das der Agent aufruft, ein UI-Widget (MCP-App) zurückgibt, vergewissern Sie sich, dass der Agent das Widget in der Antwort inline rendert. Weitere Informationen finden Sie unter Hinzufügen von MCP-Apps zu deklarativen Agents in Microsoft 365 Copilot.

Verwandte Inhalte

• Hinzufügen von MCP-Apps zu deklarativen Agents in Microsoft 365 Copilot