[AI书房] 第4章 第一个智能体工作流：竞品报告自动化
Claude Code完全掌握
Claude Code完全掌握
第4章 第一个智能体工作流：竞品报告自动化
金京镇
引子
屏幕左边打开着一个空文件夹，里面没有任何文件，干干净净的项目。屏幕右边是一个带着小螃蟹图标的聊天窗口，这就是Claude Code的智能体界面。仅凭这个空文件夹和聊天窗口，接下来我们要搭建一套自动生成竞品分析报告的工作流。一行代码都不用亲手写。
安装VS Code并连接Claude Code扩展
要使用Claude Code，先需要安装Visual Studio Code（以下简称VS Code）。VS Code是一种集成开发环境（IDE），可以把它理解为开发者编写和管理代码的工作台。它可以免费下载，Windows和Mac都能运行。
安装完成后打开VS Code。在屏幕左侧的竖向菜单栏中找到四个方块拼在一起的图标，那是扩展（Extensions）菜单。点击这个图标会弹出搜索框，在里面输入「Claude Code」。由Anthropic发布的官方扩展会出现在搜索结果顶部。
安装这个扩展之后，VS Code内部就打开了一个与Claude Code智能体对话的窗口。
点击安装按钮后，系统会立刻要求登录Anthropic账号。使用Claude Code需要付费订阅。Pro方案起步价为每月17美元（约合人民币120元），包含Claude Code和最新的Opus模型。如果用量增大，可以升级到Max方案。
Max方案的使用额度更高，适合同时搭建多个工作流或进行长时间连续对话的场景。
[图4-01：在VS Code左侧扩展菜单中搜索Claude Code的画面。Install按钮已高亮显示。]
打开项目文件夹与理解智能体界面
Claude Code扩展安装完成后，屏幕右上角会出现一个小的Anthropic标志按钮。不过在点击它之前，需要先打开一个项目文件夹。点击左侧菜单中的资源管理器（Explorer）图标，会看到「尚未打开任何文件夹」的提示信息。
在电脑桌面或文档目录下新建一个空文件夹，取名「第一个工作流」就够了。在VS Code中打开这个文件夹，左侧资源管理器会显示文件夹名称，下方空空如也。这片空白区域，接下来会被智能体创建的文件逐步填满。
现在点击右上角的Anthropic标志按钮。如果弹出欢迎页面就关掉它。屏幕分成了两个区域：左边是文件资源管理器，右边是与智能体的对话窗口。这个对话窗口和微信或ChatGPT的界面很像，，输入消息并发送，智能体就会思考、执行、展示结果。在左侧可以实时看到智能体正在创建的文件和文件夹。
[图4-02：VS Code分屏画面。左侧文件资源管理器中显示空的项目文件夹，右侧显示Claude Code聊天界面。]
用计划模式与智能体对话：策划竞品分析工作流
对话窗口底部有模式选择项。在四种模式中选择「计划模式（Plan Mode）」。在计划模式下，智能体不会编写代码或创建文件，而是制定方案、提出问题、建议实现路径。就像盖房子之前先画设计图一样。
对智能体这样说：
「我想搭建一个竞品分析工作流。最终产出是一份带有公司Logo和品牌配色的PDF报告。我输入公司信息后，智能体负责找到竞争对手并进行分析，整理出机会领域和改进建议。请帮我制定方案，有问题尽管问。」
发送这条消息后，智能体开始思考。对话窗口实时显示它的思维过程：「正在探索现有工作流和可用工具」「正在调研品牌适配和PDF生成方案」之类的信息不断滚动。片刻之后，智能体抛出了问题。
智能体的问题问得很具体：「竞争对手如何识别？由您提供名单，还是让我自动发现？」「需要分析哪些维度？定价策略、产品功能、营销话术，可以选择其中几项，也可以全部分析。」「报告生成频率是怎样的？按月、按周，还是按需？」逐一回答这些问题后，智能体会根据答案修改和完善方案。
方案敲定后，智能体展示完整的实施计划书：使用哪些技术（Claude Sonnet模型、Firecrawl API、ReportLab PDF生成库）、按什么目录结构组织文件、需要创建哪些工具文件，全部罗列清楚。成本估算也包含在内，，首次运行约1.5美元，后续重复执行因为有缓存数据，费用会下降。
[图4-03：智能体给出的竞品分析工作流实施计划书，包含技术栈、文件结构和成本估算。]
注入品牌资产：Logo与配色规范的适配
在批准方案之前，先做一项调整：让智能体不要随意选用颜色和字体，而是适配公司的真实品牌形象。
把电脑上保存的公司Logo文件（PNG格式）和品牌规范图片拖到左侧文件资源管理器区域，文件就添加到了项目文件夹中。然后对智能体说：
「我刚放进了Logo文件和品牌规范。请查看这些文件，把Logo、配色和字体应用到PDF报告里。」
智能体随即分析投入的图片：识别Logo，从品牌规范中提取主色、辅助色和字体信息。「已确认Logo，正在提取品牌配色并应用到PDF中」，伴随这条回复，计划书同步更新。现在可以批准方案了。
执行工作流与生成PDF报告
方案获批后，智能体生成待办清单（To-Do List）并启动执行。左侧文件资源管理器中，文件夹和文件开始逐个冒出来。brand_assets文件夹出现了；workflows文件夹里生成了竞品分析工作流文件；tools文件夹中创建了五个Python工具文件。
业务信息采集、竞品发现、竞品调研、竞品分析、PDF报告生成，每一个都是独立的工具。
智能体接着询问公司信息：「主要目标市场是什么？」「价格区间大概在哪里？」「有哪些核心差异化优势？」回答完毕后，智能体创建一个名为business_profile.json的文件来保存公司信息。下次运行这个工作流时，同样的问题不会再问一遍，因为智能体已经记住了。
紧接着，智能体自动展开竞品搜索：在网上检索、生成竞争对手名单、逐一调查每家竞品的产品、定价和优势。调查结果以每个竞品一个独立文件的形式保存在competitors文件夹中。分析结束后，最终的PDF报告随之生成。
[图4-04：工作流执行后左侧文件资源管理器中生成的目录结构，可以看到brand_assets、workflows、tools、competitors文件夹及其中的文件。]
纠错与迭代改进：Logo未显示问题的修复实例
第一次的产出不太可能完美无缺。这不是失败，而是搭建过程中再正常不过的一环。
打开PDF报告看一看。品牌配色和字体都已应用上了，竞品档案、威胁等级分类、战略建议也整理齐全。但Logo没有显示出来，价格分析图表也缺失了。
对智能体说：
「报告整体还不错，但Logo看不见。估计是白色背景上放了白色Logo的缘故。图表也没有。帮我查一下，修好它。」
智能体开始诊断问题，回复说「PDF生成器存在几个问题」，随后列出问题清单，接着修改工具文件中的代码：给Logo背景加上色块衬底，补全图表生成逻辑。用修改后的工具重新生成报告。这次不需要重新采集竞品数据，上一轮运行时缓存的数据直接复用。
打开第二版报告，Logo清晰可见，价格分析图表也到位了。这就是自我修复的过程：人指出错误，智能体定位原因、修改代码、更新工作流，让同样的错误不再出现。
从这里开始进入微调阶段。「竞品档案里加入更详细的信息」「把建议从三条增加到五条」，这类需求用自然语言提出来就行，智能体会照办。工作流运行的次数越多、反馈意见越充分，产出质量就越高。
成本分析：首次运行1.43美元意味着什么
这个工作流首次运行的费用约为1.43美元（约合人民币10元）。调查8家竞品，分析每家的产品、定价和营销策略，生成带有品牌适配的PDF报告，整个流程消耗的API费用就是这些。
如果换成人工来做呢？逐个访问竞品网站、整理信息、用Excel或PowerPoint制作报告，最少半天，多则一整天。考虑到时薪成本，10元人民币的投入产出比堪称惊人。
重复执行的费用还要更低。竞品基础信息和公司档案已经存好了，智能体只需确认有没有变动。数据缓存减少了API调用次数，费用自然也跟着降下来。
这套成本结构，把智能体工作流的经济吸引力压缩到了一张账单里。第一次搭建需要投入时间和费用，之后就能以极低的成本反复运行。而所谓「第一次搭建」，因为智能体承担了绝大部分工作，花的时间其实很短。
PDF报告已经在屏幕上打开了。公司Logo清晰地印在左上角，各竞争对手的威胁等级用颜色区分，价格分析图表把数据直观地呈现出来。生成这份报告所用的全部工具和工作流，都留在项目文件夹里。
下个月只要说一句「把这个月的竞品分析跑一遍」，智能体就会读取工作流、执行工具、输出一份包含最新数据的新报告。不过，驱动这个工作流运转的那份指令书，也就是智能体的操作手册，该怎么写？接下来我们就来看看。
[图4-05：完成的竞品分析PDF报告。包含公司Logo、品牌色、竞争对手概况、价格分析图表等主要页面。]
[图表03-01：智能体工作流的搭建-运行-改进循环。规划模式（规划）→ 搭建（搭建）→ 验证（验证）→ 修改意见（修改）→ 迭代，形成循环流程图。]
人工智能专家 金京镇律师
AI法律政策专家 · 前国会议员 · 著作等身
如果这本书曾在你身边停留片刻，请支持我们，让下一个故事也能问世。
（自愿赞助账户：农协 302-1096-0948-81 户名：金京镇）