Update: masked_coze-implementation-guide.md
This commit is contained in:
@@ -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. **你的特殊需求**
|
||||
- 是否需要特定行业的模板？
|
||||
- 是否需要集成特定系统？
|
||||
- 是否有其他定制化需求？
|
||||
|
||||
告诉我，我们一步步来实现！🚀
|
||||
Reference in New Issue
Block a user