생성 AI 의미 규약

GenAI semantic conventions

모델 호출의 속성을 공통 필드 이름으로 기록합니다.

···
html
<div class="demo"><div class="title">MODEL CALL SPAN</div><div class="scene"><div class="call">generate response</div><div class="attrs"><span>model = atlas-small</span><span>input = 420 tokens</span><span>output = 96 tokens</span></div></div></div>
css
.demo{width:min(94vw,690px);height:min(88vh,320px);box-sizing:border-box;padding:clamp(9px,2.5vmin,18px);border:1px solid var(--line);border-radius:14px;background:var(--surface);color:var(--fg);font:600 clamp(12px,2.4vmin,16px)/1.25 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);display:flex;flex-direction:column;gap:clamp(7px,2vmin,14px);overflow:hidden}.title{color:var(--accent);font:700 clamp(12px,2.4vmin,16px)/1.2 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);letter-spacing:.04em}.scene{flex:1;min-height:0;position:relative;display:flex;align-items:center;justify-content:center;overflow:hidden}.scene{flex-direction:column;gap:8px}.call{width:90%;box-sizing:border-box;text-align:center;padding:10px;border:1px solid var(--accent);border-radius:7px;background:color-mix(in srgb,var(--accent) 15%,var(--surface))}.attrs{width:90%;display:grid;gap:5px}.attrs span{padding:5px 8px;border-left:3px solid var(--accent-2);background:var(--bg);font:600 clamp(12px,2.4vmin,15px)/1 ui-monospace,monospace;white-space:nowrap;overflow:hidden;animation:attach 2.5s infinite}.attrs span:nth-child(2){animation-delay:.3s}.attrs span:nth-child(3){animation-delay:.6s}@keyframes attach{0%,15%,100%{transform:translateX(4px);border-color:var(--line);background:var(--bg)}35%,85%{transform:translateX(0);border-color:var(--accent-2);background:color-mix(in srgb,var(--accent-2) 15%,var(--surface))}}

생성 AI 의미 규약은 모델 요청, 응답, 토큰 사용량 같은 관측 속성의 이름과 의미를 맞추는 OpenTelemetry 규약입니다. 계측 도구가 달라도 같은 질문으로 데이터를 검색하기 쉬워집니다.

데모는 모델 호출 스팬에 공통 속성이 차례로 붙는 모습을 보여줍니다. 속성에는 민감한 프롬프트 원문을 무조건 담지 말고, 사용하는 규약 버전과 안정성 상태를 확인해야 합니다.

언제 쓰나

여러 모델·에이전트의 호출을 일관된 필드로 비교할 때 사용합니다.

페이지로 열기 ↗