fr33dr4g0n/agentry-skill

Agentry - agenten-native Analysen und Protokollierung

Agentry ist eine agenten-native Analyse- und Protokollierungslösung für Codierungsagenten. Es umfasst Produktanalysen, Fehlerprotokollierung und Bereitstellungszuordnung über eine einheitliche HTTP-API, sodass Agenten beantworten können, was Benutzer getan haben, was fehlgeschlagen ist und was sich geändert hat.

Verwenden Sie diesen Skill für die Installation/Einrichtung von Agentry, Produktanalysen, Protokollierung, Fehlerüberwachung, Bereitstellungsverfolgung, Produktionsdebugging und tägliche Agentry-Abfragen. Behandeln Sie diese Datei nicht als API-Referenz; sie ist ein kompakter Einstiegspunkt in die Live-Dokumentation.

Was als nächstes abzurufen ist

• Installation oder Einrichtung von Agentry: Rufen Sie https://agentry.sh/install.md ab.
• Beantwortung von Produkt-, Zuverlässigkeits-, Fall-, Analyse- oder Bereitstellungsfragen nach der Einrichtung: Rufen Sie https://agentry.sh/agentry.md ab.
• Entdecken der API-Oberfläche und des 3-Schreib-/3-Lese-Modells: Starten Sie unter https://api.agentry.sh/.
• Überprüfen exakter Anfrage-/Antwortformate: Rufen Sie https://api.agentry.sh/v1/openapi.json ab; filtern Sie mit ?flow=, ?tag=, ?path=&method= oder ?index=true.
• Installieren oder Aktualisieren von Future-Session-Adaptern: Rufen Sie https://api.agentry.sh/adapters ab und schreiben Sie jeden Adapter, der mit der erkannten Agenten-Harness übereinstimmt.

Verwenden Sie für direkte HTTP-Aufrufe, die nicht vom Browser stammen, einen benutzerdefinierten User-Agent-Header; Standard-Clients wie Python-urllib können blockiert werden. Browser-Fetch verwendet den eigenen User-Agent des Browsers und kann diesen Header nicht manuell setzen.

Installationsworkflow

Wenn Sie Agentry installieren, rufen Sie https://agentry.sh/install.md ab und folgen Sie diesem Ablauf. Beginnen Sie mit der wichtigen Geschäftsfrage des Repos und dem Trichter-/Geschäftslogikablauf. Lassen Sie POST /v1/install/plan die Ereignisse, Eigenschaften, Fehleroberflächen und den Bereitstellungsnachweis aus der tatsächlichen Codebasis ableiten. Schreiben Sie keinen generischen Ereigniskatalog von Hand.

Bevor Sie den Erfolg bestätigen, speichern Sie die Signalkarte und den Implementierungsbericht und überprüfen Sie dann, ob die genehmigte Telemetrie fließt.

Mentales Modell

Agentry hat drei Schreibpfade und drei Lesekonzepte.

Schreiben von Anwendungsdaten zur Laufzeit mit AGENTRY_DSN:

• POST /v1/logs/ für Fehler, Ausnahmen und Betriebsfehler.
• POST /v1/analytics/ für Produkt-, Benutzer-, Trichter- und Geschäftsereignisse.

Schreiben von Bereitstellungszuordnung mit derselben AGENTRY_DSN nur aus der CI-/Anbieter-Post-Deploy-Automatisierung nach einer erfolgreichen Veröffentlichung:

• POST /v1/deploys/ für Release-Attribution.

Lesen mit AGENTRY_API_KEY:

• Fälle: was fehlgeschlagen ist. Beginnen Sie mit GET /v1/projects/:project_id/cases, dann GET /v1/cases/:case_id.
• Analysen: was Benutzer getan haben. Beginnen Sie mit der gespeicherten Signalkarte, dem neuesten Überprüfungsbericht, Antwortverträgen, Ereignisnamen und Eigenschaftsschlüsseln; verwenden Sie dann Abfrage-Blueprints für allgemeine Lesevorgänge oder POST /v1/projects/:project_id/analytics/query für benutzerdefiniertes HogQL. Tabellenähnliche Agentry-Abfragen geben objektförmige rows zurück; lesen Sie keine PostHog-ähnlichen results von agentenorientierten Endpunkten.
• Bereitstellungen: was sich geändert hat. Verwenden Sie GET /v1/projects/:project_id/deploys.

Abfrage-Blueprints, Ereignisnamen, öffentliche Abfragen, Gesundheitsstatus und nächste Schritte sind Hilfsmittel rund um diese drei Lesekonzepte. URLs und Dashboards für öffentliche Abfragen sind optionale Ausgabeoberflächen, kein Beweis dafür, dass die zugrunde liegende Produktfrage beantwortbar ist.

Bei täglichen Fragen lesen Sie die gespeicherte Signalkarte, den neuesten Überprüfungsbericht, Antwortverträge, Ereignisnamen und Eigenschaftsschlüssel, bevor Sie einen Abfrage-Blueprint oder benutzerdefiniertes HogQL auswählen. Wenn das benötigte Ereignis/die benötigte Eigenschaft fehlt, sagen Sie, was fehlt, und verdrahten oder lösen Sie diesen Produktablauf aus, anstatt eine Metrik zu erfinden.

Authentifizierung

Lesen Sie AGENTRY_API_KEY aus der Umgebungsvariable oder aus ~/.agentry/credentials.json; lesen Sie project_id aus AGENTRY_PROJECT_ID oder aus der Datei .agentry/config.json. Ohne API-Key starten Sie den Device-Flow mit POST /v1/auth/device. Die Laufzeit-Ingestion verwendet AGENTRY_DSN.

Quelle der Wahrheit

Verlassen Sie sich nicht auf diese installierte Datei für Endpunktdetails. Rufen Sie die Live-Dokumentation oben ab; sie ist maßgeblich und kann unabhängig von Adaptern aktualisiert werden.