ai_agent_run_completed 이벤트 스키마

측정 경로

하나의 완료된 실행이 재사용 가능한 분석 계약이 됩니다.

소유자가 최종 결과를 알고 난 후에만 내보내고 대시보드나 평가 워크플로가 이에 의존하기 전에 저장된 계약을 검증하세요.

1
실행 완료
애플리케이션은 최종 상태, 도구, 전달, 기간, 토큰 및 비용을 알고 있습니다.
2
방출된 계약
프롬프트나 도구 페이로드를 복사하지 않고 제한된 필드와 승인된 식별자를 보냅니다.
3
고정 장치 확인됨
필수 유형, 개인 정보 보호 필드, 재시도 및 알려진 대체 결과 하나를 검사합니다.
4
분석 재사용
Power는 기능 및 릴리스별로 SQL의 품질, 신뢰성 및 단위 경제성을 검토했습니다.

곡물

논리적 에이전트 실행당 하나의 최종 결과입니다.

소유자

제품 결과가 결정된 후 에이전트 조정자

언제 방출

성공 후, 실패, 취소 또는 사람의 핸드오프가 최종 결정됩니다.

현장 계약

명시적인 개인정보 보호 경계가 있는 타입이 지정된 필드

프로덕션 쿼리가 종속된 후에도 기존 필드 이름과 유형을 안정적으로 유지합니다. 선택적 컨텍스트는 특정 결정에 따라 제한되고, 문서화되고, 정당화되어야 합니다.

필드	유형	필수	개인 정보 보호	의미
timestamp_utc	timestamp	yes	non-sensitive	결과 경계의 UTC 시간입니다.
event_id	string	yes	non-sensitive	중복 제거에 사용되는 안정적인 고유 식별자입니다.
release	string	yes	non-sensitive	이벤트를 생성한 애플리케이션 또는 서비스 버전입니다.
account_id	string	yes	pseudonymous	안정적인 내부 계정 식별자이며 이메일이나 이름이 아닙니다.
run_id	string	yes	pseudonymous	승인된 단계 수준 이벤트에서 공유되는 안정적인 식별자입니다.
workflow	string	yes	non-sensitive	에이전트가 처리하는 버전이 지정된 제품 워크플로입니다.
status	string	yes	non-sensitive	성공, 실패, 취소 또는 human_handoff.
tool_call_count	number	yes	non-sensitive	논리적 실행의 총 도구 호출입니다.
estimated_cost_usd	number	no	non-sensitive	버전이 지정된 예상 공급자 비용 할당.
task_completed	boolean	yes	non-sensitive	제품 수준의 성공 정의를 검토했습니다.

합성 JSON 이벤트

{
  "timestamp_utc": "2026-07-29T09:29:40Z",
  "event_id": "evt_agent_01",
  "account_id": "acct_8f31",
  "release": "2026.07.3",
  "run_id": "run_f28c",
  "workflow": "support_resolution_v3",
  "status": "success",
  "tool_call_count": 3,
  "estimated_cost_usd": 0.021,
  "task_completed": true
}

개인정보 보호 검토

수집 전 식별자 검토

이 예에서는 합성 식별자를 사용합니다. 가명 값은 여전히 개인 데이터일 수 있으며 검토 필드는 비즈니스 또는 공급자 컨텍스트를 노출할 수 있습니다. 귀하의 동의, 보존, 액세스, 거주 및 삭제 요구 사항을 적용하십시오.

account_id: pseudonymous
run_id: pseudonymous

검증 체크리스트

대시보드를 구축하기 전에 계약을 증명하세요.

Send one known ai_agent_run_completed fixture after the documented outcome boundary.
Verify all 9 required fields arrive with the documented types.
동일한 이벤트 식별자를 다시 시도하고 선택한 중복 제거 동작을 확인하세요.
워크플로에서 지원하는 경우 제어된 실패 또는 대체 결과를 보냅니다.
고정된 창에서 관련 SQL을 실행하고 결과를 고정 장치에 맞게 조정합니다.

일반적인 실수

하나의 행을 하나의 지속 가능한 결과와 동일하게 유지

Emitting ai_agent_run_completed before agent orchestrator after the product outcome is determined knows the final outcome.
한 테이블에 여러 곡물이 섞여 있어 개수와 비율이 모호해집니다.
제어된 카테고리를 원시 URL, 페이로드, 프롬프트 또는 오류 텍스트로 대체합니다.
저장된 쿼리 및 대시보드 이후에 필드 유형을 변경하는 것이 이에 따라 달라집니다.
문서화된 조사, 액세스, 보관 요구 없이 식별자를 추가합니다.

계약을 사용하세요