llm_request_completed: 소유된 경계에서 신뢰할 수 있는 쿼리로
llm_request_completed를 내구성 있는 분석 계약으로 취급합니다. 소유자는 문서화된 하나의 그레인을 내보내고 고정 장치가 필드를 증명하며 검토된 쿼리가 명시된 질문에 답합니다.
- 1
결과가 최종적이 됨
Shared model gateway or provider adapter emits only after token usage, outcome, and provider response are final.
- 2
필드 선택
9 required fields preserve the declared grain: One completed model-provider request.
- 3
고정 장치가 확인되었습니다.
유형, UTC 시간, 대체 결과, 멱등성, 모든 가명 또는 검토 분류 필드를 확인하세요.
- 4
질문에 답변됨
성공적인 AI 워크플로 비용은 얼마이며 성능은 얼마나 좋습니까?
곡물
완료된 모델 제공자 요청 1개
소유자
공유 모델 게이트웨이 또는 제공자 어댑터
언제 방출
토큰 사용 후 결과 및 공급자 응답이 최종입니다.
현장 계약
필드 유형과 제외할 데이터
프로덕션 쿼리가 종속된 후에도 기존 필드 이름과 유형을 안정적으로 유지합니다. 선택적 컨텍스트는 특정 결정에 따라 제한되고, 문서화되고, 정당화되어야 합니다.
| 필드 | 유형 | 필수 | 개인 정보 보호 | 의미 |
|---|---|---|---|---|
| timestamp_utc | timestamp | yes | non-sensitive | 결과 경계의 UTC 시간입니다. |
| event_id | string | yes | non-sensitive | 중복 제거에 사용되는 안정적인 고유 식별자입니다. |
| release | string | yes | non-sensitive | 이벤트를 생성한 애플리케이션 또는 서비스 버전입니다. |
| account_id | string | yes | pseudonymous | 안정적인 내부 계정 식별자이며 이메일이나 이름이 아닙니다. |
| feature | string | yes | non-sensitive | 해당 모델을 사용한 안정적인 제품 기능이나 워크플로우. |
| model | string | yes | non-sensitive | 공급자 모델 식별자입니다. |
| input_tokens | number | yes | non-sensitive | 공급자가 보고한 입력 토큰입니다. |
| output_tokens | number | yes | non-sensitive | 공급자가 보고한 출력 토큰입니다. |
| estimated_cost_usd | number | no | non-sensitive | 예상 할당 비용은 별도로 조정됩니다. |
| status | string | yes | non-sensitive | 최종 공급자 또는 워크플로 결과. |
합성 JSON 이벤트
{
"timestamp_utc": "2026-07-28T14:18:44Z",
"event_id": "evt_llm_01",
"account_id": "acct_8f31",
"release": "2026.07.2",
"feature": "query_explanation",
"model": "model_family_a",
"input_tokens": 820,
"output_tokens": 244,
"estimated_cost_usd": 0.0124,
"status": "success"
}개인정보 보호 검토
수집 전 식별자 검토
이 예에서는 합성 식별자를 사용합니다. 가명 값은 여전히 개인 데이터일 수 있으며 검토 필드는 비즈니스 또는 공급자 컨텍스트를 노출할 수 있습니다. 귀하의 동의, 보존, 액세스, 거주 및 삭제 요구 사항을 적용하십시오.
account_id: pseudonymous
검증 체크리스트
대시보드를 구축하기 전에 계약을 증명하세요.
- Send one known llm_request_completed fixture after the documented outcome boundary.
- Verify all 9 required fields arrive with the documented types.
- 동일한 이벤트 식별자를 다시 시도하고 선택한 중복 제거 동작을 확인하세요.
- 워크플로에서 지원하는 경우 제어된 실패 또는 대체 결과를 보냅니다.
- 고정된 창에서 관련 SQL을 실행하고 결과를 고정 장치에 맞게 조정합니다.
일반적인 실수
하나의 행을 하나의 지속 가능한 결과와 동일하게 유지
- Emitting llm_request_completed before shared model gateway or provider adapter knows the final outcome.
- 한 테이블에 여러 곡물이 섞여 있어 개수와 비율이 모호해집니다.
- 제어된 카테고리를 원시 URL, 페이로드, 프롬프트 또는 오류 텍스트로 대체합니다.
- 저장된 쿼리 및 대시보드 이후에 필드 유형을 변경하는 것이 이에 따라 달라집니다.
- 문서화된 조사, 액세스, 보관 요구 없이 식별자를 추가합니다.
계약을 사용하세요
이벤트 쿼리 및 운영화
관련 계약
프로덕션 트래픽을 연결하기 전에 테스트 이벤트 보내기
라이브 워크플로를 연결하기 전에 무료 API 키를 생성하고, 합성 이벤트를 보내고, 추론된 테이블을 검사하세요.