Erstellen und Verwalten von Foundry Agents in Visual Studio Code (klassisch)

Gilt nur für:klassisches Foundry Portal. Dieser Artikel ist für das neue Foundry-Portal nicht verfügbar. Erfahren Sie mehr über das neue Portal.

mit Foundry Agent Service können Sie Agents erstellen, konfigurieren und bereitstellen, ohne Visual Studio Code (VS Code) zu verlassen. In diesem Artikel erstellen Sie einen Agenten mithilfe des Designers, fügen Tools hinzu, testen den Agenten im Playground, generieren Beispielcode und bereinigen die Ressourcen, wenn Sie fertig sind.

Voraussetzungen

• Ein Azure-Abonnement. Erstellen Sie eine kostenlos.
• Zugriff auf den Foundry Agent Service.
• Visual Studio Code installiert.
• Das Foundry Toolkit für Visual Studio Code ist installiert und angemeldet.
• Ein bereitgestelltes Modell in Ihrem Projekt.

Erstellen eines Agents im Designer

Der Designer stellt eine visuelle Schnittstelle zum Konfigurieren des Namens, Modells, Anweisungen und Tools Ihres Agents bereit.

1. Melden Sie sich bei Ihren Azure-Ressourcen an.

2. Legen Sie Ihr Standardprojekt fest.

3. Suchen Sie in der Ansicht "Foundry Toolkit " den Abschnitt " Classic " im Abschnitt "Ressourcen ".

4. Wählen Sie das Pluszeichen (+) neben dem Unterabschnitt " Classic Agents " aus, um einen neuen Agent zu erstellen.

Konfigurieren des Agents im Designer

Nachdem Sie einen Speicherort ausgewählt haben, wird die Yaml-Agent-Datei und die Designeransicht geöffnet. Konfigurieren Sie die folgenden Einstellungen:

1. Geben Sie in der Eingabeaufforderung einen Namen für Ihren Agenten ein.

2. Wählen Sie im Dropdown-Menü den Namen der Modellimplementierung aus. Der Bereitstellungsname ist das, was Sie beim Bereitstellen eines vorhandenen Modells ausgewählt haben.

3. Die Erweiterung generiert den ID-Wert . Konfigurieren Sie die folgenden Felder:

   • Fügen Sie eine Beschreibung für Ihren Agent hinzu.
   • Legen Sie Systemanweisungen fest.
   • Konfigurieren Sie Tools für die Agentverwendung.

4. Um die YAML-Datei zu speichern, wählen Sie " Datei>speichern " auf der Menüleiste "VS Code" aus.

Überprüfen der YaML-Agentdefinition

Die YAML-Datei wird zusammen mit dem Designer geöffnet und enthält die Konfigurationsdetails für Ihren Agent. Das Format ähnelt dem folgenden Beispiel:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Hinzufügen von Tools zum Agent

Der Agentdienst bietet die folgenden Tools, um die Funktionen Ihres Agents zu erweitern und eine Verbindung mit Ihren Datenquellen herzustellen:

• Die Grundlage mit Bing-Suche schaffen
• Dateisuche
• Codedolmetscher
• OpenAPI-angegebene Tools
• Model Context Protocol (MCP)

Weitere Informationen zur Verwendung von MCP-Tools finden Sie unter Work with Agent Service and MCP server tools in Visual Studio Code (Preview).

Hinzufügen eines Tools zum Agent

1. Wählen Sie im Designer in der oberen rechten Ecke des TOOL-Abschnitts " Tool hinzufügen" aus. Wählen Sie in der Dropdownliste das Tool aus, das Sie hinzufügen möchten.

   

2. Der Designer zeigt den entsprechenden Bereich zum Konfigurieren des Tools an, wie in den folgenden Abbildungen dargestellt:

   • Grounding mit Bing-Suche:

     

   • Dateisuche:

     

   • Codedolmetscher:

     

   • OpenAPI 3.0 spezifizierte Tools

     

3. Nachdem Sie die erforderlichen Informationen eingegeben haben, wählen Sie "Erstellen und Verbinden", "Hochladen und Speichern" oder " Tool erstellen" aus. Die Schaltflächenbezeichnung variiert je nach Tooltyp.

   Nachdem das Tool erstellt wurde, wird es im TOOL-Abschnitt des Designers angezeigt.

Wenn Sie ein Tool hinzufügen, können Sie auch alle benötigten neuen Ressourcen hinzufügen. Wenn Sie beispielsweise ein Dateisuchtool hinzufügen, können Sie eine vorhandene Vektorspeicherressource verwenden oder eine neue erstellen, um Ihre hochgeladenen Dateien zu hosten.

Bereitstellen des Agent an Foundry

Nachdem Sie den Agent konfiguriert haben, stellen Sie ihn in Foundry bereit, damit er in der Cloud ausgeführt wird.

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

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

Anzeigen der bereitgestellten Agentendetails

Wählen Sie einen bereitgestellten Agenten aus, um die AGENT-EINSTELLUNGEN-Ansicht im schreibgeschützten Modus zu öffnen. In diesem Bereich haben Sie folgende Möglichkeiten:

• Wählen Sie "Agent bearbeiten" aus, um den Agent-Designer und die YAML-Definition zur Bearbeitung zu öffnen.
• Wählen Sie "Code anzeigen" aus, um eine Beispielcodedatei zu generieren, die den Agent verwendet.
• Wählen Sie "Playground öffnen " aus, um den Remote-Agent-Playground zu öffnen.

Aktualisieren eines bereitgestellten Agents

Sie können die Konfiguration eines bereitgestellten Agents ändern und die Änderungen wieder mit Foundry synchronisieren.

1. Wählen Sie im BEREICH "AGENT-EINSTELLUNGEN " die Option "Agent bearbeiten" aus. Der Agent-Designer öffnet die YAML-Datei des Agents.

2. Bearbeiten Sie die Konfiguration des Agents, z. B. das Modell, tools und Anweisungen.

3. Wählen Sie den Update-Agent für Microsoft Foundry aus, um Ihre Änderungen zu speichern. Die aktualisierte Konfiguration wird sofort wirksam.

Generieren einer Beispielcodedatei

Die Erweiterung generiert Codebausteine für die programmgesteuerte Interaktion mit Ihrem bereitgestellten Agent.

1. Klicken Sie mit der rechten Maustaste auf Ihren bereitgestellten Agent, und wählen Sie dann "Code anzeigen" aus. Oder wählen Sie im BEREICH "AGENT-EINSTELLUNGEN " die Schaltfläche " Code anzeigen " aus.

2. Wählen Sie in der Dropdownliste " Wählen Sie Ihr bevorzugtes SDK " aus.

3. Wählen Sie in der Dropdownliste "Sprache auswählen" Ihre Sprache aus.

4. Wählen Sie in der Dropdownliste " Auswählen einer Authentifizierungsmethode" Ihre Authentifizierungsmethode aus.

Die Erweiterung generiert eine Codedatei in Der ausgewählten Sprache und öffnet sie im Editor.

Überprüfen der Beispielcodedatei

Die generierte Codedatei veranschaulicht einen einfachen Aufruf der Interaktion mit dem Agent über die Foundry Projects-API. Der folgende Screenshot zeigt ein Python Beispiel:

Testen des Agents im Playground

Verwenden Sie den Playground, um Nachrichten an Ihren bereitgestellten Agent zu senden und sein Verhalten zu überprüfen.

1. Klicken Sie mit der rechten Maustaste auf Ihren bereitgestellten Agent, und wählen Sie dann "Playground öffnen" aus.

   Alternativ können Sie den Link "Remote-Agent-Playground" im Unterabschnitt Tools auswählen, Ihren Agenttyp und dann Ihren Agent aus den Dropdownlisten auswählen.

   Der Bereich " Remote-Agent-Playground " wird geöffnet und startet einen Thread mit Ihrem Agent.

2. Geben Sie Ihre Eingabeaufforderung ein, und zeigen Sie die Ergebnisse an.

   In diesem Beispiel wird Bing Grounding verwendet, um eine Websuche nach Informationen zu veranschaulichen. Der Agent verwendet das Modell und die Tools, die Sie im Agent-Designer konfiguriert haben. Die Quelle der Informationen wird im Abschnitt für Agentanmerkungen angezeigt.

   

Anzeigen von Agentthreads

Der Unterabschnitt Threads zeigt die Gesprächsverläufe an, die während der Ausführungen mit Ihrem Agenten erstellt wurden. Erweitern Sie im Abschnitt "Klassisch" unter der Ansicht "Ressourcen " den Unterabschnitt "Threads ", um die Liste anzuzeigen.

Threaddetails anzeigen

Um den BEREICH THREADDETAILS anzuzeigen, wählen Sie einen Thread aus der Liste aus.

Anzeigen der Ausführungsdetails

Wählen Sie zum Anzeigen von Ausführungsinformationen die Schaltfläche " Info anzeigen" im BEREICH THREADDETAILS aus. Eine .json Datei wird mit den Details der Ausführung geöffnet, einschließlich der Agentkonfiguration, Nachrichten und Toolaufrufe.

Bereinigen von Ressourcen

Wenn Sie die von Ihnen erstellten Ressourcen nicht benötigen, löschen Sie sie, um laufende Gebühren für Ihr Azure-Abonnement zu vermeiden.

Löschen Ihrer Agents

1. Aktualisieren Sie in VS Code die Ansicht Azure Resources.
2. Erweitern Sie den Unterabschnitt "Agents ", um die Liste der bereitgestellten Agents anzuzeigen.
3. Klicken Sie mit der rechten Maustaste auf den Agent, den Sie löschen möchten, und wählen Sie dann "Löschen" aus.

Löschen Ihrer Modelle

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

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

Löschen Ihrer verbundenen Tools

1. Öffnen Sie das portal Azure.

2. Wechseln Sie zu der Ressourcengruppe, die die Toolressource enthält.

3. Wählen Sie die Ressource und dann "Löschen" aus.

Verwandte Inhalte

• Arbeiten Sie mit Agent Service- und MCP-Server-Tools in Visual Studio Code (Vorschau), um MCP-Tools zu Ihren Agents hinzuzufügen.
• Übersicht über Agenttools für Details zur Dateisuche, Codedolmetscher und anderen verfügbaren Tools.
• Die Übersicht über den Foundry Agent Service bietet einen tieferen Einblick in die Agentkonzepte und -funktionen.