D2B for Agents
D2B 是”Spreadsheets for AI Agents”:在入口接收人类那些 messy 的 Excel,交给 Agent 的是带类型、带行 ID、带版本管理、带治理的表,并把结果以人类可读的形式(xlsx / 原有格式)返回。不只给出答案,还能一路追溯每个数字来自哪里。
| 途径 | 适合的对象 | 第一个调用 |
|---|---|---|
| MCP | Claude Code / Claude Desktop / Cursor / VS Code 等 MCP 宿主 | claude mcp add d2b --transport http https://d2b.dev/mcp/ --header "Authorization: Bearer $PAT" |
| CLI | 调用 shell 的 Agent、CI、人 | pipx install d2b-sdk && d2b login |
| SDK / API | 自建的 Agent 与应用(Python / TypeScript / HTTP) | pip install d2b-sdk → 快速开始。PyPI / npm / GitHub |
三者是同一后端的同一个面。MCP 的工具、CLI 的子命令、SDK 的方法与 REST 的端点 1 对 1 对应,从哪个开始都可以随时切换到其他入口。
- 可追溯: 派生表用 transform(SQL / Python)创建,
{{ arg }}绑定会留下 lineage。code interpreter 能给出答案,却无法追溯、无法复现。 - 可回退: snapshot / named version / op log / undo。以 Agent 会犯错为前提,可以恢复到任意时间点。
- 可管控: 列标签 × 角色的 mask / deny 在数据层强制执行。无论 SQL、export 还是 MCP,生效的都是同一套策略。
- 可交付: xlsx / csv、只替换了值单元格的原版 Excel、逐行的活公式,以及 export = branch → 再次 import = 3-way merge。
- 可放进 git: 把 transform、Sheet、Chart 和 base 表取出到仓库,通过 PR 评审后写回(用 git 管理 workbook)。
- 快速开始 — 签发 PAT,5 分钟完成第一次调用
- 核心概念 — Workbook / Source / Table / Sheet / Version、乐观锁、幂等性、治理
- 选择使用的途径: MCP / 编码 Agent / CLI / SDK / Webhook
- 如何读懂错误 — problem+json 与
suggested_fix - API 参考 — 由 OpenAPI 自动生成
面向 Agent 的索引: llms.txt / llms-full.txt / openapi.json