Einen lokalen Agenten mit dem Agent Inspector untersuchen

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 Supplementale Nutzungsbedingungen für Microsoft Azure Previews.

Der Agent Inspector ist eine browserbasierte Benutzeroberfläche zum Untersuchen eines Microsoft-Foundry-Agenten, der auf Ihrem lokalen Computer ausgeführt wird. Es verbindet sich mit dem HTTP-/SSE-Endpunkt des lokalen Agenten, zeigt Anfragen und Antworten an und ermöglicht es Ihnen, Nachrichten erneut abzuspielen, während Sie Prompts, Tools und Code iterativ überarbeiten.

Voraussetzungen

Der Inspektor wird in einer eigenen Erweiterung (azure.ai.inspector) bereitgestellt und automatisch durch das Metapaket microsoft.foundry installiert. Es wird auch als Abhängigkeit von azure.ai.agents eingebunden, sodass es ausreicht, nur die Agent-Erweiterung zu installieren.

Note

Der Inspektor zielt standardmäßig nur auf einen lokalen Agenten auf http://localhost:8088 ab. Es authentifiziert sich weder bei einem bereitgestellten Foundry-Agenten noch fungiert es als Proxy dafür. Für den bereitgestellten Agent verwenden azd ai agent invoke und azd ai agent monitor.

Agent lokal starten

  1. Starten Sie den Agent in einem Terminal:

    azd ai agent run

    Standardmäßig öffnet azd ai agent run den Inspektor für Sie, wenn der lokale Server mit dem Lauschen beginnt.

  2. Um den automatischen Start zu überspringen, übergeben Sie --no-inspector:

    azd ai agent run --no-inspector

Manuelles Starten des Inspektors

Wenn Sie den Agent selbst gestartet haben, z. B. mit python app.py oder dotnet run, oder wenn Sie die Registerkarte "Inspektor" geschlossen haben und ihn erneut öffnen möchten, starten Sie den Inspektor manuell.

  1. Führen Sie den Startbefehl aus:

    azd ai inspector launch

    Die Benutzeroberfläche wird standardmäßig über http://localhost:8087 bereitgestellt und verbindet sich mit einem Agenten auf http://localhost:8088.

  2. Konfigurieren Sie bei Bedarf beide Ports:

    # Agent on port 9000, UI on port 9001.
azd ai inspector launch --port 9000 --inspector-port 9001

  3. Um den Inspektor mit einer vorhandenen Unterhaltungs- oder Sitzungs-ID für die Wiedergabe einer bestimmten Ausführung zu versehen, übergeben Sie die IDs explizit:

    azd ai inspector launch \
  --conversation-id conv_abc123 \
  --session-id sess_xyz789

Lokalen Netzwerkverkehr überprüfen

Wenn der Inspektor geöffnet ist, streamt die Single-Page-App die Antworten des Agents über SSE und spiegelt sie auch in Ihrem Terminal. Sie haben folgende Möglichkeiten:

  • Überprüfen Sie die vollständigen Anfrage- und Antwortnutzlasten für jeden Schritt.
  • Setzen Sie eine bestehende Konversation fort, indem Sie die Konversations-ID über mehrere Interaktionen hinweg wiederverwenden.
  • Sie können jederzeit auf eine neue Sitzung zurücksetzen.

Der Inspektor ändert weder Ihren Agent-Code noch azure.yaml. Es ist lediglich eine Laufzeitansicht.

Verwandte Inhalte

  • Last updated on