生成式 AI 系统的语义约定

状态: 开发中

警告

当前正在使用 此文档 v1.36.0(或之前版本)的 GenAI 应用程序正在使用此文档。

  • 默认情况下,不应更改他们发出的 GenAI约定的版本。约定包括但不限于属性、指标、跨度和事件名称、跨度种类和度量单位。
  • 应引入一个名为 OTEL_SEMCONV_STABILITY_OPT_IN 的环境变量,该变量包含一个逗号分隔的类别特定值列表。该列表包括:
    • gen_ai_latest_experimental - 发出最新的实验性 GenAI 约定版本(由仪器支持)并停止发出旧版本(v1.36.0 或更早版本)。
    • 默认行为是继续发出当前指示所使用的任何版本的 GenAI 约定(1.36.0 或更早版本)。

此过渡计划将在 GenAI 约定被标记为稳定版本之前进行更新,以包含稳定版本。

为以下信号定义了生成式 AI 操作的语义约定

  • Events:生成式 AI 输入和输出的语义约定 - events
  • Metrics:生成式 AI 操作的语义约定 - metrics
  • Model spans:生成式 AI 模型操作的语义约定 - spans
  • Agent spans:生成式 AI 代理操作的语义约定 - spans

为以下 GenAI 系统定义了特定技术的语义约定