Skip to main content

概述

本指南演示如何使用 Deep Agents 从零开始构建一个内容写作代理。 你构建的代理将:
  1. AGENTS.md 和技能文件夹加载语音和工作流规则
  2. 将网络研究任务委托给具有 web_search 功能的专用子代理
  3. 根据加载的技能起草博客或社交内容
  4. 使用 Gemini 生成封面或社交图片,并将文件保存在项目目录下
本教程中的代码集成了图像生成工具和文件系统后端,以便代理可以在项目目录下读写文章、研究笔记和图片。有关完整的可运行项目,请参阅 content-builder-agent 示例。

核心概念

本教程涵盖:

前提条件

API 密钥:
  • Anthropic (Claude) 或其他提供商的 API 密钥
  • 用于使用 gemini-2.5-flash-image 进行图像生成的 Google (Gemini) 密钥
  • 用于网络搜索的 Tavily(免费套餐)
  • 用于跟踪的 LangSmith(可选)
Node.js 18 或更高版本。

设置

1

创建项目目录

2

安装依赖

添加 tsx 以运行 content_writer.ts--input-type=module 标志仅适用于 --eval--print 或标准输入,不适用于脚本文件路径。安装 @langchain/anthropic,以便 LangChain 可以加载 createDeepAgent 使用的默认 Claude 模型。
3

设置 API 密钥

添加配置文件

该示例将行为保留在三种文件中:记忆、技能和子代理定义。
1

添加 AGENTS.md

在项目根目录创建 AGENTS.md。 当你稍后创建代理并指定此文件作为记忆参数的一部分时,它会被加载到系统提示中,以便品牌语音和研究期望适用于每次运行。
要使此代理符合你自己的语气、支柱和格式规则,请更新 AGENTS.md 中的文本。
2

添加技能

创建一个 skills/ 目录。每个技能是一个包含 SKILL.md 文件的文件夹,该文件包含 YAML frontmatter(namedescription)和技能说明。创建 skills/blog-post/SKILL.md 并将以下文本复制到其中,其中包含有关创建长篇文章、优化 SEO 内容和生成封面图像的信息。
接下来,创建 skills/social-media/SKILL.md 并将以下文本复制到其中,其中包含有关起草社交媒体帖子和生成配套图像的信息:
它们指示代理首先调用 researcher 子代理,在 blogs/linkedin/tweets/ 下编写 markdown,并调用 generate_covergenerate_social_image 生成图像。当你稍后创建代理并指定技能文件夹时,这些技能文件夹中 SKILLS.md 文件的 frontmatter 会被加载到系统提示中,以便代理在任务匹配技能描述时可以使用该技能。

构建脚本

在项目根目录创建 content_writer.ts。以下部分按顺序属于一个文件。
1

添加工具

研究员使用 Tavily 搜索。博客和社交工作流使用 Google Generative AI SDK 进行图像生成。
2

创建代理

使用 createDeepAgent 创建深度代理时,传入记忆路径、技能目录、图像工具、内联子代理定义和一个以示例目录为根的 FilesystemBackend,以便 ./AGENTS.md./skills/ 等路径能正确解析。
3

添加入口点

AI代理正在改变软件开发的方式。

运行代理

文件系统后端可以读取、写入和删除 root_dir 下的文件。仅在专用目录中运行,并在发布前审查生成的内容。
从项目目录:
将提示作为额外参数传递:
设置了 LANGSMITH_API_KEY 后,你可以在 LangSmith 中检查运行情况。

输出

成功后,代理会在项目根目录(示例目录)下写入工件,例如:
路径遵循 SKILL.md 中的技能说明。

完整代码

在 GitHub 上浏览完整的 content-builder-agent 示例,包括基于 Rich 的流式 UI。

后续步骤

  • 编辑 AGENTS.md 以更改品牌语音和研究要求
  • skills/<name>/SKILL.md 下添加新内容类型的技能
  • subagents.yaml 中添加子代理,并在 load_subagents 中注册工具
  • 阅读子代理技能自定义以进行更深入的配置