跳到主内容
@wquguru
精选88claude.dev 博客(sitemap)技巧与观点多源精选 ×2

Anthropic发布Agent自动化参考实现与踩坑指南

Building effective agent automations

原文
发到 X
推荐理由

提供了一手工程实践与完整配置清单,直接解决Agent自动化中的常见故障模式,值得收藏参考。

带常见故障模式的参考实现逐步指南 - 作者:Lance Martin 和 CJ Avilla(技术员工成员)- 发布日期:2026-10-08 - URL: 随着 AI 加速我们的工作,跟上节奏变得越来越难。在 Anthropic,简单的智能体自动化经常被用来提供帮助。它们通常按计划运行,在后台收集上下文,并主动告诉我们所需的信息。但构建有效的智能体自动化很困难:它们可能会在无人察觉的情况下失去对某个数据源的访问权限,或者未能遵循我们的偏好。使用 Claude Managed Agents(测试版),我们构建了一个参考实现,该实现按计划读取自定义数据源(例如 Slack 和 GitHub 仓库),跟踪自上次运行以来发生的变化,并发布您需要知道的内容(例如发送到 Slack)。在本文中,我们将逐步介绍每个步骤,分享一个参考实现,并提供一个可在 Claude Code 中运行的命令,为您配置智能体。## 获取代码 参考实现位于此处。如需交互式逐步指南,请在 Claude Code 中运行以下命令。`claude-api` 技能可帮助按照本文中的指导设置智能体: ``` /claude-api managed-agents-onboard https://claude.dev/blog/building-effective-agent-automations/ ``` 对于此参考实现,您需要一个 Slack 应用(从清单创建)和一个 GitHub 令牌。提供的文件(如下所示)是 Claude API 资源的配置,包括智能体、其环境、记忆存储库、保险库和部署。 ``` daily-brief/ ├── agent.md 模型、工具、说明 ├── deployment.md 计划、时区、预算、输入消息 ├── environment.yaml 网络白名单 ├── memory_store_preferences.yaml 用户偏好 ├── memory_store_state.yaml 智能体的书签、分类账、笔记和运行记录 ├── vault.yaml 保存凭据的保险库 ├── claude-lock.json 资源 ID,由 ant apply 写入 └── slack/manifest.yaml 一个机器人应用 ``` `ant apply` 是 ant CLI 中的一个命令,它读取这些文件,在您的 Claude API 工作区(平台在其中存储和运行它们)中创建资源,并将 ID 记录在 `claude-lock.json` 中。我们将在下面的部分中使用此命令。配置完成后,自动化任务将在 Anthropic 的基础设施上按计划运行,因此您的机器上无需保持任何进程运行。## 概述我们将构建的代理包含六个组件,按以下顺序介绍:- 数据源 - 要读取的位置命名列表 - 目标位置 - 代理可写入的一个位置 - 代理 - agent.md 中的模型、工具和运行步骤 - 计划 - Cron 调度时间表 - 记忆 - 您的偏好和代理自身的记忆 - 护栏 - 在代理仅执行读取操作的地方提供只读访问权限,并设置每次运行的支出上限## 数据源代理读取两个默认数据源:Slack 频道和 GitHub 拉取请求。频道和仓库列在您 `preferences` 文件中。该模板可扩展以使用其他数据源。## 为代理提供其专属的作用域凭据通过托管代理(Managed Agents),凭据存储在保险库中。代理可以引用这些凭据,但实际值保留在保险库中,位于 Claude 代码运行的沙箱之外(参见此处和此处):- MCP 服务器(GitHub)。代理通过运行在沙箱外的代理调用 MCP 工具。代理找到 URL 与服务器匹配的保险库凭据。- Shell(Slack)。代理在沙箱内使用 bash 工具通过 curl 调用 Slack API。沙箱中仅包含一个不透明的占位符 `$SLACK_BOT_TOKEN`。当请求离开沙箱时,平台会将真实令牌替换为您允许的主机。使用 `ant` CLI 和仓库中的模板文件创建保险库:``` ant apply vault.yaml ```这会在您的 Claude API 工作区中创建保险库,由平台存储它,并将其 ID 记录在 `claude-lock.json` 中。然后使用 TypeScript SDK 将每个凭据添加到保险库。以下是添加 Slack 凭据的示例:``` const vaultId = process.env.VAULT_ID!; // 来自 claude-lock.json 的保险库 ID await client.beta.vaults.credentials.create(vaultId, { display_name: "SLACK_BOT_TOKEN", auth: { type: "environment_variable", secret_name: "SLACK_BOT_TOKEN", secret_value: process.env.SLACK_BOT_TOKEN!, networking: { type: "limited", allowed_hosts: ["slack.com"] }, injection_location: { header: true }, }, }); ```创建保险库并添加每个凭据后,将保险库附加到部署。从 `claude-lock.json` 中复制 vault ID,并将其粘贴到部署文件 `deployment.md` 的 `vault_ids` 字段中。## 从上次中断处继续读取常见的错误是要求代理读取一个固定时间窗口,例如“过去 24 小时”。如果运行时间较晚,会留下遗漏;如果运行时间较早,则会重复处理已有项目。相反,应为每个数据源提供一个书签。在每次运行结束时,代理会将它从每个数据源读取到的最新项目的时间戳写入一个名为 `bookmarks.json` 的文件中,每个数据源对应一个条目:`"slack": "2026-09-14T13:02:11Z"`。下一次运行将从这些书签开始,因此其时间窗口会根据自上次运行以来覆盖的内容范围自动伸缩。这些书签存储在称为 `state` 的记忆存储中:这是一个文本文件文件夹,平台会在每次运行的沙箱下挂载到 `/mnt/memory/` 目录,并在运行之间保持持久化。代理使用其常规文件工具来读写该存储,而 `agent.md` 中的指令会告诉它具体操作方法。## 不要将读取失败误认为是平静的一天如果 MCP 服务器宕机或其令牌已过期,运行仍会启动,只是缺少该服务器的工具。会话会记录错误,但代理看不到来自该数据源的任何内容,并报告“无新内容”。`agent.md` 中的三条规则有助于解决此问题。当某个数据源失败时,代理将:保留该数据源的书签不变,编写来自其他数据源的简报,并在简报末尾加上一行说明无法读取的内容(例如“本次运行拉取请求不可用”),以便读者知晓。## 目标我们的模板向单个 Slack 频道发布内容,每次运行时都会生成一条带日期的帖子。代理使用沙箱中的 bash 工具向 Slack 发送帖子,使用的是它与读取操作相同的机器人令牌。无需任何审批即可发布帖子。代理通过 bash 命令发送帖子,内置的 bash 工具默认无需请求批准即可运行。`slack.com` 也在代理运行环境(即沙箱)的白名单中。该帖子是一个请求:``` curl -s https://slack.com/api/chat.postMessage \ -H "Authorization: Bearer $SLACK_BOT_TOKEN" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{"channel": "C0123456789", "text": "Daily brief, Tue Sep 15 ..."}' ``` ## 在记录之前确认帖子已成功送达一旦确认帖子已发布,代理就会更新其已报告项目的账本及其书签。如果这些记录与实际发布的内容不匹配,会出现两种问题。如果代理记录了一条从未成功发布的帖子,书签会跳过这些项目,导致它们永远不会被报告。如果因为不确定第一次发布是否成功而再次发布,读者就会收到相同的简短内容两次。`agent.md` 中的三条规则可以防止这种情况发生。首先,代理会在频道的最近消息中查找今天的标题,如果该版本已经存在,则不进行发布。其次,只有当 Slack 返回 `"ok": true` 和消息时间戳(ts)时,帖子才算作已发送。第三,代理仅在收到确认后才更新分类账和书签。如果结果不明确,它会将运行状态标记为“可能已发布”,且不进行其他任何更改,从而确保没有任何数据丢失。代理在其内存存储(`runs/.md`)中保留运行记录。它在发布前将运行标记为“正在发布”,然后在发布后标记为“已发布”并附带消息 ID,或标记为“可能已发布”。## 代理在 Claude 托管代理中,代理是一个版本化的配置:包括一个模型、一个系统提示词和工具。每次运行都遵循其运行步骤然后停止。

更进一步:量化金融体系

看懂新闻只是起点——沿量化金融路径,把它变成能交付的工程能力

进入量化体系 →

关联讨论

同一事件的更多信源

相似阅读

关联信息,但可能不是同一事件