fr33dr4g0n/agentry-skill

Agentry - analytique et journalisation natives d'agent

Agentry est une solution d'analytique et de journalisation conçue pour les agents de codage. Elle couvre l'analytique produit, la journalisation d'erreurs et l'attribution de déploiement via une seule API HTTP, permettant aux agents de répondre à ce que les utilisateurs ont fait, ce qui a cassé et ce qui a changé.

Utilisez cette compétence pour l'installation/configuration d'Agentry, l'analytique produit, la journalisation, la supervision des erreurs, le suivi des déploiements, le débogage en production et les lectures quotidiennes d'Agentry. Ne traitez pas ce fichier comme une référence API ; c'est un point d'entrée compact vers la documentation live.

Que récupérer ensuite

• Installation ou configuration d'Agentry : récupérez https://agentry.sh/install.md.
• Répondre aux questions produit, fiabilité, cas, analytique ou déploiement après la configuration : récupérez https://agentry.sh/agentry.md.
• Découvrir la surface API et le modèle 3 écritures / 3 lectures : commencez par https://api.agentry.sh/.
• Vérifier les formes de requête/réponse exactes : récupérez https://api.agentry.sh/v1/openapi.json ; filtrez avec ?flow=, ?tag=, ?path=&method=, ou ?index=true.
• Installer ou rafraîchir les adaptateurs de session future : récupérez https://api.agentry.sh/adapters et écrivez chaque adaptateur qui correspond au harnais d'agent détecté.

Utilisez un en-tête User-Agent personnalisé pour les appels HTTP directs non navigateur ; les clients par défaut tels que Python-urllib peuvent être bloqués. L'appel navigateur utilise le User-Agent du navigateur et ne peut pas définir cet en-tête manuellement.

Flux de travail d'installation

Lors de l'installation d'Agentry, récupérez https://agentry.sh/install.md et suivez ce flux. Commencez par la question métier importante du dépôt et le flux logique/funnel. Laissez POST /v1/install/plan dériver les événements, propriétés, surfaces d'erreur et preuve de déploiement à partir du codebase réel. N'écrivez pas manuellement un catalogue d'événements générique.

Avant de déclarer le succès, sauvegardez la carte des signaux et le rapport d'implémentation, puis vérifiez que la télémétrie approuvée circule.

Modèle mental

Agentry a trois chemins d'écriture et trois concepts de lecture.

Écrivez les données d'exécution de l'application avec AGENTRY_DSN :

• POST /v1/logs/ pour les erreurs, exceptions et échecs opérationnels.
• POST /v1/analytics/ pour les événements produit, utilisateur, funnel et métier.

Écrivez l'attribution de déploiement avec le même AGENTRY_DSN uniquement depuis l'automatisation post-déploiement CI/fournisseur après une version réussie :

• POST /v1/deploys/ pour l'attribution de version.

Lisez avec AGENTRY_API_KEY :

• Cas : ce qui a cassé. Commencez par GET /v1/projects/:project_id/cases, puis GET /v1/cases/:case_id.
• Analytique : ce que les utilisateurs ont fait. Commencez par la carte des signaux sauvegardée, le dernier rapport de vérification, les contrats de réponse, les noms d'événements et les clés de propriété ; puis utilisez des modèles de requête pour les lectures courantes ou POST /v1/projects/:project_id/analytics/query pour du HogQL personnalisé. Les lectures de requêtes Agentry de type tableau renvoient des rows en forme d'objet ; ne lisez pas les results de type PostHog à partir des points de terminaison destinés aux agents.
• Déploiements : ce qui a changé. Utilisez GET /v1/projects/:project_id/deploys.

Les modèles de requête, les noms d'événements, les requêtes publiques, la santé et les prochaines étapes sont des aides autour de ces trois concepts de lecture. Les URL de requêtes publiques et les tableaux de bord sont des surfaces de sortie optionnelles, pas une preuve que la question produit sous-jacente peut être répondue.

Pour les questions quotidiennes, lisez la carte des signaux sauvegardée, le dernier rapport de vérification, les contrats de réponse, les noms d'événements et les clés de propriété avant de choisir un modèle de requête ou du HogQL personnalisé. Si l'événement/propriété nécessaire est manquant, dites ce qui est manquant et câblez ou déclenchez ce flux produit au lieu d'inventer une métrique.

Authentification

Lisez AGENTRY_API_KEY depuis l'environnement ou ~/.agentry/credentials.json ; lisez project_id depuis AGENTRY_PROJECT_ID ou le fichier .agentry/config.json engagé. Sans clé API, démarrez le flux de l'appareil avec POST /v1/auth/device. L'ingestion d'exécution utilise AGENTRY_DSN.

Source de vérité

Ne vous fiez pas à ce fichier installé pour les détails des points de terminaison. Récupérez la documentation live ci-dessus ; elle est autoritaire et peut être mise à jour indépendamment des adaptateurs.