首页/AI/提示词工程速查/OpenTelemetry GenAI 语义约定
本包目录(290 条)

OpenTelemetry GenAI 语义约定

遵循 OpenTelemetry 的生成式 AI 语义约定埋点:统一 gen_ai.* 属性命名(系统、模型、请求参数与用量),让观测平台跨服务聚合。

提示词工程速查AI更新于 2026-10-12

常用属性示例

常用属性示例
span: gen_ai.request
  gen_ai.system = <provider>
  gen_ai.request.model = <model-id>
  gen_ai.request.temperature = 0.2
  gen_ai.request.max_tokens = 1024
  gen_ai.usage.input_tokens = 812
  gen_ai.usage.output_tokens = 233
原则属性名遵循约定;自定义信息放扩展属性
注意敏感内容不入 span;用量与成本分开统计

易错点

  • 属性名自创,观测平台无法统一聚合
  • 把完整提示与输出塞进 span 属性,引入隐私与成本问题

数据来源与参考

  • OpenTelemetry Semantic Conventions for Generative AI(gen_ai.* 属性)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌