Arbeiten mit Foundry Agent Service in Visual Studio Code (Vorschau)

Nachdem Sie mit der Erweiterung Microsoft Foundry für Visual Studio Code begonnen haben, verwenden Sie den Foundry Agent Service , um Agents zu erstellen. Agents sind Microservices, die:

• Beantworten Sie Fragen, indem Sie die Trainingsdaten verwenden oder andere Quellen durch Retrieval-augmented Generation (RAG) durchsuchen.
• Ausführen bestimmter Aktionen.
• Automatisieren Sie vollständige Workflows.

Agents kombinieren KI-Modelle mit Tools für den Zugriff und die Interaktion mit Ihren Daten.

Gießerei-Entwickler können produktiv bleiben, indem sie Agenten in der vertrauten Umgebung von Visual Studio Code (VS Code) entwickeln, testen und bereitstellen.

Erstellen und Bearbeiten eines Azure AI-Agents in der Designeransicht

Führen Sie die folgenden Schritte aus, um einen Azure AI-Agent zu erstellen:

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

2. Legen Sie Ihr Standardprojekt fest.

3. Stellen Sie ein Modell bereit, das mit Ihrem Agent verwendet werden soll.

4. Suchen Sie in der Ansicht " Foundry Extension " den Abschnitt "Ressourcen ".

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

   

Interagieren mit Ihrem Agent im Designer

Nachdem Sie Ihren Speicherort ausgewählt haben, werden sowohl die Yaml-Agent-Datei als auch die Designeransicht geöffnet, damit Sie Ihren KI-Agent bearbeiten können. Führen Sie die folgenden Aufgaben im Agent-Designer aus:

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

2. Wählen Sie in der Dropdownliste den Namen Ihrer Modellimplementierung aus. Der Name der Implementierung ist der Name, den Sie bei der Implementierung eines bestehenden 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.

Erkunden der YAML-Definition des Azure AI-Agents

Die YAML-Datei Ihres KI-Agents wurde gleichzeitig mit dem Designer geöffnet. Diese Datei enthält die Details und Setupinformationen für Ihren Agent. Es ähnelt dem folgenden YAML-Dateibeispiel:

# 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 Azure AI-Agent

Der Agentdienst verfügt über die folgenden Tools, mit denen Sie mit Ihren Datenquellen interagieren können. Diese Tools sind in der Foundry für die Visual Studio Code-Erweiterung verfügbar.

• Grounding mit der Bing-Suche
• Dateisuche
• Codeinterpreter
• OpenAPI-angegebene Tools
• Model Context Protocol (MCP)

Weitere Informationen zur Verwendung von MCP-Tools finden Sie unter "Arbeiten mit Agent service" und "MCP-Servertools" in Visual Studio Code (Vorschau).

Hinzufügen eines Tools zum KI-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:

   • Grundlage für die 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äche variiert je nach Bereich.

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 Ressource für Ihren Vektorspeicher erstellen, um Ihre hochgeladenen Dateien zu hosten.

Erstellen eines Azure AI-Agents in Foundry

Erstellen Sie Ihren Agent direkt in Foundry, indem Sie die folgenden Schritte ausführen:

1. Wählen Sie im Designer die Schaltfläche Create Agent on Foundry aus.

   

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

   

Anzeigen der Details des bereitgestellten KI-Agents

Wenn Sie den bereitgestellten Agent auswählen, wird die Seite AGENTEINSTELLUNGEN im Modus „Nur Anzeigen“ geöffnet. 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 Codedatei öffnen aus, um eine Beispielcodedatei zu erstellen, die den Agenten verwendet.
• Wählen Sie die Schaltfläche " Playground öffnen" aus, um den Agent-Playground zu öffnen.

Bearbeiten und Aktualisieren des bereitgestellten KI-Agents

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 Update Agent on Foundry aus, um Ihre Änderungen zu speichern.

Erstellen einer Beispielcodedatei

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

   

2. Wählen Sie in der Dropdownliste " Wählen Sie Ihr bevorzugtes SDK " für die Agentcodedatei und dann die EINGABETASTE aus.

   

3. Wählen Sie in der Dropdownliste "Sprache auswählen" Ihre bevorzugte Sprache für die Agent-Codedatei und dann die EINGABETASTE aus.

   

4. Wählen Sie in der Dropdownliste " Auswählen einer Authentifizierungsmethode " Die bevorzugte Authentifizierungsmethode für die Agentcodedatei und dann die EINGABETASTE aus.

   

Untersuchen der Beispielcodedatei

Die folgende Python-Beispielcodedatei veranschaulicht einen einfachen Aufruf der Interaktion mit dem Agent über die Foundry Projects-API.

Interagieren mit Agents mithilfe des Agent-Playgrounds

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

   Wählen Sie alternativ im Unterabschnitt "Tools" den Link "Agent-Playground" aus, und wählen Sie dann Ihren Agent aus der Dropdownliste aus.

   Dieser Schritt öffnet den Agent-Playground-Bereich und startet einen Thread mit Ihrem Agent, damit Sie Nachrichten senden können.

   

2. Geben Sie Ihr Prompt ein und sehen Sie sich 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.

   

Diskussionsfäden erkunden

Der Unterabschnitt "Threads " zeigt die Threads an, die während einer Ausführung mit Ihrem Agent erstellt wurden. Erweitern Sie in der Azure-Ressourcenansicht den Unterabschnitt "Threads ", um die Liste anzuzeigen.

Beachten Sie diese Begriffe beim Erkunden von Threads:

• Ein Thread ist eine Unterhaltungssitzung zwischen einem Agent und einem Benutzer. Threads speichern Nachrichten und kürzen automatisch deren Inhalte, um sie in den Kontext eines Modells passend einzufügen.

• Eine Nachricht ist eine einzelne Interaktion zwischen dem Agent und dem Benutzer. Nachrichten können Text, Bilder und andere Dateien enthalten. Nachrichten werden als Liste im Thread gespeichert.

• Eine Ausführung ist eine einzelne Ausführung eines Agents. Jede Ausführung kann über mehrere Threads verfügen, und jeder Thread kann mehrere Nachrichten enthalten. Der Agent verwendet seine Konfiguration und die Nachrichten eines Threads, um Aufgaben durch Aufrufen von Modellen und Tools auszuführen. Im Rahmen einer Ausführung fügt der Agent Nachrichten an den Thread an.

Threaddetails anzeigen

Um den THREADDETAILS-Bereich anzuzeigen, wählen Sie einen Thread aus.

Anzeigen von Ausführungsdetails

Zum Anzeigen von Ausführungsinformationen in einer JSON-Datei wählen Sie die Schaltfläche „Ausführungsinformationen anzeigen“ im Bereich THREAD DETAILS aus. Der folgende Screenshot zeigt eine Beispiel-JSON-Datei.

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

1. Aktualisieren Sie in VS Code die Ansicht Azure-Ressourcen. Erweitern Sie den Unterabschnitt "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

1. Aktualisieren Sie in VS Code die Ansicht Azure-Ressourcen. 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

1. Öffnen Sie das Azure-Portal.

2. Wählen Sie die Azure-Ressourcengruppe aus, die das Tool enthält.

3. Wählen Sie die Schaltfläche Löschen aus.

Verwandte Inhalte

• Erfahren Sie mehr über die Tools, die Sie mit Azure AI-Agents verwenden können, z. B. Dateisuche oder Codedolmetscher.