GenAI semantic conventions

생성 AI 의미 규약

Record model-call attributes under shared field names.

···
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))}}

GenAI semantic conventions define shared names and meanings for attributes of model requests, responses, and token usage. Common fields make data easier to query across instrumentation tools.

The demo attaches common attributes to a model-call span. Do not automatically record sensitive prompt content, and check the version and stability of the conventions in use.

When to use

Use them to compare calls across models and agents with consistent fields.

Open as page ↗