Freigeben über

Arbeiten mit Foundry Classic Agents und MCP-Servertools in Visual Studio Code (Vorschau) (klassisch)

Hinweis

Dieses Dokument bezieht sich auf das Microsoft Foundry(klassische) Portal.

🔍 Zeigen Sie die Microsoft Foundry-Dokumentation (neu) an, um mehr über das neue Portal zu erfahren.

In diesem Artikel erfahren Sie, wie Sie Model Context Protocol (MCP)-Servertools mit Agenten im Foundry Agent Service hinzufügen und verwenden. Sie verwenden die Microsoft Foundry für Visual Studio Code-Erweiterung zum Konfigurieren und Testen von MCP-Toolanruf-Agents.

Hinweis

Dieser Artikel bezieht sich auf die klassische Version der Agents-API.

Nachdem Sie einen Agent im Agent-Dienst mithilfe der Visual Studio Code-Erweiterung (VS Code) erstellt haben, können Sie Ihrem Agent MCP-Tools hinzufügen. Das Hinzufügen eines MCP-Servers ermöglicht Ihrem Agent Folgendes:

  • Greifen Sie auf aktuelle Informationen aus Ihren APIs und Diensten zu.
  • Rufen Sie den relevanten Kontext ab, um die Qualität der Antworten aus Ihren KI-Modellen zu verbessern.

Von Bedeutung

Die in diesem Artikel markierten Elemente (Vorschau) sind aktuell als öffentliche Vorschau verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Voraussetzungen

Erstellen eines Agents im Designer

Führen Sie zum Erstellen eines Agents die Schritte unter Erstellen eines Agents im Designer aus.

Hinzufügen eines MCP-Servertools zum Agent

Nachdem Sie Ihren Agent erstellt haben, können Sie ihr Tools hinzufügen, einschließlich MCP-Tools. Weitere Informationen zu verfügbaren Tools finden Sie unter Tools für Agents.

Sie können mehrere MCP-Remoteserver mitbringen, indem Sie sie als Tools hinzufügen. Für jedes Tool müssen Sie einen eindeutigen Serverbezeichnungswert innerhalb desselben Agents und einen Server-URL-Wert bereitstellen, der auf den Remote-MCP-Server verweist.

Warnung

Die McP-Remoteserver, die Sie mit dem MCP-Tool in diesem Artikel verwenden, stammen nicht von Microsoft. Microsoft testt diese Server nicht oder überprüft sie. Ausführliche Informationen finden Sie unter Überlegungen zur Verwendung von Nicht-Microsoft-Diensten und -Servern.

Führen Sie die folgenden Schritte aus, um Ihrem Agent ein MCP-Servertool hinzuzufügen:

  1. Wählen Sie im Designer in der oberen rechten Ecke des TOOL-Abschnitts die Schaltfläche " Tool hinzufügen " aus. Wählen Sie in der Dropdownliste das MCP-Servertool aus.

  2. Suchen Sie den Remote-MCP-Server, mit dem Sie eine Verbindung herstellen möchten, z. B. den GitHub MCP-Server. Erstellen oder aktualisieren Sie einen Foundry-Agent mit einem MCP-Tool, indem Sie die folgenden Informationen verwenden:

    1. Server-URL: Die URL des MCP-Servers; beispiel: https://gitmcp.io/Azure/azure-rest-api-specs.

    2. Serverbezeichnung: Ein eindeutiger Bezeichner dieses MCP-Servers für den Agent; beispiel: fetch_rest_api_docs.

  3. Wählen Sie in der Dropdownliste "Zulässige Tools " aus, welche Tools der MCP-Server verwenden kann.

  4. Nachdem Sie die erforderlichen Informationen eingegeben haben, wählen Sie die Schaltfläche "Tool erstellen " aus. Das MCP-Tool wird im TOOL-Abschnitt des Agent-Designers angezeigt.

Agent auf Foundry bereitstellen

Nachdem Sie ein MCP-Tool hinzugefügt haben, stellen Sie den Agent in Foundry bereit, damit er zu Testzwecken und zur Verwendung verfügbar ist.

  1. Wählen Sie im Designer die Schaltfläche " Agent auf Microsoft Foundry erstellen " aus.

  2. Aktualisieren Sie in VS Code die Ressourcenansicht. Der bereitgestellte Agent wird im Unterabschnitt Classic Agents angezeigt.

Details des bereitgestellten Agenten anzeigen

Nachdem Sie einen Agent bereitgestellt haben, können Sie die Konfiguration prüfen und mit ihm interagieren. Wählen Sie den bereitgestellten Agent in der Ressourcenansicht aus, um die AGENT-EINSTELLUNGEN im schreibgeschützten Modus zu öffnen. Sie haben folgende Möglichkeiten:

  • Wählen Sie die Schaltfläche "Agent bearbeiten " aus, um den Agent-Designer und die YAML-Definition des Agents zur Bearbeitung anzuzeigen.
  • Wählen Sie die Schaltfläche "Code anzeigen " aus, um eine Beispielcodedatei zu erstellen, die den Agent verwendet.
  • Wählen Sie die Schaltfläche " Playground öffnen" aus, um den Agent-Playground zu öffnen.

Bearbeiten eines bereitgestellten Agents

Führen Sie die folgenden Schritte aus, um die Konfiguration Ihres Agents nach der Bereitstellung zu ändern:

  1. Wählen Sie im BEREICH "AGENT-EINSTELLUNGEN " die Schaltfläche " Agent bearbeiten " aus. Der Agent-Designer wird mit der YAML-Datei des Agenten geöffnet.

  2. Bearbeiten Sie die Konfiguration des Agenten, z. B. das Modell, Tools und Anweisungen.

  3. Nachdem Sie die Bearbeitung abgeschlossen haben, wählen Sie die Schaltfläche "Agent aktualisieren" in Microsoft Foundry aus, um Ihre Änderungen zu speichern. Die aktualisierte Konfiguration wird in Foundry bereitgestellt.

Testen des Agents mit MCP-Tools im Playground

Verwenden Sie den Agent-Playground, um zu überprüfen, ob Ihre MCP-Servertools mit dem bereitgestellten Agent ordnungsgemäß funktionieren.

  1. Klicken Sie mit der rechten Maustaste auf Ihren bereitgestellten Agent, der über ein MCP-Servertool verfügt, und wählen Sie dann die Option "Playground öffnen" aus. Diese Aktion startet einen Thread mit Ihrem Agent, damit Sie Nachrichten senden können.

  2. Geben Sie im Bereich " Remote-Agent-Playground " eine Eingabeaufforderung ein, z. B. "Geben Sie mir ein Beispiel für das Erstellen einer Container-App ein, und senden Sie sie.

  3. Wählen Sie die Authentifizierungsmethode für das MCP-Servertool aus, und fahren Sie fort. Authentifizierungsmethoden variieren je nach MCP-Server. Zu den allgemeinen Optionen gehören API-Schlüssel, OAuth oder keine Authentifizierung für öffentliche Server.

  4. Wählen Sie die Genehmigungseinstellung für das MCP-Servertool aus, und fahren Sie fort. Sie können jedes Mal fragen , um jeden Toolaufruf zu überprüfen, oder immer zulassen , dass der Agent MCP-Tools automatisch aufruft.

  5. Wenn Sie bei Ihrer Genehmigungseinstellung Jedes Mal nachfragen gewählt haben, müssen Sie jeden Tool-Aufruf genehmigen oder ablehnen, bevor der Agent fortfahren kann.

  6. Der Agent verwendet das Modell und die MCP-Servertools, die Sie zum Abrufen der Informationen konfiguriert haben. Nachdem der Agent die Verarbeitung abgeschlossen hat, wird die Antwort im Playground angezeigt. Die Quelle der Informationen wird im Abschnitt für Agentanmerkungen angezeigt.

Problembehandlung bei MCP-Serververbindungen

Wenn Probleme auftreten, wenn Sie MCP-Servertools mit Ihrem Agent verwenden, probieren Sie die folgenden Lösungen aus.

Thema Beschluss
MCP-Server-URL ist nicht erreichbar Stellen Sie sicher, dass die URL korrekt ist und dass der Server läuft. Überprüfen Sie Ihre Netzwerkverbindung und alle Firewallregeln, die ausgehende Anforderungen von VS Code blockieren können.
Authentifizierungsfehler Vergewissern Sie sich, dass Sie die richtige Authentifizierungsmethode für den MCP-Server ausgewählt haben. Wenn für den Server ein API-Schlüssel oder OAuth-Token erforderlich ist, überprüfen Sie, ob die Anmeldeinformationen gültig und nicht abgelaufen sind.
Tools werden nicht in der Liste der zulässigen Tools angezeigt Aktualisieren Sie die Toolliste, indem Sie das McP-Tooldialogfeld schließen und erneut öffnen. Stellen Sie sicher, dass der MCP-Server seine Tools über das standardmäßige MCP-Protokoll korrekt verfügbar macht.
Der Agent gibt Fehler zurück, wenn er ein MCP-Tool aufruft. Überprüfen Sie die Agentenanmerkungen im Playground auf Fehlerdetails. Der MCP-Server gibt möglicherweise eine Fehlerantwort zurück. Stellen Sie sicher, dass der Server fehlerfrei ist und dass die Parameter für den Toolaufruf korrekt sind.

Bereinigen von Ressourcen

Die Azure-Ressourcen, die Sie in diesem Artikel erstellt haben, werden Ihrem Azure-Abonnement in Rechnung gestellt. Wenn Sie nicht erwarten, dass diese Ressourcen in Zukunft benötigt werden, löschen Sie sie, um weitere Gebühren zu vermeiden.

Löschen Ihrer Agents

So entfernen Sie Agents, die Sie nicht mehr benötigen:

  1. Aktualisieren Sie in VS Code die Ressourcenansicht. Erweitern Sie den Unterabschnitt "Classic Agents ", um die Liste der bereitgestellten Agents anzuzeigen.

  2. Klicken Sie mit der rechten Maustaste auf den bereitgestellten Agent, den Sie löschen möchten, und wählen Sie dann "Löschen" aus.

Löschen Ihrer Modelle

So entfernen Sie bereitgestellte Modelle, die Sie nicht mehr benötigen:

  1. Aktualisieren Sie in VS Code die Ressourcenansicht. Erweitern Sie den Unterabschnitt "Modelle ", um die Liste der bereitgestellten Modelle anzuzeigen.

  2. Klicken Sie mit der rechten Maustaste auf das bereitgestellte Modell, das Sie löschen möchten, und wählen Sie dann "Löschen" aus.

Löschen Ihrer verbundenen Tools

Um verbundene Toolressourcen zu entfernen, die Sie nicht mehr benötigen, löschen Sie sie einzeln im Azure-Portal:

  1. Öffnen Sie das Azure-Portal.

  2. Wechseln Sie zu der Ressourcengruppe, die Ihr Foundry-Projekt enthält.

  3. Suchen Sie die spezifische Toolressource, die Sie löschen möchten, und wählen Sie sie aus.

  4. Wählen Sie die Schaltfläche Löschen aus, und bestätigen Sie den Löschvorgang.

Warnung

Löschen Sie nicht die gesamte Ressourcengruppe, es sei denn, Sie möchten alle Darin enthaltenen Ressourcen entfernen. Durch das Löschen einer Ressourcengruppe werden alle darin enthaltenen Ressourcen entfernt, einschließlich Ihres Foundry-Projekts und der bereitgestellten Modelle.

Verwandte Inhalte

  • Last updated on