fr33dr4g0n/agentry-skill

Agentry - analítica y registro nativos para agentes

Agentry es una solución de analítica y registro de eventos diseñada específicamente para agentes de código. Cubre analítica de producto, registro de errores y atribución de despliegues a través de una única API HTTP, permitiendo que los agentes respondan preguntas sobre qué hicieron los usuarios, qué falló y qué cambió.

Utiliza esta habilidad para la instalación/configuración de Agentry, analítica de producto, registro, monitoreo de errores, seguimiento de despliegues, depuración en producción y consultas diarias de Agentry. No trates este archivo como una referencia de API; es un punto de entrada compacto a la documentación en vivo.

Qué obtener a continuación

• Instalación o configuración de Agentry: obtén https://agentry.sh/install.es.md.
• Responder preguntas sobre producto, confiabilidad, casos, analítica o despliegues después de la configuración: obtén https://agentry.sh/agentry.es.md.
• Descubrir la superficie de API y el modelo de 3 escrituras / 3 lecturas: comienza en https://api.agentry.sh/.
• Verificar formas exactas de solicitud/respuesta: obtén https://api.agentry.sh/v1/openapi.json; filtra con ?flow=, ?tag=, ?path=&method=, o ?index=true.
• Instalar o actualizar adaptadores de sesiones futuras: obtén https://api.agentry.sh/adapters y escribe cada adaptador que coincida con el arnés del agente detectado.

Utiliza un encabezado User-Agent personalizado para llamadas HTTP directas que no sean de navegador; los clientes predeterminados como Python-urllib pueden ser bloqueados. La obtención desde el navegador utiliza el User-Agent propio del navegador y no puede establecer este encabezado manualmente.

Flujo de instalación

Al instalar Agentry, obtén https://agentry.sh/install.es.md y sigue ese flujo. Comienza desde la pregunta comercial importante del repositorio y el flujo de lógica de negocio/embudo. Deja que POST /v1/install/plan derive los eventos, propiedades, superficies de error y prueba de despliegue a partir del código base real. No redactes manualmente un catálogo de eventos genérico.

Antes de declarar éxito, guarda el mapa de señales y el informe de implementación, luego verifica que la telemetría aprobada esté fluyendo.

Modelo mental

Agentry tiene tres rutas de escritura y tres conceptos de lectura.

Escribir datos de tiempo de ejecución de la aplicación con AGENTRY_DSN:

• POST /v1/logs/ para errores, excepciones y fallos operativos.
• POST /v1/analytics/ para eventos de producto, usuario, embudo y negocio.

Escribir atribución de despliegues con el mismo AGENTRY_DSN solo desde la automatización posterior al despliegue en CI/proveedor después de un lanzamiento exitoso:

• POST /v1/deploys/ para atribución de versiones.

Leer con AGENTRY_API_KEY:

• Casos: qué falló. Comienza con GET /v1/projects/:project_id/cases, luego GET /v1/cases/:case_id.
• Analítica: qué hicieron los usuarios. Comienza desde el mapa de señales guardado, el último informe de verificación, contratos de respuesta, nombres de eventos y claves de propiedades; luego usa planillas de consulta para lecturas comunes o POST /v1/projects/:project_id/analytics/query para HogQL personalizado. Las lecturas de consulta de Agentry similares a tablas devuelven rows en forma de objeto; no leas resultados de estilo PostHog desde endpoints orientados a agentes.
• Despliegues: qué cambió. Usa GET /v1/projects/:project_id/deploys.

Las planillas de consulta, nombres de eventos, consultas públicas, estado y próximos pasos son ayudas alrededor de esos tres conceptos de lectura. Las URLs de consulta pública y los tableros son superficies de salida opcionales, no una prueba de que la pregunta de producto subyacente sea respondible.

Para preguntas del día a día, lee el mapa de señales guardado, el último informe de verificación, contratos de respuesta, nombres de eventos y claves de propiedades antes de elegir una planilla de consulta o HogQL personalizado. Si falta el evento/propiedad necesario, di qué falta y conecta o activa ese flujo de producto en lugar de inventar una métrica.

Autenticación

Lee AGENTRY_API_KEY desde el entorno o ~/.agentry/credentials.json; lee project_id desde AGENTRY_PROJECT_ID o el archivo .agentry/config.json. Sin clave API, inicia el flujo de dispositivo con POST /v1/auth/device. La ingesta en tiempo de ejecución usa AGENTRY_DSN.

Fuente de verdad

No dependas de este archivo instalado para detalles de endpoints. Obtén la documentación en vivo anterior; es autoritativa y puede actualizarse independientemente de los adaptadores.