# 商务投标助理 - 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. **你的特殊需求**
   - 是否需要特定行业的模板？
   - 是否需要集成特定系统？
   - 是否有其他定制化需求？

告诉我，我们一步步来实现！🚀