生产级 AI 智能体ADK-Rust v2 超级代理

AI 代理创建专业 Excel 文件

zSpreadsheet 通过对话规划、构建、样式设计、计算、预览并版本控制真实的 Excel 工作簿。结果在整个工作过程中保持可见和可编辑。

真实产品捕获聊天 · 工具 · 实时工作簿
zSpreadsheet 产品展示了一个代理对话及旁边生成的季度销售工作簿

为什么它是超级代理

它生成、验证并返回完整的 Excel 工作簿。

基础电子表格助手可能回答公式问题或返回一块 CSV 数据。 zSpreadsheet 负责最终完成的工作簿: 它的结构、公式、数据、格式、计算、文件创建以及审阅体验。

代理仍在可见边界内工作。它只能调用连接到运行时的电子表格工具,保存到用户工作区,并在界面中显示进度。用户可以检查公式栏,直接编辑工作簿,下载文件或继续对话。

这使产品成为有用的 ADK-Rust 案例研究。多个代理、MCP 能力服务器、RAG、会话、流事件和成果存储围绕一个熟悉的业务结果组装。 一个可以打开并使用的工作簿.

真实 Excel 文件

结果是可下载的 .xlsx 工作簿,包含公式、格式、图表、表格、验证和工作簿元数据——而非粘贴到聊天中的表格。

你可以监控的工作

工具调用流入对话,同时渐进保存刷新工作簿预览。用户可以看到成果成型。

可编辑的工作簿

预览包含公式栏和直接工作簿控件。用户可以自行更改单元格或请求代理再次处理。

记忆工作区

上传、活动工作簿上下文、代理会话和不可变工作簿版本保持附着于用户工作区。

跟踪一个工作簿

从提示到可用的 .xlsx 文件。

每个阶段都有明确职责。该分离让开发者可以更改规划模型、工作簿工具、样式策略或存储层,而无需重新设计整个产品。

  1. 01

    描述业务成果

    请求预算、预测、定价模型、跟踪器、运营报告或对现有工作簿的更改。上传文件可提供源数据。

  2. 02

    规划工作簿

    规划者将请求转化为工作表、精确单元格位置、公式、格式规则、图表范围和保存目标。

  3. 03

    通过 MCP 构建

    写入器通过 Excel MCP 服务器批量处理值和公式。独立操作可同时运行,减少模型和工具往返。

  4. 04

    样式与计算

    样式代理应用主题、数字格式、边框、表格、图表和布局。工作簿引擎在保存前重新计算公式。

  5. 05

    检查、编辑并保存工件

    浏览器渲染已保存的工作簿,计算公式,支持直接编辑,并记录新版本,同时不隐藏底层 .xlsx 文件。

架构

代理工作流如何连接到工作簿引擎。

浏览器既是对话界面也是工作簿编辑器。ADK-Rust 协调代理和状态。MCP 为这些代理提供受控连接到创建最终成果的 Excel 引擎。

zSpreadsheet ADK-Rust v2 架构浏览器请求进入 Axum 服务和 ADK-Rust Runner,经过规划器、编写器和样式器代理,调用 74 工具 Excel MCP 服务器,创建 xlsx 工件,并返回预览,同时 PostgreSQL 和 RAG 提供状态和上下文。一个请求变成可见、可编辑、版本化的工作簿人员聊天 + 工作簿编辑器Axum 服务HTTP + 类型化 SSEADK-Rust Runner上下文 + 会话规划器单元格 + 公式撰写者数据 + 公式样式器格式 + 图表ADK MCP 客户端rmcp 2.2 + 重试Excel MCP 服务器74 个工具zavora-xlsx原生工作簿引擎.xlsx artifact保存 + 计算PostgreSQL会话 + 版本工作区 RAG上传文件上下文虚线路径将工作区上下文、持久状态和保存的工件附加到同一次 ADK-Rust 调用。
代理执行上下文与事件工作簿操作与工件持久状态

ADK-Rust v2 的贡献

在真实产品中使用的框架功能。

这些是当前实现的源代码验证部分。zSpreadsheet 目前不支持 A2A 或 AWP。

01

顺序多代理工作

规划器、撰写器和样式器职责分明,同时共享同一请求和会话。

02

支持提供者的工具模式

ADK-Rust v2 在请求时适配 Gemini、OpenAI、Anthropic 或 DeepSeek 的 74 MCP 工具模式。

03

当前 Rust MCP SDK

应用使用 ADK-Rust 的 rmcp 2.2 重新导出,保持客户端和框架在同一协议版本。

04

可恢复的 MCP 连接

连接工厂和有界重试策略可在传输故障可恢复时替代子进程连接。

05

并行工具批处理

写入器和样式器可以同时执行独立的工作簿操作,而依赖操作保持有序。

06

持久对话状态

PostgreSQL 存储会话和事件;上下文压缩保持较长的电子表格对话可用。

07

基于工作区的请求

ADK-Rust RAG 在请求到达代理工作流前搜索上传的工作簿和 CSV 内容。

08

类型化进度事件

代理文本、思考、工具调用、工具结果和完成事件构成产品 UI 中显示的 SSE 流。

产品背后的 Rust

使用 ADK-Rust 的可组合工作流程。

根代理是顺序工作流,Runner 附加会话和压缩。Excel 工具通过可重连 MCP 客户端到达,而非硬编码进代理。

阅读完整实现 ↗
agent.rs · workflow and runner
let pipeline = SequentialAgent::new(
    "spreadsheet_builder",
    vec![
        Arc::new(planner),
        Arc::new(writer),
        Arc::new(styler),
    ],
);

let runner = Runner::builder()
    .app_name("excel_agent")
    .agent(Arc::new(pipeline))
    .session_service(postgres_sessions)
    .compaction_config(compaction)
    .build()?;
mcp.rs · recoverable tool connection
let client = ().serve(
    TokioChildProcess::new(Command::new(excel_mcp_server))?
).await?;

let tools = McpToolset::new(client)
    .with_connection_factory(factory)
    .with_refresh_config(
        RefreshConfig::default().with_max_attempts(3)
    );

当前产品边界

现在可用的功能及剩余事项。

今日可用

  • 创建和修改真实的 .xlsx 文件
  • 74 个 Excel MCP 操作
  • 实时工作簿和公式预览
  • 直接的单元格和工作簿控件
  • 工作区上传和 RAG 搜索
  • PostgreSQL 会话和工作簿版本

仍在完成中

  • 每个数据透视配置的完整视觉渲染
  • 每个高级图表功能的直接 UI 合同
  • 团队协作与共享权限
zSpreadsheet 工作簿编辑器显示公式、计算总计和生成的 Excel 文件

尝试结果

请求你实际需要的工作簿。

从业务请求开始,观察代理通过 MCP 构建,检查公式和格式,然后保存生成的 Excel 文件。