Harness 与 Agent 工程 · 日志、监控与故障定位 · 2025-10-09

零代码改造 + 全链路追踪!Spring AI 最新可观测性详细解读

Spring AI最新可观测性方案详解,零代码改造实现全链路追踪,助力AI应用快速落地生产环境。

核心内容:

  1. AI应用从Demo到生产面临的核心挑战与关键门槛
  2. Spring AI提供的三种可观测性实现路径对比
  3. 全链路追踪方案的技术实现与落地价值

前言:AI Agent 从 Demo

到生产阶段的挑战

Cloud Native

自 2022 年底 GPT-3.5 引爆大模型革命以来,AI 应用经历了从技术探索到产业落地的快速演进。开源模型迭代与低代码平台的兴起,推动了 AI Agent 开发效率的显著提升。然而,行业普遍面临一个核心矛盾:绝大多数 AI 应用仍停留在 demo 阶段,很难在企业级生产环境中大规模落地。最终能形成一个线上服务产品的更是少之又少。

在总结了内部和外部的 Agent 落地经验之后,我们发现在 demo 和生产阶段,大家对 AI 应用的要求会有一个非线性的提高。对于一个 demo 应用来说,我们可能只需要基本功能达到 80 分,把这个应用搓出来,最快地看到效果就够了。但要把这个应用部署到生产,则要额外考虑的事情就非常多了:开发效率、业务能力、部署便捷性、问题诊断能力、成本控制、生成质量、安全合规等方面,都是 AI 应用落地前面的一道道“门槛”。

好在现在有一些相对成熟的方案来跨过这些“门槛”,以较低的成本保证 AI 应用的生产可用。按照场景可以基本分为两大类:

AI Coding 与多语言 AI 框架的强势发展,使得目前越来越多的内部和外部开发团队选择使用 Python 以外的语言搭建 AI 应用。本文将围绕 Java + Spring AI (Alibaba) 的 AI 应用为例,介绍框架原生及无侵入探针的集成方式的最佳实践。


Java 开发者的 AI Agent 框架:

Spring AI Alibaba

Cloud Native

Spring AI 的局限与突破Spring AI 作为 Spring 官方推出的 AI 开发框架,借鉴了 Python 语言中炙手可热(至少曾是)的 Langchain 与 LlamaIndex 的实现,通过封装大模型调用、向量数据库、工具调用等基础能力,帮助开发者用几行代码即可构建智能体原型。例如,以下代码可快速实现一个带工具调用的对话 Agent:

public Flux<String> streamChat(String chatId, String userMessageContent) { return this.chatClient.prompt() .system("你是一个提供预定服务的chatbot") .user(userMessageContent) .toolNames("getBookingDetails") .stream() .content();}

然而,当业务场景涉及多 Agent 协同、复杂工作流时,Spring AI 的单体化设计显现出明显短板:

Spring AI Alibaba 的增强能力作为对 Spring AI 的企业级增强方案,Spring AI Alibaba 通过三大核心特性解决了上述问题:

  1. Graph 框架:基于有向无环图实现多 Agent 协同编排,支持条件分支、并行执行等复杂逻辑;
  2. DSL 转换器:兼容 Dify 等低代码平台的 DSL 配置,实现“低代码设计-高代码部署”的无缝衔接;
  3. 阿里云生态集成:内置 RAG、百炼平台对接、可观测性等企业级能力,加速智能体工业化落地。

以多 Agent 协同场景为例,开发者可通过 Spring AI Alibaba 多 Agent 框架定义如下工作流,并快速完成 Agent 编排:

// 定义 Agent 1ReactAgent writerAgent = ReactAgent.builder() .name("writer_agent") .model(chatModel) .description("可以写文章。") .instruction("你是一个知名的作家,擅长写作和创作。请根据用户的提问进行回答。") .outputKey("article") .build();// 定义 Agent 2ReactAgent reviewerAgent = ReactAgent.builder() .name("reviewer_agent") .model(chatModel) .description("可以对文章进行评论和修改。") .instruction("你是一个知名的评论家,擅长对文章进行评论和修改。对于散文类文章,请确保文章中必须包含对于西湖风景的描述。") .outputKey("reviewed_article") .build();// 定义顺序的 AgentFlowSequentialAgent blogAgent = SequentialAgent.builder() .name("blog_agent") .state(stateFactory) .description("可以根据用户给定的主题写一篇文章,然后将文章交给评论员进行评论,必要时做出修改。") .inputKey("input") .outputKey("topic") .subAgents(List.of(writerAgent,reviewerAgent)) .build();Optional<OverAllState> result = blogAgent.invoke(Map.of("input", "帮我写-个I00字左右的散文");

受限于篇幅,本篇不对框架本身过多介绍,更多 Spring AI Alibaba 框架的最佳实践请移步:Spring AI Alibaba 官方网站[11]。

可观测性集成:框架原生方式

Cloud Native

基本原理

Spring AI Alibaba 的可观测性体系基本基于 OpenTelemetry(OTel)标准构建,通过分层架构实现数据采集、处理与上报的全链路覆盖:

  1. 埋点层:框架内部通过 Micrometer(Spring 官方推荐的可观测中间件)对关键调用(如模型推理、工具调用、外部调用)自动埋点;
  2. 数据导出层:Micrometer 在运行时提供可插拔的 Tracer 实现,支持将埋点层产生的数据使用 OpenTelemetry SDK 导出为满足 OTLP 协议的格式;
  3. 存储层:兼容任何支持 OTLP 协议格式的可观测存储,如…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/LargeLanguageModel/2025100962351.html