gistfile1.md

Semantic Conventions

Table of Contents

1. Resource
2. Agent Span Kind
3. LLM Span Kind
4. Tool Span Kind
5. Chain Span Kind
6. Glossary

---

Resource

Attribute	Type	Req.	Purpose	Allowed Values
TBD

Example trace fragment

{
  "traceId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "spanId":  "11111111111111",
  "name":    "execute_tool gpt-4o",
  "kind":    "SPAN_KIND_CLIENT",
  "attributes": [
    { "key": "gen_ai.openai.request.service_tier",
      "value": { "stringValue": "auto" } },

    { "key": "gen_ai.openai.response.service_tier",
      "value": { "stringValue": "scale" } },

    { "key": "gen_ai.openai.response.system_fingerprint",
      "value": { "stringValue": "fp-abc" } }
  ]
}

---

Agent Span Kind

Attributes

Attribute	Type	Req.	Purpose	Allowed Values
TBD

Example trace fragment

{
  "traceId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "spanId":  "11111111111111",
  "name":    "execute_tool gpt-4o",
  "kind":    "SPAN_KIND_CLIENT",
  "attributes": [
    { "key": "gen_ai.openai.request.service_tier",
      "value": { "stringValue": "auto" } },

    { "key": "gen_ai.openai.response.service_tier",
      "value": { "stringValue": "scale" } },

    { "key": "gen_ai.openai.response.system_fingerprint",
      "value": { "stringValue": "fp-abc" } }
  ]
}

---

LLM Span Kind

Attributes

Attribute	Type	Req.	Purpose	Allowed Values
TBD

Example trace fragment

{
  "traceId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "spanId":  "11111111111111",
  "name":    "execute_tool gpt-4o",
  "kind":    "SPAN_KIND_CLIENT",
  "attributes": [
    { "key": "gen_ai.openai.request.service_tier",
      "value": { "stringValue": "auto" } },

    { "key": "gen_ai.openai.response.service_tier",
      "value": { "stringValue": "scale" } },

    { "key": "gen_ai.openai.response.system_fingerprint",
      "value": { "stringValue": "fp-abc" } }
  ]
}

---

Tool Span Kind

Attributes

Attribute	Type	Req.	Purpose	Allowed Values
TBD

Example trace fragment

{
  "traceId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "spanId":  "11111111111111",
  "name":    "execute_tool gpt-4o",
  "kind":    "SPAN_KIND_CLIENT",
  "attributes": [
    { "key": "gen_ai.openai.request.service_tier",
      "value": { "stringValue": "auto" } },

    { "key": "gen_ai.openai.response.service_tier",
      "value": { "stringValue": "scale" } },

    { "key": "gen_ai.openai.response.system_fingerprint",
      "value": { "stringValue": "fp-abc" } }
  ]
}

---

Chain Span Kind

Attributes

Attribute	Type	Req.	Purpose	Allowed Values
TBD

Example trace fragment

{
  "traceId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "spanId":  "11111111111111",
  "name":    "execute_tool gpt-4o",
  "kind":    "SPAN_KIND_CLIENT",
  "attributes": [
    { "key": "gen_ai.openai.request.service_tier",
      "value": { "stringValue": "auto" } },

    { "key": "gen_ai.openai.response.service_tier",
      "value": { "stringValue": "scale" } },

    { "key": "gen_ai.openai.response.system_fingerprint",
      "value": { "stringValue": "fp-abc" } }
  ]
}

---

Glossary

Term	Definition
TBD