GenAI Utils 是 LoongSuite SemConv 的工程化能力层,负责在采集链路中把语义规范落地:
- 插桩层只做数据提取:各框架插桩库通过 Hook/Monkey-Patch 拦截框架调用,把数据填充到对应的 Invocation 数据对象中;
- GenAI Utils 统一收口遥测输出:所有 Span 创建、属性挂载、Metrics 记录、Event 发送、Context 管理都由 ExtendedTelemetryHandler 内部完成;
- 规范升级只改一处:当语义规范新增字段或调整结构时,只需修改 GenAI Utils,所有下游插桩库自动生效。
支持的 Invocation 类型包括 LLM、InvokeAgent、CreateAgent、ExecuteTool、Embedding、Retrieve、Rerank、Memory 等,覆盖 GenAI 全生命周期操作。目前 Python 和 Node.js 版本已开源,Go 已完成,Java 即将发布。




