Konfigurieren und Verwalten von Agents in Visual Studio Code

Sobald Sie über einen deklarativen Agent (erstellt im Foundry-Portal oder über das SDK) verfügen, beginnt die eigentliche Arbeit – das Konfigurieren des Verhaltens, der Anweisungen und der Eigenschaften, die Ihren Anforderungen entsprechen. Die Microsoft Foundry VS Code-Erweiterung bietet umfassende Konfigurationsoptionen sowohl über den Visual Agent Designer als auch über die direkte YaML-Dateibearbeitung, sodass Sie flexibel arbeiten können.

Konfigurieren von Agenteigenschaften

Der Agent-Designer bietet eine intuitive Benutzeroberfläche zum Einrichten der Kerneigenschaften Ihres Agents. Diese Einstellungen definieren grundlegende Aspekte der Funktionsweise und Leistung Ihres Agents.

Grundlegende Konfigurationsoptionen

Im Agent-Designer konfigurieren Sie mehrere wichtige Eigenschaften:

Agent-Name – Geben Sie einen beschreibenden Namen ein, der den Zweck Ihres Agenten eindeutig identifiziert. Dieser Name wird in Listen, Protokollen und wenn andere Entwickler mit Ihren Agents zusammenarbeiten, angezeigt.

Modellauswahl – Wählen Sie Ihre Modellbereitstellung aus der Dropdownliste aus. Diese Auswahl bestimmt, welches KI-Modell die Antworten Ihres Agenten unterstützt. In der Dropdownliste werden nur Modelle angezeigt, die Sie bereits in Ihrem Projekt bereitgestellt haben.

Beschreibung – Fügen Sie eine klare, präzise Beschreibung der Funktionsweise Ihres Agenten hinzu. Gute Beschreibungen helfen Teammitgliedern, den Zweck des Agenten zu verstehen, ohne dessen Anweisungen oder Code zu lesen.

Systemanweisungen – Definieren des Verhaltens, der Persönlichkeit und des Antwortstils des Agents. Hier erfahren Sie, wie Ihr Agent seine Rolle versteht und mit Benutzern interagiert.

Agent-ID – Automatisch von der Erweiterung generiert, wenn Sie den Agent erstellen. Dieser eindeutige Bezeichner wird verwendet, wenn Sie Ihren Agent über APIs aufrufen.

Modellkonfigurationsoptionen

Über die Auswahl eines Modells hinaus können Sie das Verhalten durch zusätzliche Parameter optimieren:

Temperatur - Steuert die Kreativität und Zufälligkeit. Niedrigere Werte (0,1-0,3) erzeugen konsistente, fokussierte Ausgaben. Höhere Werte (0,7-1,0) generieren kreativere, vielfältigere Antworten. Für Geschäftsmitarbeiter, die strukturierte Aufgaben behandeln, funktionieren Werte zwischen 0,3 und 0,7 in der Regel gut.

Top P – Steuert die Vielfalt, indem die Vokabularauswahl während der Generation begrenzt wird. Die meisten Szenarien funktionieren gut mit dem Standardwert 1,0. Sie können sie jedoch für eingeschränkte, vorhersehbare Ausgaben verringern.

Diese Einstellungen werden sowohl in der Designerschnittstelle als auch in der YAML-Datei angezeigt und bleiben in beiden Ansichten synchronisiert.

Grundlegendes zur YaML-Agent-Struktur

Die YAML-Datei enthält alle Konfigurationen Ihres deklarativen Agents in einem strukturierten, lesbaren Format. Wenn Sie diese Struktur verstehen, können Sie präzise Änderungen vornehmen und effizient arbeiten, wenn die visuelle Benutzeroberfläche nicht am besten passt.

Vollständiges YAML-Beispiel

Hier ist eine vollständig konfigurierte Agent-YAML-Datei:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: healthcare-assistant
description: Assists healthcare staff with patient appointment scheduling and information retrieval
id: 'agent-abc123xyz'
metadata:
  authors:
    - developer-name
  tags:
    - healthcare
    - customer-service
    - scheduling
model:
  id: 'gpt-4.1'
  options:
    temperature: 0.5
    top_p: 1
instructions: |
  You're a healthcare assistant helping staff schedule patient appointments and retrieve information.
  
  Your responsibilities:
  - Help staff find available appointment slots
  - Answer questions about patient scheduling policies
  - Provide information about different appointment types
  - Assist with rescheduling and cancellations
  
  Important guidelines:
  - Never access or share patient medical information
  - Always verify appointment details before confirming
  - Be professional but friendly in all interactions
  - If you're unsure about policies, advise staff to check with management
tools: []

Die YAML-Struktur unterteilt sich natürlich in Abschnitte: Metadaten, Modellkonfiguration, Anweisungen und Tools. Diese Organisation erleichtert das Auffinden und Ändern bestimmter Einstellungen.

Vorteile der YAML-Konfiguration

Direkte YAML-Bearbeitung bietet mehrere Vorteile:

• Versionssteuerung – Nachverfolgen von Änderungen in Git zusammen mit Ihrem Anwendungscode
• Massenaktualisierungen – Gleichzeitiges Durchführen mehrerer Änderungen mit Konfidenz
• Vorlagen – Erstellen von wiederverwendbaren Agent-Vorlagen für konsistente Konfigurationen
• Codeüberprüfung – Einschließen von Agentkonfigurationen in Ihre Standardmäßigen Codeüberprüfungsprozesse
• Automatisierung – Erstellen von Skripts, die Agentkonfigurationen programmgesteuert generieren oder ändern

Die Erweiterung überprüft die YAML-Syntax in Echtzeit, hebt Fehler hervor und stellt während der Eingabe Vorschläge bereit.

Bewährte Methoden für die Agentkonfiguration

Wenn Sie komplexere Agents erstellen, tragen diese Methoden dazu bei, Qualität und Zuverlässigkeit aufrechtzuerhalten:

Versionskontrolle Ihrer YAML-Dateien: Committen Sie Agent-Konfigurationen zusammen mit Ihrem Anwendungscode auf Git. Dies ermöglicht Rollback, Codeüberprüfung und Änderungsnachverfolgung.

Verwenden Sie beschreibende Namen und Tags – Klare Benennung und Markierung erleichtern das Auffinden und Identifizieren von Agents, wenn Ihre Sammlung wächst.

Komplexe Anweisungen dokumentieren – Fügen Sie Kommentare in Ihre YAML-Dateien ein, die erläutern, warum Sie bestimmte Anweisungsmuster oder -konfigurationen ausgewählt haben.

Testen Sie nach jeder Änderung – Verwenden Sie den integrierten Playground, um das Verhalten nach dem Ändern der Konfiguration zu überprüfen. Kleine Änderungen können unerwartete Auswirkungen haben.

Beginnen Sie einfach, und iterieren Sie dann – Beginnen Sie mit grundlegenden Anweisungen, und fügen Sie Komplexität basierend auf Testergebnissen hinzu. Übermäßig komplexe Anfängliche Anweisungen sind schwieriger zu debuggen.

Anleitungen fokussiert halten – Jeder Agent sollte einen klaren, spezifischen Zweck haben. Agenten, die versuchen, zu viele Dinge zu erledigen, arbeiten unbeständig.

Das Konfigurieren von Agents in Visual Studio Code bietet leistungsstarke Funktionen zum Erstellen anspruchsvoller Automatisierung. Die Kombination aus visuellen Designtools und direkter YAML-Bearbeitung ermöglicht eine schnelle Entwicklung und gleichzeitig die Genauigkeit, die für Produktionsbereitstellungen erforderlich ist.