LoongSuite GenAI SemConv：统一GenAI可观测语义规范，助力应用可看见、分析与治理！

背景随着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 UtilsLoongSuite Python Agent已实现多个GenAI框架和模型服务的插桩。结语从统一字段走向统一基础设施GenAI时代的可观测建设已演进到建立统一语义OTel提供了标准化方向阿里巴巴与蚂蚁集团共建GenAI可观测语义规范把标准化方向进一步工程化、平台化、规模化。社区本次LoongSuite GenAI SemConv发布只是开始未来会在更敏捷、更高效、端到端、与上游协同等方面持续努力。欢迎试用、反馈与贡献可加钉钉群交流。