Megosztás:

Nyomon követés és megfigyelhetőség

A DevUI beépített támogatást nyújt az Ügynök-keretrendszer által kibocsátott OpenTelemetria-(OTel-) nyomkövetések rögzítéséhez és megjelenítéséhez. A DevUI nem hoz létre saját spánokat – az ügynök-keretrendszer által kibocsátott spánokat gyűjti össze az ügynök és a munkafolyamat végrehajtása során, és megjeleníti azokat a hibakeresési panelen. Ez segít az ügynök viselkedésének hibakeresésében, a végrehajtási folyamat megértésében és a teljesítményproblémák azonosításában.

Hamarosan elérhető

A C# devUI-dokumentációja hamarosan elérhető lesz. Tekintse meg később, vagy tekintse meg a Python dokumentációját fogalmi útmutatásért.

Nyomkövetés engedélyezése

Nyomkövetés engedélyezése a DevUI jelölővel való --tracing indításakor:

devui ./agents --tracing

Ez lehetővé teszi az OpenTelemetry nyomkövetését az Agent Framework-műveletekhez.

Nyomkövetések megtekintése a DevUI-ban

Ha a nyomkövetés engedélyezve van, a DevUI webes felülete nyomkövetési információkat jelenít meg:

  1. Ügynök vagy munkafolyamat futtatása a felhasználói felületen
  2. Nyissa meg a hibakeresési panelt (fejlesztői módban érhető el)
  3. Tekintse meg a nyomkövetési ütemtervet, amely a következőt mutatja:
    • Span hierarchia
    • Időzítési információk
    • Ügynök-/munkafolyamat-események
    • Eszközhívások és eredmények

Nyomkövetési struktúra

Az Agent Framework a GenAI OpenTelemetry szemantikai konvencióit követve bocsát ki nyomkövetéseket. Egy tipikus nyomkövetés a következőket tartalmazza:

Agent Execution
    LLM Call
        Prompt
        Response
    Tool Call
        Tool Execution
        Tool Result
    LLM Call
        Prompt
        Response

Munkafolyamatok esetén a nyomkövetések a végrehajtókon keresztül jelenítik meg a végrehajtási útvonalat:

Workflow Execution
    Executor A
        Agent Execution
            ...
    Executor B
        Agent Execution
            ...

Programozott nyomkövetés

A DevUI programozott serve()használata esetén a nyomkövetés engedélyezhető:

from agent_framework.devui import serve

serve(
    entities=[agent],
    tracing_enabled=True
)

Integráció külső eszközökkel

A DevUI rögzíti és megjeleníti az Ügynök-keretrendszer által kibocsátott nyomkövetéseket – nem hozza létre a saját tartományait. Ezek szabványos OpenTelemetria-nyomkövetések, amelyek külső megfigyelhetőségi eszközökre is exportálhatók, például:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Ha nyomkövetéseket szeretne exportálni egy külső gyűjtőbe, állítsa be a környezeti változót OTLP_ENDPOINT :

export OTLP_ENDPOINT="http://localhost:4317"
devui ./agents --tracing

OTLP-végpont nélkül a nyomkövetések helyileg lesznek rögzítve, és csak a DevUI hibakeresési paneljén jelennek meg.

További részletek az Ügynök-keretrendszer megfigyelhetőségéről:

Következő lépések

  • Last updated on