phoenix-tracing
Ajuda seu agente a rastrear e entender o fluxo de dados em aplicações de IA. É útil para monitorar o desempenho e identificar problemas.
O que ela faz
Esta ferramenta ajuda a rastrear e entender como seus programas de inteligência artificial funcionam. Ela registra cada passo, como uma câmera gravando um evento, para que você possa ver o que aconteceu.
Quando usar
- ✓Quando você está configurando o rastreamento para IA.
- ✓Ao criar etapas personalizadas para rastrear em seu código.
- ✓Ao preparar seu sistema para uso em produção.
Exemplo do que pedir para a IA
“Como configuro o rastreamento para Python?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ela funciona registrando informações detalhadas sobre as operações da IA, como quais modelos foram usados, quanto tempo levou e quais dados foram processados. Isso cria um 'rastro' que pode ser analisado.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add github/awesome-copilot --skill phoenix-tracingOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/phoenix-tracing/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Rastreamento Phoenix
Guia completo para instrumentar aplicações LLM com rastreamento OpenInference no Phoenix. Contém arquivos de referência cobrindo configuração, instrumentação, tipos de span e implantação em produção.
Quando Aplicar
Consulte estas diretrizes quando:
- Configurar o rastreamento Phoenix (Python ou TypeScript)
- Criar spans personalizados para operações LLM
- Adicionar atributos seguindo as convenções OpenInference
- Implantar rastreamento em produção
- Consultar e analisar dados de rastreamento
Categorias de Referência
| Prioridade | Categoria | Descrição | Prefixo |
|---|---|---|---|
| 1 | Configuração | Instalação e configuração | setup-* |
| 2 | Instrumentação | Rastreamento automático e manual | instrumentation-* |
| 3 | Tipos de Span | 9 tipos de span com atributos | span-* |
| 4 | Organização | Projetos e sessões | projects-*, sessions-* |
| 5 | Enriquecimento | Metadados personalizados | metadata-* |
| 6 | Produção | Processamento em lote, mascaramento | production-* |
| 7 | Feedback | Anotações e avaliação | annotations-* |
Referência Rápida
1. Configuração (COMECE AQUI)
- setup-python - Instalar arize-phoenix-otel, configurar endpoint
- setup-typescript - Instalar @arizeai/phoenix-otel, configurar endpoint
2. Instrumentação
- instrumentation-auto-python - Instrumentar automaticamente OpenAI, LangChain, etc.
- instrumentation-auto-typescript - Instrumentar automaticamente frameworks suportados
- instrumentation-manual-python - Spans personalizados com decoradores
- instrumentation-manual-typescript - Spans personalizados com wrappers
3. Tipos de Span (com esquemas de atributos completos)
- span-llm - Chamadas de API LLM (modelo, tokens, mensagens, custo)
- span-chain - Fluxos de trabalho e pipelines de múltiplos passos
- span-retriever - Recuperação de documentos (documentos, pontuações)
- span-tool - Chamadas de função/API (nome, parâmetros)
- span-agent - Agentes de raciocínio de múltiplos passos
- span-embedding - Geração de vetores
- span-reranker - Reclassificação de documentos
- span-guardrail - Verificações de segurança
- span-evaluator - Avaliação de LLM
4. Organização
- projects-python / projects-typescript - Agrupar traces por aplicação
- sessions-python / sessions-typescript - Rastrear conversas
5. Enriquecimento
- metadata-python / metadata-typescript - Atributos personalizados
6. Produção (CRÍTICO)
- production-python / production-typescript - Processamento em lote, mascaramento de PII
7. Feedback
- annotations-overview - Conceitos de feedback
- annotations-python / annotations-typescript - Adicionar feedback a spans
Arquivos de Referência
- fundamentals-overview - Noções básicas de traces, spans, atributos
- fundamentals-required-attributes - Campos obrigatórios por tipo de span
- fundamentals-universal-attributes - Atributos comuns (user.id, session.id)
- fundamentals-flattening - Regras de achatamento de JSON
Fluxos de Trabalho Comuns
- Início Rápido: setup-{lang} → instrumentation-auto-{lang} → Verificar Phoenix
- Spans Personalizados: setup-{lang} → instrumentation-manual-{lang} → span-{type}
- Rastreamento de Sessão: sessions-{lang} para padrões de agrupamento de conversas
- Produção: production-{lang} para processamento em lote, mascaramento e implantação
Como Usar Esta Habilidade
…
Perguntas frequentes
O que são 'spans'?
'Spans' são como registros individuais de uma ação específica dentro do rastreamento, como uma chamada a um modelo de IA ou a busca de informações.
O que é 'OpenInference'?
OpenInference é um padrão que ajuda a garantir que as informações de rastreamento sejam consistentes entre diferentes ferramentas.
Preciso saber programar para usar isso?
Para configurar e usar as funcionalidades básicas, um conhecimento básico de programação é útil. No entanto, a análise dos rastros pode ser feita por alguém que não programa.
Detalhes
Descrição original do autor
OpenInference semantic conventions and instrumentation for Phoenix AI observability. Use when implementing LLM tracing, creating custom spans, or deploying to production.
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5265
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC