Claude 官方示例覆盖客服、分析与桌面操作
Anthropic 提供可供扩展的 Claude API 应用起步项目,包括接入知识库的客服 Agent、带交互可视化的金融分析助手,以及桌面操作演示。运行示例需要 Claude API 密钥。
AI 深度解读
把 Claude API 接进聊天框,只完成了 AI 应用的一小部分。anthropics/claude-quickstarts 更有价值的地方,是把浏览器操作、跨会话编程、定时任务、知识整理和错误修复分别做成参考项目,让开发者看到模型之外还需要哪些工程组件。
这份仓库说明没有提供性能评测,也没有证明某套架构最优。它值得读,是因为这些示例展示了同一个方向:让 Agent 持续工作,靠的是工具接口、状态保存、事件回传和权限边界,而不只是提示词。
先选你要解决的问题,再选 Quickstart
仓库最基础的两个入口是 Customer Support Agent 和 Financial Data Analyst:前者让客服助手访问知识库,后者把聊天分析与交互式数据可视化结合起来。它们适合回答「模型如何进入业务流程」。
再往下,项目大致分成两条路线。一条让 Claude 操作浏览器和桌面,另一条围绕 Claude Managed Agents,处理会话、消息平台、调度、知识和外部系统集成。
这些示例的成熟度并不相同。Browser Toolset Quickstart 和 Computer Toolset Quickstart 都明确表示:用于展示接口,不是生产代码。Computer Use Best Practices 则是教学性质的原生 macOS 参考实现。不能因为项目出自同一个仓库,就把它们视为同等完备的应用模板。
通用启动流程是克隆仓库、进入项目目录、安装依赖、把 Claude API key 配成环境变量,再运行应用。具体要求需要看各项目 README。原文没有给出环境变量名、依赖版本或完整启动命令,也没有交代不同 Managed Agents 示例的额外开通条件。
仓库采用 MIT License,方便开发者在示例基础上修改,但能否投入实际业务,仍要逐项检查。
浏览器和桌面自动化,应该在哪一层接入?
浏览器相关示例提供了两种不同粒度。
Browser Use Demo 使用自定义的 Playwright-backed browser tool,演示网站导航、DOM 元素检查与交互、内容提取和表单填写。对前端开发者而言,这些操作对象比较熟悉,适合研究如何把网页动作封装成模型可调用的工具。
Browser Toolset Quickstart 更靠近接口底层。它展示 browser_toolset_20260801,同时提供 Python 和 TypeScript 版本,通过 Chrome DevTools Protocol(CDP)驱动一个 Chromium 标签页。项目既有接入 tool runner 的脚本,也有不经过模型、直接执行驱动的脚本。
这个拆分很实用:可以先确认浏览器驱动能正确执行动作,再检查模型是否选对了动作。否则,页面没操作成功时,很难区分是工具故障还是模型判断出了问题。
桌面侧也有类似分层。容器化的 Computer Use Demo 展示 Claude 控制桌面的环境与工具,并支持 computer_toolset_20260801:每种 computer action 都是模型按名称调用的成员工具。
Computer Toolset Quickstart 则用 Python 和 TypeScript 展示最小 VNC 驱动,通过 RFB 协议操作一个桌面,不依赖 VNC 库,同样提供带模型和不带模型的运行路径。
原生 macOS 的 Computer Use Best Practices 关注进一步的工程细节,包括显式工具定义、正确的图像尺寸与裁剪、prompt caching、服务端上下文压缩、批量工具调用、沙箱 shell 和轨迹记录。原文明确提醒在 VM 中运行。
工具能执行动作,只是起点;动作能否单独验证、执行过程能否回看,决定了后续排错的难度。
不过,所谓更可靠、更省成本,在这份说明里只是项目目标,没有成功率或费用对照数据。
持续运行的 Agent,怎样保存进度并回到业务里?
Autonomous Coding Agent 使用 Claude Agent SDK,采用 initializer 与 coding agent 的双 Agent 模式,靠 git 和功能清单保存进度,跨多个会话逐步构建应用。
它最值得借鉴的不是 Agent 数量,而是把进度写到对话之外。下一次会话可以读取已完成的代码和待办功能,不必完全依赖上一轮聊天记录。原文没有说明验收规则,也没有给出它相对单 Agent 的效果比较。
Managed Agents 系列进一步展示了 Agent 与业务系统的连接方式。
Chat SDK 示例为每段对话保留持久会话,研究助手通过 web search 获取资料,逐 token 输出简报,同时展示工具调用;替换 Vercel Chat SDK adapter,可以连接 Slack、Teams、Discord、Telegram 或 WhatsApp。CopilotKit 示例则把托管会话桥接到 AG-UI,用事件增量输出回复,并把工具调用呈现为可交互的生成式 UI 组件。
Slack 和 Linear 示例展示了异步回复如何找到原来的位置。Slack 的 @mention 创建会话,把频道与线程写进 metadata;收到 session.status_idled webhook 后,再取出这些信息回复原线程。Linear 使用 AgentSessionEvent 建立会话,保存 Linear 会话及组织 ID,并通过 Linear OAuth 的 actor=app 安装。Slack 示例明确不需要数据库或长连接。
这里的「无状态」指 webhook 桥接服务,会话和路由信息仍然有地方保存。
Road Trip Planner 则直接用 Next.js 连接 Managed Agents session,不使用聊天框架或数据库,一屏展示四项能力:通过 event_deltas 流式输出、用 injection_location 指定 vault 凭据注入位置、用 agent_with_overrides 覆盖当前会话模型,以及让协调 Agent 把草稿交给会话线程里的 reviewer agent。
另外几个项目更接近长期运行的业务任务:
- Daily Brief 在每个工作日读取 Slack 和 GitHub pull requests,再向 Slack 发布简报。部署通过
ant apply应用文件定义,包含 agent、environment、两个 memory stores、vault 和 cron deployment。它分开保存只读偏好与可写状态,并用来源书签和去重台账管理进度;读取失败会明确报告,避免被当成当天没有动态。 - Knowledge Wiki 先通过一次动态工作流提取、消歧和整合文档,形成带版本的知识库,再回答重复提问,每条事实附来源。示例素材来自 SEC EDGAR 的真实 M&A 数据室。原文称单次提问成本低于直接检索原始文档,但没有给出测量方法和数字。
- Sentry 示例通过 cron 启动会话,无需宿主进程,使用 Sentry Agent Plugin 引导配置,并把可刷新的 MCP OAuth 凭据存进 vault。Sentry Autofix 则由 webhook 为每个 issue 建立会话,读取堆栈与 Seer 根因分析,在挂载的 GitHub 仓库中先用失败测试复现,再推送分支,由宿主通过自定义工具创建 PR,交给人审核。
Sentry Autofix 还明确设置了隔离条件:凭据留在沙箱外的 vault,沙箱无法访问开放互联网,每个会话有硬性花费上限。
如果要从现有 AI 客户端操作这些托管 Agent,TypeScript MCP Server 示例把 Sessions API 暴露为九个工具,支持 stdio 和 Streamable HTTP。wait_for_idle 把会话事件流包装成一次请求与响应,agent allowlist 则限制 bearer-token 持有者能访问的 Agent。
我的判断
这份仓库最有价值的是工程模式的覆盖面,尤其是失败状态处理。Daily Brief 把「来源不可读」单独报告,Sentry Autofix 把修复落到失败测试和待审核 PR,这些设计比单纯展示一次成功对话更接近真实需求。
但它仍是一份项目入口说明。双 Agent 是否更有效、知识库是否更省钱、桌面工具怎样提升成功率,都缺少可核对的对照数据。可以学习设计,不能直接接受效果结论。
选型也要看复杂度。已有 Playwright 脚本能稳定完成的固定操作,没有必要仅为引入 Agent 而重写。只有步骤需要根据页面内容动态判断时,才值得评估模型参与的收益。Managed Agents 能承接示例中的会话与调度模式,但接入业务权限、数据生命周期和故障恢复要付出多少成本,原文没有说清。
能拿来做什么
- 如果你在做网页操作助手,先读 Browser Use Demo,再用 Browser Toolset Quickstart 的无模型脚本验证驱动,把工具执行问题与模型决策问题分开排查。
- 如果你在做 Next.js AI 界面,可以对照 Road Trip Planner 与 CopilotKit 示例,分别评估直接消费事件流、通过 AG-UI 渲染工具交互两种接入方式。
- 如果你想让编程 Agent 跨会话工作,可以先借鉴 git 加功能清单的进度保存方式,再判断是否需要 initializer 与 coding agent 的分工。
- 如果你在做日报或自动修复任务,可以优先参考来源书签、去重台账、明确报告读取失败、失败测试和人工审核 PR 这些具体机制。