概述
本指南演示如何使用 Deep Agents 从零开始构建一个内容写作代理。 你构建的代理将:- 从
AGENTS.md和技能文件夹加载语音和工作流规则 - 将网络研究任务委托给具有
web_search功能的专用子代理 - 根据加载的技能起草博客或社交内容
- 使用 Gemini 生成封面或社交图片,并将文件保存在项目目录下
核心概念
本教程涵盖:前提条件
API 密钥:- Anthropic (Claude) 或其他提供商的 API 密钥
- 用于使用
gemini-2.5-flash-image进行图像生成的 Google (Gemini) 密钥 - 用于网络搜索的 Tavily(免费套餐)
- 用于跟踪的 LangSmith(可选)
设置
安装依赖
tsx 以运行 content_writer.ts。--input-type=module 标志仅适用于 --eval、--print 或标准输入,不适用于脚本文件路径。安装 @langchain/anthropic,以便 LangChain 可以加载 createDeepAgent 使用的默认 Claude 模型。添加配置文件
该示例将行为保留在三种文件中:记忆、技能和子代理定义。添加 AGENTS.md
在项目根目录创建 要使此代理符合你自己的语气、支柱和格式规则,请更新
AGENTS.md。
当你稍后创建代理并指定此文件作为记忆参数的一部分时,它会被加载到系统提示中,以便品牌语音和研究期望适用于每次运行。AGENTS.md 中的文本。添加技能
创建一个 接下来,创建 它们指示代理首先调用
skills/ 目录。每个技能是一个包含 SKILL.md 文件的文件夹,该文件包含 YAML frontmatter(name、description)和技能说明。创建 skills/blog-post/SKILL.md 并将以下文本复制到其中,其中包含有关创建长篇文章、优化 SEO 内容和生成封面图像的信息。skills/social-media/SKILL.md 并将以下文本复制到其中,其中包含有关起草社交媒体帖子和生成配套图像的信息:researcher 子代理,在 blogs/、linkedin/ 或 tweets/ 下编写 markdown,并调用 generate_cover 或 generate_social_image 生成图像。当你稍后创建代理并指定技能文件夹时,这些技能文件夹中 SKILLS.md 文件的 frontmatter 会被加载到系统提示中,以便代理在任务匹配技能描述时可以使用该技能。构建脚本
在项目根目录创建content_writer.ts。以下部分按顺序属于一个文件。
创建代理
使用 createDeepAgent 创建深度代理时,传入记忆路径、技能目录、图像工具、内联子代理定义和一个以示例目录为根的 FilesystemBackend,以便
./AGENTS.md 和 ./skills/ 等路径能正确解析。运行代理
从项目目录:LANGSMITH_API_KEY 后,你可以在 LangSmith 中检查运行情况。
输出
成功后,代理会在项目根目录(示例目录)下写入工件,例如:SKILL.md 中的技能说明。
完整代码
在 GitHub 上浏览完整的 content-builder-agent 示例,包括基于 Rich 的流式 UI。后续步骤
- 编辑
AGENTS.md以更改品牌语音和研究要求 - 在
skills/<name>/SKILL.md下添加新内容类型的技能 - 在
subagents.yaml中添加子代理,并在load_subagents中注册工具 - 阅读子代理、技能和自定义以进行更深入的配置
将这些文档连接到 Claude、VSCode 等,通过 MCP 获取实时答案。

