背景
随着AI，尤其是Generative AI（后文简称GenAI）的快速发展，AI Agent系统中涌现出大量新的核心概念，如Model、Prompt、Token等。这些概念需被标准化采集、展示和消费，以便系统维护者了解调用过程、排查问题。OpenTelemetry（后文简称OTel）早在2024年初就推动Gen AI语义规范建设，希望建立统一的数据采集规范Semantic Conventions（后文简称SemConv），解决相关领域可观测数据采集标准缺失、口径不统一等问题。
SemConv定位与价值
Java、Go和Python等语言的自动插桩或SDK等可观测采集工具，在刚接触OTel的人眼里，可能是OTel社区的核心价值所在。但实际上，OTel SemConv才是OTel的灵魂，它是一套汇聚全球几十家头部可观测厂商、数百名领域专家共同设计并持续演进的可观测数据采集标准。一个统一的可观测SemConv可以统一数据语言、支撑性能等的统一治理、降低接入成本。
LoongSuite GenAI SemConv介绍
OTel虽早在2024年初就开始GenAI语义规范的讨论和设计，但更新节奏慢。2025年，阿里云、阿里控股与蚂蚁集团的可观测团队联合启动，在OTel GenAI语义基础上对内部场景中OTel尚未覆盖的内容进行语义建模，并推进内部可观测采集工具的实现与落地。2026年，成果开源至阿里巴巴LoongSuite可观测品牌下。目前，该规范已在集团内多个核心场景完成落地，形成全栈可观测能力，新增了Entry/Step Span、Skill语义、Token级推理观测等内容。
使用GenAI Utils快速实现LoongSuite GenAI SemConv
实现LoongSuite GenAI SemConv的插桩库开发者面临工程挑战，GenAI Utils作为工程化能力层，将语义规范的复杂性封装成简洁的API。其架构遵循“分层解耦、统一收口”原则，为每种GenAI操作提供对应的Invocation数据类和Context Manager方法。基于GenAI Utils，LoongSuite Python Agent已实现多个GenAI框架和模型服务的插桩。
结语：从统一字段走向统一基础设施
GenAI时代的可观测建设已演进到建立统一语义，OTel提供了标准化方向，阿里巴巴与蚂蚁集团共建GenAI可观测语义规范，把标准化方向进一步工程化、平台化、规模化。
社区
本次LoongSuite GenAI SemConv发布只是开始，未来会在更敏捷、更高效、端到端、与上游协同等方面持续努力。欢迎试用、反馈与贡献，可加钉钉群交流。
