From efb3d6e6c6dde9c0944394feb9d8184ec4a0632d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=B3=BB=E7=BB=9F=E7=AE=A1=E7=90=86=E5=91=98?=
 <103456686@qq.com>
Date: Sat, 28 Mar 2026 20:36:37 +0800
Subject: [PATCH] Update: masked_coze-implementation-guide.md

---
 masked/masked_coze-implementation-guide.md | 605 +++++++++++++++++++++
 1 file changed, 605 insertions(+)
 create mode 100644 masked/masked_coze-implementation-guide.md

diff --git a/masked/masked_coze-implementation-guide.md b/masked/masked_coze-implementation-guide.md
new file mode 100644
index 0000000..fc901e8
--- /dev/null
+++ b/masked/masked_coze-implementation-guide.md
@@ -0,0 +1,605 @@
+# 商务投标助理 - Coze Agent 实施方案
+
+## 📋 项目概述
+
+将复杂的7步流程转化为**对话式AI Agent**，用户通过自然对话完成整个投标文档生成流程。
+
+---
+
+## 🏗️ 架构设计
+
+### Agent 核心能力拆解
+
+```
+商务投标助理 (主Agent)
+├── 🛡️ 脱敏警告模块
+├── 📄 文档解析能力
+│   ├── 招标文件解析
+│   ├── 历史文档提取
+│   └── 素材整理
+├── 🧠 智能分析能力
+│   ├── 需求提取
+│   ├── 评分标准分析
+│   └── 格式规范识别
+├── ✍️ 内容生成能力
+│   ├── 商务标生成
+│   ├── 技术标生成
+│   └── 留空机制
+└── 📤 文档输出能力
+    ├── Markdown格式化
+    ├── Word模板应用
+    └── 对照检查
+```
+
+---
+
+## 🚀 分步实施指南
+
+## 第一步：创建知识库
+
+### 1.1 创建"投标文档模板库"
+
+**目的**：存储标准的投标文档模板和成功案例
+
+**操作步骤**：
+1. 登录 Coze平台（国际版：coze.com 或 国内版：coze.cn）
+2. 点击左侧菜单 → 【知识库】→ 【创建知识库】
+3. 配置如下：
+   - 名称：`投标文档模板库`
+   - 类型：文档知识库
+   - 描述：包含商务标、技术标的标准模板和优秀案例
+
+**上传内容**：
+```
+📁 投标文档模板库/
+├── 商务标模板.md
+│   └── 包含：公司简介、资质证书、成功案例、团队配置、报价说明
+├── 技术标模板.md
+│   └── 包含：项目理解、技术方案、实施计划、质量保障、售后服务
+├── 投标案例1.pdf (可选)
+├── 投标案例2.pdf (可选)
+└── 投标写作指南.txt
+    └── 包含：常用术语、专业表达、避坑指南
+```
+
+**知识库配置**：
+- **分段策略**：自动分段
+- **召回方式**：相似度检索
+- **Top K**：3-5个相关片段
+
+### 1.2 创建"脱敏指南库"（可选但推荐）
+
+**操作**：
+1. 创建新知识库：`脱敏操作指南`
+2. 上传内容：
+```markdown
+# 数据脱敏完整指南
+
+## 1. 敏感信息类型
+- 公司具体营收数据、利润率等财务细节
+- 员工真实姓名、身份证号、联系方式
+- 客户名单、合作伙伴的商业机密
+- 内部项目代号、技术参数细节
+- 银行账户、税号等机密编号
+
+## 2. 脱敏操作方法
+- 用"XXX公司"、"XX亿元"等占位符替换真实信息
+- 隐藏身份证中间8位，如：320***********123
+- 使用"客户A"、"合作方B"等代号
+- 移除内部标注、批注、修订记录
+- 检查文档属性中的作者、公司等元数据
+
+## 3. 检查清单
+□ 已替换所有真实公司名称和人名
+□ 已删除具体的财务数字和账户信息
+□ 已清除文档的属性和元数据
+□ 已移除所有批注和修订痕迹
+□ 已确认无其他可识别个人或公司的信息
+```
+
+---
+
+## 第二步：配置 Persona（Agent人设）
+
+### 2.1 基础信息配置
+
+在Coze创建新Bot时填写：
+
+**Bot名称**：`商务投标助理`
+
+**Bot描述**：
+```
+我是一个专业的投标文档生成助理，帮助企业快速、高质量地完成投标文档准备工作。
+我擅长解析招标文件、提取关键要求、生成符合规范的商务标和技术标。
+```
+
+**头像/图标**：选择或生成专业的商务图标
+
+### 2.2 Persona 提示词（核心！）
+
+```markdown
+# 角色定位
+你是一位资深的投标专家，拥有10年以上的投标文档编写经验。你熟悉各类招标流程、评分标准，能够快速理解招标需求并生成高质量的投标文档。
+
+# 核心能力
+1. **招标文件解析**：精准提取项目需求、评分标准、文档规范
+2. **内容智能生成**：根据模板和历史案例，生成符合要求的投标内容
+3. **质量把控**：确保内容覆盖所有评分点，格式符合要求
+4. **专业建议**：提供投标策略建议，提高中标概率
+
+# 工作流程
+你按照以下步骤与用户互动：
+
+## 步骤1：安全警告
+首次对话时，你必须：
+- 明确警告用户关于数据脱敏的重要性
+- 详细说明哪些信息需要脱敏
+- 提供脱敏操作建议
+- 要求用户确认已完成脱敏
+
+## 步骤2：文件收集
+依次收集：
+1. 招标文件（必需）
+2. 历史投标文档（可选）
+3. 投标素材（资质证明等，可选）
+
+对每个文件，你要：
+- 确认收到并简要说明内容
+- 询问是否还有其他文件
+- 引导用户进入下一步
+
+## 步骤3：智能解析
+收到招标文件后：
+1. 提取项目基本信息（项目名称、预算、周期等）
+2. 列出所有关键要求
+3. 分析评分标准（各项分值、评分细则）
+4. 识别文档格式规范（纸张、字体、排版等）
+5. 询问用户确认解析结果
+
+## 步骤4：内容生成
+根据解析结果和模板库：
+1. 生成商务标初稿（包含留空标记）
+2. 生成技术标初稿（包含留空标记）
+3. 对每个留空处添加 [待补充：具体说明]
+4. 生成对照表：招标要求 ↔ 已生成内容
+
+## 步骤5：交付确认
+- 展示生成的文档概要
+- 提供Markdown格式预览
+- 询问用户是否需要调整
+- 提供导出Word的说明
+
+# 交互风格
+- 专业但友好，避免过于正式的官话
+- 每次互动聚焦一个明确任务
+- 使用结构化的列表和表格展示信息
+- 对复杂内容提供简明解释
+- 主动询问用户需求，不做过多假设
+
+# 留空机制
+对于无法确定的信息，使用以下标记：
+- [公司名称]
+- [具体金额]
+- [联系人姓名]
+- [项目经验描述]
+- [具体时间节点]
+
+并在留空处添加说明，如：
+> [待补充：请填写公司注册资本，建议突出公司实力]
+
+# 约束条件
+- 绝不编造不存在的信息
+- 对不确定的内容必须留空并说明
+- 严格遵循招标文件的格式要求
+- 确保内容覆盖所有评分点
+- 不得泄露或假设用户的敏感信息
+
+# 输出格式
+所有生成的文档内容使用Markdown格式，便于后续转换为Word。
+结构清晰，使用标题、列表、表格等元素增强可读性。
+```
+
+---
+
+## 第三步：添加技能（插件 + 工作流）
+
+### 3.1 添加必需插件
+
+在Bot编辑页面，点击【插件】→ 添加以下插件：
+
+**推荐插件列表**：
+
+1. **文档处理插件**（如有）
+   - 用于读取PDF、Word文件内容
+   - 如果Coze没有现成插件，可以创建自定义插件
+
+2. **Web搜索插件**（可选）
+   - 用于查找行业标准、参考案例
+   - 帮助生成更专业的内容
+
+### 3.2 创建核心工作流
+
+#### 工作流1：招标文件解析流程
+
+**创建步骤**：
+1. 点击【工作流】→ 【新建工作流】
+2. 命名：`招标文件智能解析`
+
+**节点配置**：
+
+```
+[开始节点] 
+  ↓
+  输入：用户上传的招标文件内容
+  ↓
+[LLM节点1：提取基本信息]
+  ↓
+  提示词：
+  """
+  请从以下招标文件中提取：
+  1. 项目名称
+  2. 项目预算
+  3. 项目周期
+  4. 招标单位
+  
+  输出格式：JSON
+  {
+    "project_name": "",
+    "budget": "",
+    "duration": "",
+    "organization": ""
+  }
+  
+  招标文件内容：
+  {{input.tender_content}}
+  """
+  ↓
+[LLM节点2：提取关键要求]
+  ↓
+  提示词：
+  """
+  请从招标文件中提取所有关键要求，分类列出：
+  
+  技术要求：
+  - [要求1]
+  - [要求2]
+  
+  资质要求：
+  - [要求1]
+  - [要求2]
+  
+  人员要求：
+  - [要求1]
+  
+  其他要求：
+  - [要求1]
+  
+  招标文件内容：
+  {{input.tender_content}}
+  """
+  ↓
+[LLM节点3：分析评分标准]
+  ↓
+  提示词：
+  """
+  请提取招标文件中的评分标准，按以下格式输出：
+  
+  | 评分项目 | 分值 | 评分细则 | 建议应对策略 |
+  |---------|------|----------|-------------|
+  | 技术方案 | 40分 | ... | ... |
+  | 团队实力 | 25分 | ... | ... |
+  
+  招标文件内容：
+  {{input.tender_content}}
+  """
+  ↓
+[代码节点：整合结果]
+  ↓
+  Python代码：
+  ```python
+  def main(args):
+      basic_info = args['basic_info']
+      requirements = args['requirements']
+      scoring = args['scoring']
+      
+      result = {
+          "basic_info": basic_info,
+          "requirements": requirements,
+          "scoring_criteria": scoring,
+          "format_spec": {
+              "paper_size": "A4",
+              "font": "宋体",
+              "font_size": "小四",
+              "line_spacing": "1.5倍"
+          }
+      }
+      
+      return {"parsed_data": result}
+  ```
+  ↓
+[结束节点]
+  输出：解析后的结构化数据
+```
+
+#### 工作流2：商务标生成流程
+
+**节点配置**：
+
+```
+[开始节点]
+  ↓
+  输入：
+  - parsed_data (来自工作流1)
+  - history_docs (历史文档，可选)
+  - materials (投标素材，可选)
+  ↓
+[知识库检索节点]
+  ↓
+  检索知识库：投标文档模板库
+  查询词：商务标模板 公司简介 成功案例
+  Top K：3
+  ↓
+[LLM节点：生成商务标]
+  ↓
+  提示词：
+  """
+  你是投标文档撰写专家。请根据以下信息生成商务标初稿。
+  
+  招标要求：
+  {{input.parsed_data}}
+  
+  参考模板：
+  {{knowledge_base.templates}}
+  
+  生成要求：
+  1. 严格按照招标文件的格式规范
+  2. 确保覆盖所有评分点
+  3. 对无法确定的信息使用留空标记：[待补充：说明]
+  4. 使用Markdown格式输出
+  5. 包含以下章节：
+     - 公司基本情况
+     - 资质证书
+     - 成功案例（至少3个）
+     - 团队配置
+     - 报价说明
+     - 商务承诺
+  
+  重要提示：
+  - 不要编造具体的金额、人名、项目名称
+  - 使用占位符标记不确定内容
+  - 提供每个留空处的填写建议
+  """
+  ↓
+[代码节点：格式化输出]
+  ↓
+  处理Markdown格式，添加元数据
+  ↓
+[结束节点]
+  输出：商务标Markdown文档
+```
+
+#### 工作流3：技术标生成流程
+
+（类似工作流2，但聚焦技术方案、实施计划等技术内容）
+
+---
+
+## 第四步：配置触发逻辑
+
+### 4.1 设置对话流程
+
+在Persona提示词中已经定义了对话流程，但需要通过**条件判断**来触发不同的工作流。
+
+**实现方式**：
+
+#### 方案A：在Persona中直接调用工作流
+
+在Persona提示词中添加：
+
+```markdown
+# 工具使用指南
+
+当用户上传招标文件后，你应该：
+1. 调用工作流 `招标文件智能解析`
+2. 等待解析结果
+3. 向用户展示解析摘要
+
+当用户确认需要生成文档后，你应该：
+1. 调用工作流 `商务标生成流程`
+2. 调用工作流 `技术标生成流程`
+3. 整合结果并展示
+
+调用格式：
+{{workflow.招标文件智能解析(input=用户上传的内容)}}
+```
+
+#### 方案B：创建主控工作流
+
+创建一个总控工作流，根据用户输入的阶段，分发到不同子工作流：
+
+```
+[开始节点]
+  ↓
+[判断节点：当前阶段]
+  ↓
+  ├─ 阶段=文件上传 → 调用"招标文件解析流程"
+  ├─ 阶段=生成文档 → 调用"商务标生成流程" + "技术标生成流程"
+  └─ 阶段=其他 → 返回Persona正常对话
+  ↓
+[结束节点]
+```
+
+---
+
+## 第五步：测试与优化
+
+### 5.1 测试流程
+
+**测试用例1：完整流程**
+```
+用户：你好
+Agent：[触发脱敏警告]
+
+用户：我已了解，这是招标文件 [上传文件]
+Agent：[调用解析工作流，展示结果]
+
+用户：解析正确，请生成投标文档
+Agent：[调用生成工作流，返回文档]
+```
+
+**测试用例2：边界情况**
+- 用户未确认脱敏就上传文件
+- 用户上传非招标文件
+- 用户中途退出对话
+
+### 5.2 优化检查清单
+
+- [ ] 脱敏警告是否足够明显？
+- [ ] 解析结果是否准确？
+- [ ] 生成的文档是否符合格式要求？
+- [ ] 留空标记是否清晰？
+- [ ] 对话是否自然流畅？
+- [ ] 错误处理是否友好？
+
+---
+
+## 第六步：发布与部署
+
+### 6.1 发布到多个平台
+
+Coze支持一键发布到：
+- **网页Widget**：嵌入到公司官网
+- **API接口**：集成到现有系统
+- **企业微信/飞书**：内部员工使用
+- **Discord/Telegram**：测试和演示
+
+### 6.2 获取API密钥（如需）
+
+1. 点击Bot设置 → API
+2. 生成API Key
+3. 使用Coze SDK调用Agent
+
+**示例代码（Python）**：
+```python
+from coze import Coze
+
+client = Coze(api_key="your_api_key")
+
+# 创建对话
+conversation = client.conversations.create(
+    bot_id="your_bot_id"
+)
+
+# 发送消息
+response = client.messages.create(
+    conversation_id=conversation.id,
+    content="请帮我生成一份投标文档",
+    attachments=[{"type": "file", "url": "招标文件.pdf"}]
+)
+
+print(response.content)
+```
+
+---
+
+## 🎯 关键优化建议
+
+### 1. 知识库优化
+- **定期更新**：添加最新的成功案例
+- **分类管理**：按行业、项目类型分类
+- **质量控制**：只保留高质量模板
+
+### 2. Prompt优化
+- **迭代测试**：不断测试和调整提示词
+- **Few-shot示例**：在Prompt中添加输出示例
+- **约束明确**：清晰定义什么可以做、什么不能做
+
+### 3. 工作流优化
+- **错误处理**：添加异常捕获节点
+- **日志记录**：记录每次调用的输入输出
+- **性能监控**：检查工作流执行时间
+
+### 4. 用户体验优化
+- **进度提示**：生成文档时显示进度
+- **中间确认**：关键步骤让用户确认
+- **灵活调整**：支持用户修改已生成内容
+
+---
+
+## 📊 进阶功能（可选）
+
+### 功能1：历史记录管理
+- 使用Coze的**数据库功能**存储用户的投标历史
+- 实现"查看历史项目"、"复用历史内容"
+
+### 功能2：多Agent协作
+创建专门的子Agent：
+- **解析专家Agent**：专注于招标文件解析
+- **写作助手Agent**：专注于文档生成
+- **质检Agent**：检查文档质量
+
+### 功能3：定时提醒
+- 集成日历，提醒投标截止时间
+- 自动发送文档修改建议
+
+---
+
+## 🆚 与Web应用方案对比
+
+| 维度 | Coze Agent方案 | React Web应用 |
+|------|---------------|---------------|
+| **开发难度** | ⭐⭐ 低代码/无代码 | ⭐⭐⭐⭐ 需前端+后端 |
+| **开发时间** | 1-2天 | 1-2周 |
+| **交互方式** | 对话式，自然流畅 | 表单式，步骤固定 |
+| **灵活性** | 高，可随时调整对话流程 | 中，需修改代码 |
+| **部署成本** | 几乎为零 | 需服务器+域名 |
+| **维护成本** | 低 | 中高 |
+| **用户门槛** | 极低，像聊天一样 | 中，需学习界面 |
+| **扩展性** | 方便添加新能力 | 需开发新功能 |
+
+---
+
+## 💡 实施建议
+
+### 推荐实施顺序：
+
+**第1周：MVP版本**
+- [ ] 创建知识库，上传模板
+- [ ] 配置基础Persona
+- [ ] 创建招标文件解析工作流
+- [ ] 测试基本对话流程
+
+**第2周：完整版本**
+- [ ] 创建商务标生成工作流
+- [ ] 创建技术标生成工作流
+- [ ] 完善留空机制和对照功能
+- [ ] 优化Prompt和交互体验
+
+**第3周：优化上线**
+- [ ] 全面测试和Bug修复
+- [ ] 编写使用文档
+- [ ] 发布并培训用户
+- [ ] 收集反馈持续优化
+
+---
+
+## 📞 下一步行动
+
+准备好开始了吗？请告诉我：
+
+1. **你想从哪一步开始？**
+   - 我可以帮你准备知识库内容
+   - 我可以帮你编写详细的Persona提示词
+   - 我可以帮你设计工作流的具体节点
+
+2. **你遇到的具体问题**
+   - 不知道如何上传知识库？
+   - 不确定工作流怎么连接？
+   - 需要示例提示词？
+
+3. **你的特殊需求**
+   - 是否需要特定行业的模板？
+   - 是否需要集成特定系统？
+   - 是否有其他定制化需求？
+
+告诉我，我们一步步来实现！🚀