GenAI conventions2026-05-05.2

5 May 2026since 2026-05-05

0 breaking14 notable120 editorial

From the upstream commit

Convert GenAI semantic conventions to Weaver schema v2

Read the commit

Notable14

removedsignalspan.anthropic.inference.clientRemoved from the registry (was development).
removedsignalspan.aws.bedrock.clientRemoved from the registry (was development).
removedsignalspan.azure.ai.inference.clientRemoved from the registry (was development).
removedsignalspan.gen_ai.create_agent.clientRemoved from the registry (was development).
removedsignalspan.gen_ai.embeddings.clientRemoved from the registry (was development).
removedsignalspan.gen_ai.execute_tool.internalRemoved from the registry (was development).
removedsignalspan.gen_ai.inference.clientRemoved from the registry (was development).
removedsignalspan.gen_ai.invoke_agent.clientRemoved from the registry (was development).
removedsignalspan.gen_ai.invoke_agent.internalRemoved from the registry (was development).
removedsignalspan.gen_ai.invoke_workflow.internalRemoved from the registry (was development).
removedsignalspan.gen_ai.retrieval.clientRemoved from the registry (was development).
removedsignalspan.mcp.clientRemoved from the registry (was development).
removedsignalspan.mcp.serverRemoved from the registry (was development).
removedsignalspan.openai.inference.clientRemoved from the registry (was development).

Editorial120

usageattributegen_ai.agent.descriptionNow referenced by gen_ai.create_agent.client, gen_ai.invoke_agent.client and 1 other (conditionally required).
usageattributegen_ai.agent.descriptionNo longer referenced by span.gen_ai.create_agent.client, span.gen_ai.invoke_agent.client and 1 other.
usageattributegen_ai.agent.idNow referenced by gen_ai.create_agent.client, gen_ai.invoke_agent.client and 1 other (conditionally required).
usageattributegen_ai.agent.idNo longer referenced by span.gen_ai.create_agent.client, span.gen_ai.invoke_agent.client and 1 other.
usageattributegen_ai.agent.nameNow referenced by gen_ai.create_agent.client, gen_ai.invoke_agent.client and 1 other (conditionally required).
usageattributegen_ai.agent.nameNo longer referenced by span.gen_ai.create_agent.client, span.gen_ai.invoke_agent.client and 1 other.
usageattributegen_ai.agent.versionNow referenced by gen_ai.create_agent.client, gen_ai.invoke_agent.client and 1 other (conditionally required).
usageattributegen_ai.agent.versionNo longer referenced by span.gen_ai.create_agent.client, span.gen_ai.invoke_agent.client and 1 other.
usageattributegen_ai.conversation.idNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (conditionally required).
usageattributegen_ai.conversation.idNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.data_source.idNow referenced by gen_ai.invoke_agent.client, gen_ai.invoke_agent.internal and 1 other (conditionally required).
usageattributegen_ai.data_source.idNo longer referenced by span.gen_ai.invoke_agent.client, span.gen_ai.invoke_agent.internal and 1 other.
usageattributegen_ai.embeddings.dimension.countNow referenced by gen_ai.embeddings.client (recommended).
usageattributegen_ai.embeddings.dimension.countNo longer referenced by span.gen_ai.embeddings.client.
usageattributegen_ai.input.messagesNow referenced by anthropic.inference.client, azure.ai.inference.client and 5 others (opt in).
usageattributegen_ai.input.messagesNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 6 others.
usageattributegen_ai.operation.nameNow referenced by anthropic.inference.client, aws.bedrock.client and 12 others (required).
usageattributegen_ai.operation.nameNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 12 others.
usageattributegen_ai.output.messagesNow referenced by anthropic.inference.client, azure.ai.inference.client and 5 others (opt in).
usageattributegen_ai.output.messagesNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 6 others.
usageattributegen_ai.output.typeNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (conditionally required).
usageattributegen_ai.output.typeNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.prompt.nameNow referenced by mcp.client and mcp.server (conditionally required).
usageattributegen_ai.prompt.nameNo longer referenced by span.mcp.client and span.mcp.server.
usageattributegen_ai.provider.nameNow referenced by aws.bedrock.client, gen_ai.create_agent.client and 5 others (recommended).
usageattributegen_ai.provider.nameNo longer referenced by span.aws.bedrock.client, span.gen_ai.create_agent.client and 5 others.
usageattributegen_ai.request.choice.countNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (conditionally required).
usageattributegen_ai.request.choice.countNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.request.encoding_formatsNow referenced by gen_ai.embeddings.client (recommended).
usageattributegen_ai.request.encoding_formatsNo longer referenced by span.gen_ai.embeddings.client.
usageattributegen_ai.request.frequency_penaltyNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.request.frequency_penaltyNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.request.max_tokensNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.request.max_tokensNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.request.modelNow referenced by anthropic.inference.client, aws.bedrock.client and 8 others (conditionally required).
usageattributegen_ai.request.modelNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 8 others.
usageattributegen_ai.request.presence_penaltyNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.request.presence_penaltyNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.request.seedNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (conditionally required).
usageattributegen_ai.request.seedNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.request.stop_sequencesNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.request.stop_sequencesNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.request.streamNow referenced by anthropic.inference.client, azure.ai.inference.client and 2 others (conditionally required).
usageattributegen_ai.request.streamNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 3 others.
usageattributegen_ai.request.temperatureNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.request.temperatureNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.request.top_kNow referenced by gen_ai.inference.client and gen_ai.retrieval.client (recommended).
usageattributegen_ai.request.top_kNo longer referenced by span.aws.bedrock.client, span.gen_ai.inference.client and 1 other.
usageattributegen_ai.request.top_pNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.request.top_pNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.response.finish_reasonsNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.response.finish_reasonsNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.response.idNow referenced by anthropic.inference.client, azure.ai.inference.client and 2 others (recommended).
usageattributegen_ai.response.idNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 3 others.
usageattributegen_ai.response.modelNow referenced by anthropic.inference.client, azure.ai.inference.client and 3 others (recommended).
usageattributegen_ai.response.modelNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 4 others.
usageattributegen_ai.response.time_to_first_chunkNow referenced by anthropic.inference.client, azure.ai.inference.client and 2 others (recommended).
usageattributegen_ai.response.time_to_first_chunkNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 3 others.
usageattributegen_ai.retrieval.documentsNow referenced by gen_ai.retrieval.client (opt in).
usageattributegen_ai.retrieval.documentsNo longer referenced by span.gen_ai.retrieval.client.
usageattributegen_ai.retrieval.query.textNow referenced by gen_ai.retrieval.client (opt in).
usageattributegen_ai.retrieval.query.textNo longer referenced by span.gen_ai.retrieval.client.
usageattributegen_ai.system_instructionsNow referenced by anthropic.inference.client, azure.ai.inference.client and 5 others (opt in).
usageattributegen_ai.system_instructionsNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 6 others.
usageattributegen_ai.tool.call.argumentsNow referenced by gen_ai.execute_tool.internal and mcp.client (opt in).
usageattributegen_ai.tool.call.argumentsNo longer referenced by span.gen_ai.execute_tool.internal and span.mcp.client.
usageattributegen_ai.tool.call.idNow referenced by gen_ai.execute_tool.internal (recommended).
usageattributegen_ai.tool.call.idNo longer referenced by span.gen_ai.execute_tool.internal.
usageattributegen_ai.tool.call.resultNow referenced by gen_ai.execute_tool.internal and mcp.client (opt in).
usageattributegen_ai.tool.call.resultNo longer referenced by span.gen_ai.execute_tool.internal and span.mcp.client.
usageattributegen_ai.tool.definitionsNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (opt in).
usageattributegen_ai.tool.definitionsNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.tool.descriptionNow referenced by gen_ai.execute_tool.internal (recommended).
usageattributegen_ai.tool.descriptionNo longer referenced by span.gen_ai.execute_tool.internal.
usageattributegen_ai.tool.nameNow referenced by gen_ai.execute_tool.internal, mcp.client and 1 other (required).
usageattributegen_ai.tool.nameNo longer referenced by span.gen_ai.execute_tool.internal, span.mcp.client and 1 other.
usageattributegen_ai.tool.typeNow referenced by gen_ai.execute_tool.internal (recommended).
usageattributegen_ai.tool.typeNo longer referenced by span.gen_ai.execute_tool.internal.
usageattributegen_ai.usage.cache_creation.input_tokensNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.usage.cache_creation.input_tokensNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.usage.cache_read.input_tokensNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.usage.cache_read.input_tokensNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.usage.input_tokensNow referenced by anthropic.inference.client, azure.ai.inference.client and 5 others (recommended).
usageattributegen_ai.usage.input_tokensNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 6 others.
usageattributegen_ai.usage.output_tokensNow referenced by anthropic.inference.client, azure.ai.inference.client and 4 others (recommended).
usageattributegen_ai.usage.output_tokensNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 5 others.
usageattributegen_ai.usage.reasoning.output_tokensNow referenced by anthropic.inference.client, azure.ai.inference.client and 2 others (recommended).
usageattributegen_ai.usage.reasoning.output_tokensNo longer referenced by span.anthropic.inference.client, span.aws.bedrock.client and 3 others.
usageattributegen_ai.workflow.nameNow referenced by gen_ai.invoke_workflow.internal (conditionally required).
usageattributegen_ai.workflow.nameNo longer referenced by span.gen_ai.invoke_workflow.internal.
usageattributemcp.method.nameNow referenced by mcp.client and mcp.server (required).
usageattributemcp.method.nameNo longer referenced by span.mcp.client and span.mcp.server.
usageattributemcp.protocol.versionNow referenced by mcp.client and mcp.server (recommended).
usageattributemcp.protocol.versionNo longer referenced by span.mcp.client and span.mcp.server.
usageattributemcp.resource.uriNow referenced by mcp.client and mcp.server (conditionally required).
usageattributemcp.resource.uriNo longer referenced by span.mcp.client and span.mcp.server.
usageattributemcp.session.idNow referenced by mcp.client and mcp.server (recommended).
usageattributemcp.session.idNo longer referenced by span.mcp.client and span.mcp.server.
usageattributeopenai.api.typeNow referenced by openai.inference.client (recommended).
usageattributeopenai.api.typeNo longer referenced by span.openai.inference.client.
usageattributeopenai.request.service_tierNow referenced by openai.inference.client (conditionally required).
usageattributeopenai.request.service_tierNo longer referenced by span.openai.inference.client.
usageattributeopenai.response.service_tierNow referenced by openai.inference.client (conditionally required).
usageattributeopenai.response.service_tierNo longer referenced by span.openai.inference.client.
usageattributeopenai.response.system_fingerprintNow referenced by openai.inference.client (recommended).
usageattributeopenai.response.system_fingerprintNo longer referenced by span.openai.inference.client.
addedsignalanthropic.inference.clientSemantic Conventions for Anthropic client spans extend and override the semantic conventions for Gen AI Spans.
addedsignalaws.bedrock.clientDescribes an AWS Bedrock operation span.
addedsignalazure.ai.inference.clientSemantic Conventions for Azure AI Inference client spans extend and override the semantic con...
addedsignalgen_ai.create_agent.clientDescribes GenAI agent creation and is usually applicable when working with remote agent services.
addedsignalgen_ai.embeddings.clientDescribes GenAI embeddings span - a request to a Generative AI model or service that generates an embeddings based on the input. The gen_ai.operation.name SH...
addedsignalgen_ai.execute_tool.internalDescribes tool execution span.
addedsignalgen_ai.inference.clientThis span represents a client call to Generative AI model or service that generates a response or requests a tool call based on the input prompt.
addedsignalgen_ai.invoke_agent.clientDescribes GenAI agent invocation over a remote service.
addedsignalgen_ai.invoke_agent.internalDescribes GenAI agent invocation within the same process.
addedsignalgen_ai.invoke_workflow.internalRepresents an operation that executes a coordinated process composed of multiple agents or other operations involving generative AI.
addedsignalgen_ai.retrieval.clientDescribes GenAI retrieval span - a request to a Generative AI service or framework that retrieves relevant information or context from a vector database or sea...
addedsignalmcp.clientThis span describes the MCP call from the client side.
addedsignalmcp.serverThis span describes the processing of the MCP request or notification initiated by the peer.
addedsignalopenai.inference.clientSemantic Conventions for OpenAI client spans extend and override the semantic conventions for Gen AI Spans.