diff --git a/masked/masked_coze-implementation-guide.md b/masked/masked_coze-implementation-guide.md deleted file mode 100644 index fc901e8..0000000 --- a/masked/masked_coze-implementation-guide.md +++ /dev/null @@ -1,605 +0,0 @@ -# 商务投标助理 - 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. **你的特殊需求** - - 是否需要特定行业的模板？ - - 是否需要集成特定系统？ - - 是否有其他定制化需求？ - -告诉我，我们一步步来实现！🚀