Agentry - 에이전트 네이티브 분석 및 로깅
Agentry는 코딩 에이전트를 위한 에이전트 네이티브 분석 및 로깅 도구입니다. 제품 분석, 오류 로깅, 배포 속성 추적을 하나의 HTTP API로 제공하여 에이전트가 사용자의 활동, 장애 원인, 변경 사항을 파악할 수 있도록 지원합니다.
이 스킬은 Agentry 설치/설정, 제품 분석, 로깅, 오류 모니터링, 배포 추적, 프로덕션 디버깅, 일상적인 Agentry 데이터 조회에 사용하세요. 이 파일을 API 참조 문서로 취급하지 마십시오. 이 파일은 실시간 문서로 연결되는 간결한 진입점입니다.
다음에 가져올 내용
- Agentry 설치 또는 설정: https://agentry.sh/install.md 를 가져오세요.
- 설정 후 제품, 신뢰성, 사례, 분석 또는 배포 관련 질문: https://agentry.sh/agentry.md 를 가져오세요.
- API 표면 및 3가지 쓰기/3가지 읽기 모델 확인: https://api.agentry.sh/ 에서 시작하세요.
- 정확한 요청/응답 형식 확인: https://api.agentry.sh/v1/openapi.json 을 가져오고,
?flow=,?tag=,?path=&method=또는?index=true로 필터링하세요. - 향후 세션 어댑터 설치 또는 새로 고침: https://api.agentry.sh/adapters 를 가져와서 감지된 에이전트 환경과 일치하는 모든 어댑터를 작성하세요.
비브라우저 직접 HTTP 호출에는 커스텀 User-Agent 헤더를 사용하세요. Python-urllib 과 같은 기본 클라이언트는 차단될 수 있습니다. 브라우저 fetch는 브라우저 자체 User-Agent를 사용하며 이 헤더를 수동으로 설정할 수 없습니다.
설치 워크플로우
Agentry를 설치할 때는 https://agentry.sh/install.md 를 가져와 해당 흐름을 따르세요. 저장소의 중요한 비즈니스 질문과 퍼널/비즈니스 로직 흐름에서 시작하세요. POST /v1/install/plan 이 실제 코드베이스에서 이벤트, 속성, 오류 표면, 배포 증명을 도출하도록 하세요. 일반적인 이벤트 카탈로그를 직접 작성하지 마십시오.
성공을 주장하기 전에 신호 맵과 구현 보고서를 저장한 다음, 승인된 원격 측정이 전송되고 있는지 확인하세요.
개념 모델
Agentry에는 세 가지 쓰기 경로와 세 가지 읽기 개념이 있습니다.
AGENTRY_DSN 으로 앱 런타임 데이터 쓰기:
POST /v1/logs/: 오류, 예외, 운영 실패POST /v1/analytics/: 제품, 사용자, 퍼널, 비즈니스 이벤트
동일한 AGENTRY_DSN 으로 배포 속성 쓰기 (성공적인 릴리스 후 CI/공급자 사후 배포 자동화에서만):
POST /v1/deploys/: 릴리스 속성
AGENTRY_API_KEY 로 읽기:
- 사례(Cases): 무엇이 고장 났는가.
GET /v1/projects/:project_id/cases로 시작한 다음GET /v1/cases/:case_id. - 분석(Analytics): 사용자가 무엇을 했는가. 저장된 신호 맵, 최신 확인 보고서, 답변 계약, 이벤트 이름, 속성 키에서 시작합니다. 그런 다음 일반적인 읽기에는 쿼리 블루프린트를 사용하거나 커스텀 HogQL에는
POST /v1/projects/:project_id/analytics/query를 사용합니다. 테이블 형식의 Agentry 쿼리 읽기는 객체 형태의rows를 반환합니다. 에이전트 지향 엔드포인트에서 PostHog 스타일의results를 읽지 마십시오. - 배포(Deploys): 무엇이 변경되었는가.
GET /v1/projects/:project_id/deploys를 사용합니다.
쿼리 블루프린트, 이벤트 이름, 공개 쿼리, 상태, 다음 단계는 이 세 가지 읽기 개념을 지원하는 도우미입니다. 공개 쿼리 URL과 대시보드는 선택적 출력 표면일 뿐, 기본 제품 질문에 답할 수 있다는 증거는 아닙니다.
일상적인 질문의 경우, 쿼리 블루프린트나 커스텀 HogQL을 선택하기 전에 저장된 신호 맵, 최신 확인 보고서, 답변 계약, 이벤트 이름, 속성 키를 읽으세요. 필요한 이벤트/속성이 없으면, 무엇이 누락되었는지 말하고 메트릭을 발명하는 대신 해당 제품 흐름을 연결하거나 트리거하세요.
인증
환경 변수 또는 ~/.agentry/credentials.json 에서 AGENTRY_API_KEY 를 읽습니다. AGENTRY_PROJECT_ID 또는 커밋된 .agentry/config.json 에서 project_id 를 읽습니다. API 키가 없으면 POST /v1/auth/device 로 디바이스 흐름을 시작합니다. 런타임 수집은 AGENTRY_DSN 을 사용합니다.
진실 공급원
엔드포인트 세부 정보에 대해 이 설치된 파일에 의존하지 마십시오. 위의 실시간 문서를 가져오세요. 해당 문서는 권위 있는 문서이며 어댑터와 독립적으로 업데이트될 수 있습니다.