【智能体】如何做一个教程写作智能体？-平芜编程栈

要实现一个教程写作智能体（AI agent that generates tutorials），有两种主要路径：无代码/低代码平台（快速上手，适合初学者）和代码实现（更灵活、可定制，适合开发者）。下面我一步步详细说明如何实现，包括推荐工具、步骤和示例。

1. 无代码/低代码方式（推荐入门）

使用现成平台，几分钟就能创建一个专用于生成教程的AI智能体。这些平台内置大模型（如GPT、文心一言、通义千问），支持自定义提示词、知识库和插件。

推荐平台：

Coze（扣子，由字节跳动开发）：国内最受欢迎，免费门槛低，支持工作流。
Dify：开源，支持自部署，适合构建复杂Agent。
文心智能体平台（百度）：中文优化好，集成文心一言模型。
其他：Claude Projects、Flowise、LangFlow。

实现步骤（以Coze为例）：

注册并登录Coze（https://www.coze.com）。
创建新Bot/智能体。
设置简介：例如“你是一个专业的教程写作专家，能根据用户提供的主题生成结构清晰、步骤详细的教程”。

编写系统提示词（Prompt）（核心部分）：

你是一个优秀的教程写作助手。用户会提供一个主题（如“Python入门”或“如何使用Excel制作报表”），你需要生成一个完整的教程。 教程结构必须包括： - 标题 - 引言（说明教程目标和适用人群） - 前置知识/准备工作 - 详细步骤（用编号列表，每步解释清楚，支持代码、截图描述） - 常见问题与解决 - 总结与进一步学习资源 输出要清晰、易懂、使用Markdown格式。语言友好、专业。如果需要搜索最新信息，使用工具获取。

添加知识库：上传教程模板、优秀范文或相关文档，让AI参考。
添加插件/工具（可选，提升质量）：
- 搜索插件（获取最新信息）。
- 图片生成插件（描述截图）。
- 代码执行插件（验证代码）。
测试：输入“帮我写一个‘如何使用Git入门’的教程”，迭代优化提示词。
发布：生成链接分享，或嵌入网站。

类似地在Dify或文心平台操作，就能快速得到一个专用教程生成器。

2. 代码实现方式（更强大、可集成）

使用Python框架构建，支持本地运行或部署。推荐CrewAI（专为多代理协作设计，非常适合内容创作）或LangChain（灵活，生态丰富）。

选项A：使用CrewAI（推荐内容生成场景）

CrewAI擅长“团队协作”：多个代理分工（如研究员、作家、编辑），生成高质量教程。

步骤：

安装：
```
pipinstallcrewai langchain-openai
```
获取API密钥（OpenAI、Groq、DeepSeek等）。

代码示例（生成教程的完整Crew）：

fromcrewaiimportAgent,Task,Crewfromlangchain_openaiimportChatOpenAI# 设置LLM（可换成其他模型）llm=ChatOpenAI(model="gpt-4o-mini",api_key="your_key")# 定义代理（角色分工）researcher=Agent(role="研究员",goal="搜集主题相关准确信息和最佳实践",backstory="你是技术文档专家，擅长查找最新资料",llm=llm,allow_delegation=False)writer=Agent(role="教程作家",goal="根据研究资料写出清晰、步骤详细的教程",backstory="你是优秀的技术教程作者，结构化强、语言易懂",llm=llm)editor=Agent(role="编辑",goal="润色教程，确保逻辑流畅、无错误",backstory="你是专业编辑，注重可读性和完整性",llm=llm)# 定义任务task1=Task(description="研究主题：{topic}，输出关键点、步骤和注意事项",agent=researcher,expected_output="结构化的研究笔记")task2=Task(description="基于研究笔记，写完整教程，使用Markdown格式，包括引言、步骤、代码示例、总结",agent=writer,expected_output="完整教程草稿")task3=Task(description="审查并优化教程，确保清晰、专业",agent=editor,expected_output="最终教程")# 组装Crewcrew=Crew(agents=[researcher,writer,editor],tasks=[task1,task2,task3],verbose=True)# 运行result=crew.kickoff(inputs={"topic":"如何使用Python爬取网页"})print(result)

运行后，会输出一个高质量教程。优点：分工明确，输出更专业。

选项B：使用LangChain（更灵活）

适合单代理+工具。

简单示例：

fromlangchain.agentsimportcreate_react_agent,AgentExecutorfromlangchain_openaiimportChatOpenAIfromlangchainimporthubfromlangchain.toolsimportTool llm=ChatOpenAI(model="gpt-4o",api_key="your_key")# 自定义工具（可选，如搜索）defsearch_tool(query):returnf"搜索结果：{query}的相关信息..."# 可集成真实搜索tools=[Tool(name="Search",func=search_tool,description="用于搜索最新信息")]# 拉取ReAct提示模板prompt=hub.pull("hwchase17/react")agent=create_react_agent(llm,tools,prompt)agent_executor=AgentExecutor(agent=agent,tools=tools)# 系统提示集成到查询中response=agent_executor.invoke({"input":"你是一个教程写作专家，请根据主题'如何安装Docker'生成一个详细教程，包括步骤、截图描述和常见问题。"})print(response['output'])