Partilhar via

Rastreamento e Observabilidade

O DevUI oferece suporte incorporado para capturar e exibir traços OpenTelemetry (OTel) emitidos pelo Agent Framework. O DevUI não cria os seus próprios spans – recolhe os spans que o Agent Framework emite durante a execução do agente e do fluxo de trabalho, e depois os exibe no painel de depuração. Isto ajuda a depurar o comportamento dos agentes, compreender o fluxo de execução e identificar problemas de desempenho.

Brevemente

A documentação DevUI para C# está a chegar em breve. Por favor, volte a consultar mais tarde ou consulte a documentação em Python para orientações conceptuais.

Ativando o rastreamento

Ative o traçado ao iniciar o DevUI com a --tracing bandeira:

devui ./agents --tracing

Isto permite o rastreamento OpenTelemetry para operações do Agent Framework.

Visualização de Traços no DevUI

Quando o rastreio está ativado, a interface web do DevUI apresenta informação de rastreamento:

  1. Executa um agente ou fluxo de trabalho através da interface
  2. Abra o painel de depuração (disponível em modo desenvolvedor)
  3. Veja a cronologia do rasto que mostra:
    • Hierarquia de abrangência
    • Informação cronológica
    • Eventos de agente/eventos de fluxo de trabalho
    • Chamadas de ferramentas e resultados

Estrutura de Traços

Agent Framework emite rastreios seguindo as convenções semânticas da OpenTelemetry para GenAI. Um rastro típico inclui:

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

Para fluxos de trabalho, os traços mostram o caminho de execução através dos executores:

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

Rastreamento Programático

Ao usar o DevUI programaticamente com serve(), o rastreamento pode ser ativado:

from agent_framework.devui import serve

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

Integração com Ferramentas Externas

O DevUI captura e exibe os traços emitidos pelo Agent Framework – não cria os seus próprios spans. Estes são traços padrão do OpenTelemetry que também podem ser exportados para ferramentas externas de observabilidade como:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Para exportar traços para um coletor externo, defina a OTLP_ENDPOINT variável de ambiente:

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

Sem um endpoint OTLP, os rastreios são capturados localmente e exibidos apenas no painel de depuração do DevUI.

Para mais detalhes sobre a observabilidade do Agent Framework:

Próximas Etapas

  • Last updated on