Inspektera en lokal agent med Agent Inspector

Important

Objekt som har markerats som förhandsversioner i den här artikeln är för närvarande i förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och Microsoft rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Agentinspektören är ett webbläsarbaserat användargränssnitt för att peta på en Microsoft Foundry-agent som körs på den lokala datorn. Den ansluter till den lokala agentens HTTP/SSE-slutpunkt, visar begäranden och svar och låter dig spela upp meddelanden medan du itererar i frågor, verktyg och kod.

Den här artikeln beskriver hur du startar Inspector med Azure Developer CLI. För VS Code-tilläggets anslutningskontroller, felsökningsintegrering och diagnostikexporter, se Agent Inspector i Microsoft Foundry Toolkit. Information om lagrade OpenTelemetry-spans i stället för live-svarshändelser finns i Spårning i Foundry Toolkit.

Förutsättningar

Inspektören levereras i ett eget tillägg (azure.ai.inspector) och installeras automatiskt av metapaketet microsoft.foundry. Det tas också in som ett beroende av azure.ai.agents, så det räcker att bara installera agenttillägget.

Note

Inspektören riktar sig som standard endast mot en lokal agent på http://localhost:8088. Den autentiserar inte mot eller agerar proxy för en driftsatt Foundry-agent. För den distribuerade agenten använder du azd ai agent invoke och azd ai agent monitor.

Starta agenten lokalt

  1. Starta agenten i en terminal:

    azd ai agent run

    Som standard azd ai agent run öppnar inspektören åt dig när den lokala servern börjar lyssna.

  2. Om du vill hoppa över den automatiska starten skickar du --no-inspector:

    azd ai agent run --no-inspector

Starta inspektören manuellt

Om du startade agenten själv, till exempel med python app.py eller dotnet run, eller om du stängde fliken Inspector och vill öppna den igen, startar du inspektören manuellt.

  1. Kör startkommandot:

    azd ai inspector launch

    Användargränssnittet serveras som standard på http://localhost:8087 och ansluter till en agent på http://localhost:8088.

  2. Konfigurera båda portarna om det behövs:

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

  3. Om du vill att inspektören ska få ett befintligt konversations- eller sessions-ID för att spela upp en specifik körning skickar du ID:t explicit:

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

Granska lokal trafik

När inspektören är öppen, strömmar single-page-appen agentens svar via SSE och visar dem även i din terminal. Du kan:

  • Granska de fullständiga nyttolasten för begäran och svar för varje tur.
  • Fortsätt en befintlig konversation genom att återanvända konversations-ID:t över turerna.
  • Återställ till en ny session när som helst.

Inspektören ändrar inte agentkoden eller azure.yaml. Det är rent av en vy under körning.

Relaterat innehåll

  • Uppdaterades senast