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(可选)
Python 3.11 或更高版本。

设置

1

创建项目目录

2

安装依赖

在你自己的项目中,将 deepagents 固定到一个支持的范围(例如 >=0.3.5,<0.4.0),以匹配上游示例。
3

设置 API 密钥

添加配置文件

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

添加 AGENTS.md

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

添加 subagents.yaml

创建一个名为 subagents.yaml 的文件。 然后添加以下文本,该文本描述了一个具有 Tavily 支持的 web_search 工具、Haiku 模型 ID 的 researcher 子代理,以及在从主代理委派时将发现保存到你指定路径的说明:
该文件稍后在创建深度代理时作为参数传递。
3

添加技能

创建一个 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.py。以下部分按顺序属于一个文件。
1

添加工具

研究子代理使用 Tavily 搜索。 博客和社交工作流使用 Gemini 图像生成。 稍后创建代理时,load_subagents 函数读取 subagents.yaml 并将工具名称解析为这些装饰函数。
2

创建代理

使用 create_deep_agent 创建深度代理时,传递记忆路径、技能目录、图像工具、来自 YAML 的子代理,以及一个以示例目录为根的 FilesystemBackend,以便像 ./AGENTS.md./skills/ 这样的路径能正确解析。
3

添加入口点

使用用户消息调用代理以验证代理是否正常工作:

运行代理

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

输出

成功后,生成的工件将写入系统临时目录(在 macOS 和 Linux 上,通常在 /tmp/ 下),而不是在你的项目文件旁边。
路径遵循 SKILL.md 中的技能说明。

完整代码

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

后续步骤

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