Files
CheersAI-Desktop/masked/masked_coze-implementation-guide.md
T

606 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 商务投标助理 - 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. 检查清单
□ 已替换所有真实公司名称和人名
□ 已删除具体的财务数字和账户信息
□ 已清除文档的属性和元数据
□ 已移除所有批注和修订痕迹
□ 已确认无其他可识别个人或公司的信息
```
---
## 第二步:配置 PersonaAgent人设
### 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 K3
[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. **你的特殊需求**
- 是否需要特定行业的模板?
- 是否需要集成特定系统?
- 是否有其他定制化需求?
告诉我,我们一步步来实现!🚀