이벤트 및 구성

​

이벤트 패밀리

• 에이전트 시작, 종료, 일시 중지, 재개
• 모델 요청 및 응답
• 도구 사용 및 결과
• 훅 트리거 및 완료
• 사람 대기, 입력, 일시 중지, 중단
• 명시적 오류

​

이벤트 계약 검사

• 대시보드
• CLI

1. Observe → Events를 엽니다.
2. 짧은 시간 범위를 설정하고 환경, 에이전트, 이벤트 유형별로 필터링합니다.
3. 이벤트를 선택하여 정규화된 필드와 원시 페이로드를 검사한 다음, 해당 세션을 열어 실행 컨텍스트를 확인합니다.
4. 쌍으로 연결된 지속 시간이 없는 경우, 시작 이벤트와 완료 이벤트가 동일한 상관관계 ID를 사용하는지 확인합니다.

Events 스트림을 사용하여 데이터를 단일 에이전트 실행으로 좁히고 정규화된 이벤트 필드를 검사합니다.그런 다음 이벤트에서 해당 세션으로 이동합니다. 트레이스는 이벤트 직전과 직후에 발생한 일을 보여주며, 페이로드만으로는 모호한 상황을 파악할 때 필수적입니다.쌍으로 연결된 이벤트나 지속 시간이 없는 경우, 두 보기 모두에서 상관관계 ID와 타임스탬프를 비교합니다.

유효한 필터 값을 확인한 다음, 하나의 세션에 대한 전체 이벤트 페이로드를 가져옵니다:

fp list event_types
fp list envs
fp events --since 1h \
  --env production \
  --event-type tool_use,tool_result \
  --session-id <session-id> \
  --full

머신 판독 가능한 검사를 위해 fp --json events ... --fields ts,event_type,session_id,payload를 사용합니다.

​

예약된 SDK 필드

​

로컬 경계

• Failproof AI 상태는 별도로 구성하지 않는 한 ~/.failproofai 아래에 저장됩니다.
• failproofai-sdk는 항상 ~/.failproofai/custom-agents 아래에 스풀링됩니다. FAILPROOFAI_HOME은 해당 홈 디렉터리를 재배치하며, custom-agents 세그먼트는 항상 추가되므로 스풀을 그 밖에 배치할 수 없습니다. SDK 자체의 configure(base_dir=...)만 다른 위치에 씁니다. AGENTEYE_HOME은 구버전 agenteye-collector에서 감시 대상을 선택할 때 읽으며, 더 이상 SDK의 쓰기 위치에 영향을 주지 않습니다.
• 환경 레이블은 SDK 구성 또는 AGENTEYE_ENVIRONMENT를 통해 설정할 수 있습니다.
• 데몬 자격 증명은 비밀이 아닌 설정과 별도로 저장됩니다.

​

환경 레이블 변경

export AGENTEYE_ENVIRONMENT=production-us-east
failproofai config
failproofai config --status
fp sessions --since 1h --env production-us-east