fr33dr4g0n/agentry-skill

Agentry - análises e logging nativos de agente

O Agentry é uma ferramenta de análises e logging nativa para agentes de codificação. Ela cobre análises de produto, registro de erros e atribuição de deploys por meio de uma única API HTTP, permitindo que agentes respondam a perguntas sobre o que os usuários fizeram, o que quebrou e o que mudou.

Use esta habilidade para instalação/configuração do Agentry, análises de produto, logging, monitoramento de erros, rastreamento de deploys, depuração em produção e leituras diárias do Agentry. Não trate este arquivo como uma referência de API; ele é um ponto de entrada compacto para a documentação ao vivo.

O que buscar em seguida

• Instalando ou configurando o Agentry: busque https://agentry.sh/install.md.
• Respondendo perguntas sobre produto, confiabilidade, casos, análises ou deploys após a configuração: busque https://agentry.sh/agentry.md.
• Descobrindo a superfície da API e o modelo 3 escrita / 3 leitura: comece em https://api.agentry.sh/.
• Verificando formas exatas de requisição/resposta: busque https://api.agentry.sh/v1/openapi.json; filtre com ?flow=, ?tag=, ?path=&method= ou ?index=true.
• Instalando ou atualizando adaptadores de sessão futura: busque https://api.agentry.sh/adapters e escreva cada adaptador que corresponda ao harness de agente detectado.

Use um cabeçalho User-Agent personalizado para chamadas HTTP diretas não-navegador; clientes padrão como Python-urllib podem ser bloqueados. O fetch do navegador usa o próprio User-Agent do navegador e não pode definir este cabeçalho manualmente.

Fluxo de instalação

Ao instalar o Agentry, busque https://agentry.sh/install.md e siga aquele fluxo. Comece pela pergunta de negócio importante do repositório e pelo fluxo de funil/lógica de negócios. Deixe o POST /v1/install/plan derivar os eventos, propriedades, superfícies de erro e prova de deploy a partir do código-fonte real. Não crie manualmente um catálogo de eventos genérico.

Antes de declarar sucesso, salve o mapa de sinais e o relatório de implementação, depois verifique se a telemetria aprovada está fluindo.

Modelo mental

O Agentry possui três caminhos de escrita e três conceitos de leitura.

Escreva dados de tempo de execução da aplicação com AGENTRY_DSN:

• POST /v1/logs/ para erros, exceções e falhas operacionais.
• POST /v1/analytics/ para eventos de produto, usuário, funil e negócios.

Escreva atribuição de deploy com o mesmo AGENTRY_DSN apenas a partir de automação pós-deploy CI/provedor após uma release bem-sucedida:

• POST /v1/deploys/ para atribuição de release.

Leia com AGENTRY_API_KEY:

• Casos: o que quebrou. Comece com GET /v1/projects/:project_id/cases, depois GET /v1/cases/:case_id.
• Análises: o que os usuários fizeram. Comece pelo mapa de sinais salvo, relatório de verificação mais recente, contratos de resposta, nomes de eventos e chaves de propriedade; em seguida, use blueprints de consulta para leituras comuns ou POST /v1/projects/:project_id/analytics/query para HogQL personalizado. Consultas de leitura do Agentry no formato de tabela retornam rows em formato de objeto; não leia resultados no estilo PostHog (results) de endpoints voltados para agentes.
• Deploys: o que mudou. Use GET /v1/projects/:project_id/deploys.

Blueprints de consulta, nomes de eventos, consultas públicas, saúde e próximos passos são auxiliares em torno desses três conceitos de leitura. URLs de consulta pública e painéis são superfícies de saída opcionais, não provas de que a pergunta de produto subjacente pode ser respondida.

Para perguntas do dia a dia, leia o mapa de sinais salvo, o relatório de verificação mais recente, os contratos de resposta, os nomes de eventos e as chaves de propriedade antes de escolher um blueprint de consulta ou HogQL personalizado. Se o evento/propriedade necessário estiver faltando, diga o que está faltando e conecte ou acione aquele fluxo de produto em vez de inventar uma métrica.

Autenticação

Leia AGENTRY_API_KEY do ambiente ou de ~/.agentry/credentials.json; leia project_id de AGENTRY_PROJECT_ID ou ~/.agentry/config.json. Sem chave de API, inicie o fluxo de dispositivo com POST /v1/auth/device. A ingestão em tempo de execução usa AGENTRY_DSN.

Fonte da verdade

Não confie neste arquivo instalado para detalhes de endpoints. Busque a documentação ao vivo acima; ela é a autoridade e pode ser atualizada independentemente dos adaptadores.