# GenAI attribute conformance

<!-- Generated by `pnpm --filter @bucker/api genai-conformance:emit`. Do not edit by hand:
     `test/otlp/genai-conformance.test.ts` fails when this page differs from the code. -->

Bucker reads every GenAI vocabulary into one internal schema named after OpenTelemetry GenAI
and records which vocabulary each fact came from. This page says, per attribute key, what
happens to it:

- **read**: a key in an OTel GenAI generation (the schema's own spellings).
- **aliased**: a key from another vocabulary, folded into the same fact.
- **ignored**: a key Bucker recognises and deliberately does not consume.

Any other `gen_ai.*` key stays raw on the span and is counted per project for seven days, so an agent can tell instrumentation newer than Bucker from no instrumentation. Registry pin: semantic-conventions `v1.44.0`.

**Cache accounting.** A span whose cache counts arrive under a registry spelling
(`gen_ai.usage.cache_read.input_tokens`, `gen_ai.usage.cache_write.input_tokens`,
`gen_ai.usage.cache_creation.input_tokens`) is priced `inclusive`: its `input_tokens` already
contains both, so both are subtracted before the input rate applies. Every other spelling is
`exclusive` and keeps the provider rule; a span with no cache count is `unknown`.

**Content.** Keys marked `content` carry message text. They are read in memory so detectors
and the cost meter can run, then stripped under the default `metadata` capture mode.

| Key | Member | Status | Feeds | Vocabulary | Generation | Content | Note |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `bucker.agent.session_id` |  | aliased | `sessionId` | bucker | fixpoint |  |  |
| `bucker.agent.step` |  | aliased | `stepIndex` | bucker | fixpoint |  |  |
| `bucker.agent.turn` |  | aliased | `turnIndex` | bucker | fixpoint |  |  |
| `bucker.feature` |  | aliased | `feature` | bucker | fixpoint |  |  |
| `bucker.output.format` |  | aliased | `outputFormat` | bucker | fixpoint |  |  |
| `bucker.output.schema` |  | aliased | `outputSchema` | bucker | fixpoint |  |  |
| `bucker.prompt.key` |  | aliased | `promptKey` | bucker | fixpoint |  |  |
| `bucker.prompt.version` |  | aliased | `promptVersion` | bucker | fixpoint |  |  |
| `bucker.retrieval.document_count` |  | aliased | `retrievalDocumentCount` | bucker | fixpoint |  |  |
| `bucker.retrieval.query` |  | aliased | `retrievalQuery` | bucker | fixpoint | content |  |
| `bucker.tool.schema` |  | aliased | `toolSchema` | bucker | fixpoint |  |  |
| `bucker.user.id` |  | aliased | `userId` | bucker | fixpoint |  |  |
| `bucker.workspace.id` |  | aliased | `workspaceId` | bucker | fixpoint |  |  |
| `langfuse.observation.input` |  | aliased | `toolArguments` | langfuse | langfuse | content |  |
| `langfuse.observation.model.name` |  | aliased | `requestModel` | langfuse | langfuse |  |  |
| `langfuse.observation.output` |  | aliased | `responseText` | langfuse | langfuse | content |  |
| `langfuse.observation.output` |  | aliased | `toolResult` | langfuse | langfuse | content |  |
| `langfuse.observation.prompt.name` |  | aliased | `promptKey` | langfuse | langfuse |  |  |
| `langfuse.observation.prompt.version` |  | aliased | `promptVersion` | langfuse | langfuse |  |  |
| `langfuse.observation.type` |  | aliased | `operation` | langfuse | langfuse |  |  |
| `langfuse.observation.usage_details` | `cache_creation_input_tokens` | aliased | `cacheWriteTokens` | langfuse | langfuse |  |  |
| `langfuse.observation.usage_details` | `cache_read_input_tokens` | aliased | `cacheReadTokens` | langfuse | langfuse |  |  |
| `langfuse.observation.usage_details` | `input` | aliased | `inputTokens` | langfuse | langfuse |  |  |
| `langfuse.observation.usage_details` | `input_cached_tokens` | aliased | `cacheReadTokens` | langfuse | langfuse |  |  |
| `langfuse.observation.usage_details` | `output` | aliased | `outputTokens` | langfuse | langfuse |  |  |
| `langfuse.observation.usage_details` | `reasoning_tokens` | aliased | `reasoningTokens` | langfuse | langfuse |  |  |
| `langfuse.observation.usage_details` | `total` | aliased | `totalTokens` | langfuse | langfuse |  |  |
| `langfuse.session.id` |  | aliased | `conversationId` | langfuse | langfuse |  |  |
| `langfuse.session.id` |  | aliased | `sessionId` | langfuse | langfuse |  |  |
| `langfuse.user.id` |  | aliased | `userId` | langfuse | langfuse |  |  |
| `mlflow.chat.tokenUsage` | `input_tokens` | aliased | `inputTokens` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.chat.tokenUsage` | `output_tokens` | aliased | `outputTokens` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.chat.tokenUsage` | `total_tokens` | aliased | `totalTokens` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.chat.tools` |  | aliased | `toolSchema` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.llm.model` |  | aliased | `requestModel` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.llm.provider` |  | aliased | `provider` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.spanInputs` |  | aliased | `toolArguments` | mlflow | mlflow | content | JSON-encoded value |
| `mlflow.spanOutputs` |  | aliased | `responseText` | mlflow | mlflow | content | JSON-encoded value |
| `mlflow.spanOutputs` |  | aliased | `toolResult` | mlflow | mlflow | content | JSON-encoded value |
| `mlflow.spanType` |  | aliased | `operation` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.trace.session` |  | aliased | `conversationId` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.trace.session` |  | aliased | `sessionId` | mlflow | mlflow |  | JSON-encoded value |
| `mlflow.trace.user` |  | aliased | `userId` | mlflow | mlflow |  | JSON-encoded value |
| `graph.node.id` |  | aliased | `agentName` | openinference | openinference |  |  |
| `input.value` |  | aliased | `retrievalQuery` | openinference | openinference | content |  |
| `llm.model_name` |  | aliased | `requestModel` | openinference | openinference |  |  |
| `llm.output_messages` |  | aliased | `responseText` | openinference | openinference | content |  |
| `llm.prompt_template.name` |  | aliased | `promptKey` | openinference | openinference |  |  |
| `llm.prompt_template.version` |  | aliased | `promptVersion` | openinference | openinference |  |  |
| `llm.provider` |  | aliased | `provider` | openinference | openinference |  |  |
| `llm.response.finish_reason` |  | aliased | `finishReasons` | openinference | openinference |  |  |
| `llm.system` |  | aliased | `provider` | openinference | openinference |  |  |
| `llm.token_count.completion` |  | aliased | `outputTokens` | openinference | openinference |  |  |
| `llm.token_count.completion_details.reasoning` |  | aliased | `reasoningTokens` | openinference | openinference |  |  |
| `llm.token_count.prompt` |  | aliased | `inputTokens` | openinference | openinference |  |  |
| `llm.token_count.prompt_details.cache_read` |  | aliased | `cacheReadTokens` | openinference | openinference |  |  |
| `llm.token_count.prompt_details.cache_write` |  | aliased | `cacheWriteTokens` | openinference | openinference |  |  |
| `llm.token_count.total` |  | aliased | `totalTokens` | openinference | openinference |  |  |
| `openinference.span.kind` |  | aliased | `operation` | openinference | openinference |  |  |
| `output.value` |  | aliased | `responseText` | openinference | openinference | content |  |
| `retrieval.document_count` |  | aliased | `retrievalDocumentCount` | openinference | openinference |  |  |
| `retrieval.documents` |  | aliased | `retrievalDocuments` | openinference | openinference | content |  |
| `session.id` |  | aliased | `sessionId` | openinference | openinference |  |  |
| `tool.error` |  | aliased | `toolFailed` | openinference | openinference |  |  |
| `tool.json_schema` |  | aliased | `toolSchema` | openinference | openinference |  |  |
| `tool.name` |  | aliased | `toolName` | openinference | openinference |  |  |
| `tool.parameters` |  | aliased | `toolArguments` | openinference | openinference | content |  |
| `tool.result` |  | aliased | `toolResult` | openinference | openinference | content |  |
| `tool_call.function.arguments` |  | aliased | `toolArguments` | openinference | openinference | content |  |
| `tool_call.function.name` |  | aliased | `toolName` | openinference | openinference |  |  |
| `tool_call.id` |  | aliased | `toolCallId` | openinference | openinference |  |  |
| `gen_ai.usage.reasoning_tokens` |  | aliased | `reasoningTokens` | openllmetry | openllmetry |  |  |
| `gen_ai.vendor` |  | aliased | `provider` | openllmetry | openllmetry |  |  |
| `llm.request.model` |  | aliased | `requestModel` | openllmetry | openllmetry |  |  |
| `llm.response.id` |  | aliased | `responseId` | openllmetry | openllmetry |  |  |
| `llm.response.model` |  | aliased | `responseModel` | openllmetry | openllmetry |  |  |
| `llm.response.stop_reason` |  | aliased | `finishReasons` | openllmetry | openllmetry |  |  |
| `llm.usage.completion_tokens` |  | aliased | `outputTokens` | openllmetry | openllmetry |  |  |
| `llm.usage.prompt_tokens` |  | aliased | `inputTokens` | openllmetry | openllmetry |  |  |
| `llm.usage.total_tokens` |  | aliased | `totalTokens` | openllmetry | openllmetry |  |  |
| `traceloop.association.properties.session_id` |  | aliased | `sessionId` | openllmetry | openllmetry |  |  |
| `traceloop.association.properties.user_id` |  | aliased | `userId` | openllmetry | openllmetry |  |  |
| `traceloop.entity.input` |  | aliased | `toolArguments` | openllmetry | openllmetry | content |  |
| `traceloop.entity.name` |  | aliased | `agentName` | openllmetry | openllmetry |  |  |
| `traceloop.entity.output` |  | aliased | `responseText` | openllmetry | openllmetry | content |  |
| `traceloop.entity.output` |  | aliased | `toolResult` | openllmetry | openllmetry | content |  |
| `traceloop.prompt.key` |  | aliased | `promptKey` | openllmetry | openllmetry |  |  |
| `traceloop.prompt.version` |  | aliased | `promptVersion` | openllmetry | openllmetry |  |  |
| `traceloop.span.kind` |  | aliased | `operation` | openllmetry | openllmetry |  |  |
| `anthropic.workspace.id` |  | read | `workspaceId` | otel | otel-2025 |  |  |
| `anthropic.workspace_id` |  | read | `workspaceId` | otel | otel-2025 |  |  |
| `app.feature` |  | read | `feature` | otel | otel-2025 |  |  |
| `enduser.id` |  | read | `userId` | otel | otel-2025 |  |  |
| `feature.name` |  | read | `feature` | otel | otel-2025 |  |  |
| `gen_ai.agent.id` |  | read | `agentName` | otel | otel-2025 |  |  |
| `gen_ai.agent.name` |  | read | `agentName` | otel | otel-2025 |  |  |
| `gen_ai.agent.step` |  | read | `stepIndex` | otel | otel-2025 |  |  |
| `gen_ai.conversation.id` |  | read | `conversationId` | otel | otel-2025 |  |  |
| `gen_ai.conversation.id` |  | read | `sessionId` | otel | otel-2025 |  |  |
| `gen_ai.conversation.turn` |  | read | `turnIndex` | otel | otel-2025 |  |  |
| `gen_ai.operation.name` |  | read | `operation` | otel | otel-2025 |  |  |
| `gen_ai.output.messages` |  | read | `responseText` | otel | otel-2025 | content |  |
| `gen_ai.output.type` |  | read | `outputFormat` | otel | otel-2025 |  |  |
| `gen_ai.prompt.id` |  | read | `promptKey` | otel | otel-2025 | content |  |
| `gen_ai.prompt.version` |  | read | `promptVersion` | otel | otel-2025 | content |  |
| `gen_ai.provider.name` |  | read | `provider` | otel | otel-2025 |  |  |
| `gen_ai.request.model` |  | read | `requestModel` | otel | otel-2025 |  |  |
| `gen_ai.request.response_format` |  | read | `outputFormat` | otel | otel-2025 |  |  |
| `gen_ai.request.response_json_schema` |  | read | `outputSchema` | otel | otel-2025 |  |  |
| `gen_ai.response.finish_reasons` |  | read | `finishReasons` | otel | otel-2025 |  |  |
| `gen_ai.response.id` |  | read | `responseId` | otel | otel-2025 |  |  |
| `gen_ai.response.model` |  | read | `responseModel` | otel | otel-2025 |  |  |
| `gen_ai.retrieval.document_count` |  | read | `retrievalDocumentCount` | otel | otel-2025 |  |  |
| `gen_ai.retrieval.documents` |  | read | `retrievalDocuments` | otel | otel-2025 | content |  |
| `gen_ai.retrieval.query` |  | read | `retrievalQuery` | otel | otel-2025 | content |  |
| `gen_ai.step.number` |  | read | `stepIndex` | otel | otel-2025 |  |  |
| `gen_ai.tool.call.arguments` |  | read | `toolArguments` | otel | otel-2025 | content |  |
| `gen_ai.tool.call.error` |  | read | `toolFailed` | otel | otel-2025 |  |  |
| `gen_ai.tool.call.id` |  | read | `toolCallId` | otel | otel-2025 |  |  |
| `gen_ai.tool.call.result` |  | read | `toolResult` | otel | otel-2025 | content |  |
| `gen_ai.tool.name` |  | read | `toolName` | otel | otel-2025 |  |  |
| `gen_ai.tool.parameters.schema` |  | read | `toolSchema` | otel | otel-2025 |  |  |
| `gen_ai.usage.cache_creation_input_tokens` |  | read | `cacheWriteTokens` | otel | otel-2025 |  |  |
| `gen_ai.usage.cache_read_input_tokens` |  | read | `cacheReadTokens` | otel | otel-2025 |  |  |
| `gen_ai.usage.input_tokens` |  | read | `inputTokens` | otel | otel-2025 |  |  |
| `gen_ai.usage.output_tokens` |  | read | `outputTokens` | otel | otel-2025 |  |  |
| `gen_ai.usage.total_tokens` |  | read | `totalTokens` | otel | otel-2025 |  |  |
| `user.id` |  | read | `userId` | otel | otel-2025 |  |  |
| `gen_ai.completion` |  | read | `responseText` | otel | otel-legacy | content |  |
| `gen_ai.response.finish_reason` |  | read | `finishReasons` | otel | otel-legacy |  |  |
| `gen_ai.session.id` |  | read | `sessionId` | otel | otel-legacy |  |  |
| `gen_ai.system` |  | read | `provider` | otel | otel-legacy |  |  |
| `gen_ai.thread.id` |  | read | `conversationId` | otel | otel-legacy |  |  |
| `gen_ai.thread.id` |  | read | `sessionId` | otel | otel-legacy |  |  |
| `gen_ai.tool.call.name` |  | read | `toolName` | otel | otel-legacy |  |  |
| `gen_ai.tool.input` |  | read | `toolArguments` | otel | otel-legacy | content |  |
| `gen_ai.tool.output` |  | read | `toolResult` | otel | otel-legacy | content |  |
| `gen_ai.usage.cached_input_tokens` |  | read | `cacheReadTokens` | otel | otel-legacy |  |  |
| `gen_ai.usage.completion_tokens` |  | read | `outputTokens` | otel | otel-legacy |  |  |
| `gen_ai.usage.prompt_tokens` |  | read | `inputTokens` | otel | otel-legacy |  |  |
| `session.id` |  | read | `conversationId` | otel | otel-legacy |  |  |
| `gen_ai.agent.description` |  | ignored | - | otel | otel-registry |  | free text, not a fact |
| `gen_ai.agent.version` |  | ignored | - | otel | otel-registry |  | not used by any detector yet |
| `gen_ai.client.operation.time_to_first_chunk` |  | read | `ttfcMs` | otel | otel-registry |  | value x1000 (seconds to milliseconds) |
| `gen_ai.data_source.id` |  | ignored | - | otel | otel-registry |  | not used by any detector yet |
| `gen_ai.embeddings.dimension.count` |  | ignored | - | otel | otel-registry |  | not used by any detector yet |
| `gen_ai.evaluation.explanation` |  | ignored | - | otel | otel-registry |  | free text |
| `gen_ai.evaluation.name` |  | ignored | - | otel | otel-registry |  | evaluation results are ingested by LLM-10, not as span facts |
| `gen_ai.evaluation.score.label` |  | ignored | - | otel | otel-registry |  | evaluation results are ingested by LLM-10 |
| `gen_ai.evaluation.score.value` |  | ignored | - | otel | otel-registry |  | evaluation results are ingested by LLM-10 |
| `gen_ai.request.choice.count` |  | ignored | - | otel | otel-registry |  | request parameter |
| `gen_ai.request.encoding_formats` |  | ignored | - | otel | otel-registry |  | request parameter |
| `gen_ai.request.frequency_penalty` |  | ignored | - | otel | otel-registry |  | sampling parameter |
| `gen_ai.request.max_tokens` |  | ignored | - | otel | otel-registry |  | request limit; the output count is what is billed |
| `gen_ai.request.presence_penalty` |  | ignored | - | otel | otel-registry |  | sampling parameter |
| `gen_ai.request.seed` |  | ignored | - | otel | otel-registry |  | request parameter |
| `gen_ai.request.stop_sequences` |  | ignored | - | otel | otel-registry |  | request parameter |
| `gen_ai.request.stream` |  | ignored | - | otel | otel-registry |  | request parameter |
| `gen_ai.request.temperature` |  | ignored | - | otel | otel-registry |  | sampling parameter, not a fact the product reports |
| `gen_ai.request.top_k` |  | ignored | - | otel | otel-registry |  | sampling parameter |
| `gen_ai.request.top_p` |  | ignored | - | otel | otel-registry |  | sampling parameter |
| `gen_ai.response.time_to_first_chunk` |  | read | `ttfcMs` | otel | otel-registry |  | value x1000 (seconds to milliseconds) |
| `gen_ai.security.content_filter` |  | ignored | - | otel | otel-registry |  | provider moderation detail |
| `gen_ai.token.type` |  | ignored | - | otel | otel-registry |  | metric dimension, not a span fact |
| `gen_ai.tool.definitions` |  | ignored | - | otel | otel-registry |  | tool schemas ride the span raw; the declared schema is read from the per-call key |
| `gen_ai.tool.description` |  | ignored | - | otel | otel-registry |  | free text, not a fact |
| `gen_ai.tool.type` |  | ignored | - | otel | otel-registry |  | not used by any detector yet |
| `gen_ai.usage.cache_creation.input_tokens` |  | read | `cacheWriteTokens` | otel | otel-registry |  |  |
| `gen_ai.usage.cache_read.input_tokens` |  | read | `cacheReadTokens` | otel | otel-registry |  |  |
| `gen_ai.usage.cache_write.input_tokens` |  | read | `cacheWriteTokens` | otel | otel-registry |  |  |
| `gen_ai.usage.reasoning.output_tokens` |  | read | `reasoningTokens` | otel | otel-registry |  |  |
| `gen_ai.workspace.id` |  | read | `workspaceId` | otel | otel-registry |  |  |
| `mcp.method.name` |  | read | `operation` | otel | otel-registry |  |  |
