# 商务投标助理 - Coze 快速开始指南

## 🎯 5分钟快速上手

### 第1步：访问Coze平台（1分钟）

**选择版本**：
- 国际版：https://www.coze.com （需科学上网，支持GPT-4、Claude等）
- 国内版：https://www.coze.cn （无需科学上网，使用豆包大模型）

**注册登录**：
- 使用邮箱或第三方账号登录
- 首次登录会有简单的引导

---

### 第2步：创建知识库（2分钟）

#### 操作路径：
左侧菜单 → 【资源空间】→ 【知识库】→ 【创建知识库】

#### 配置信息：
```
名称：投标文档模板库
类型：文档知识库
描述：包含商务标、技术标的标准模板和案例
```

#### 上传文档：
1. 打开提供的 `knowledge-base-template.md` 文件
2. 复制全部内容
3. 在Coze中点击【添加数据】→ 【文本】
4. 粘贴内容，点击【确定】
5. 等待处理完成（约1分钟）

✅ 完成！知识库创建成功

---

### 第3步：创建Bot（2分钟）

#### 操作路径：
左侧菜单 → 【我的Bot】→ 【创建Bot】

#### 基础配置：
```
Bot名称：商务投标助理
Bot描述：专业的投标文档生成助理
图标：选择一个商务相关的图标（或让AI生成）
```

#### 配置Persona：
1. 点击【Persona & 技能】
2. 打开提供的 `coze-persona-prompt.md` 文件
3. 复制"核心Persona提示词"部分
4. 粘贴到Persona输入框
5. 配置"欢迎语"（复制文档中的欢迎语部分）

#### 添加知识库：
1. 在Bot编辑页面，找到【知识库】区域
2. 点击【+】添加知识库
3. 选择刚才创建的"投标文档模板库"
4. 配置：
   ```
   调用方式：自动调用（推荐）
   或
   调用方式：按需调用（需在Persona中添加触发词）
   ```

✅ 完成！Bot创建成功

---

### 第4步：测试Bot（立即开始）

#### 在右侧对话框测试：

**测试对话1：安全警告**
```
你：你好
Bot：[应显示完整的脱敏警告信息]

预期结果 ✓：Bot提醒数据脱敏的重要性
```

**测试对话2：简单交互**
```
你：我已完成脱敏
Bot：[引导你上传招标文件]

预期结果 ✓：Bot进入正常工作流程
```

**测试对话3：知识检索**（可选）
```
你：如何写成功案例？
Bot：[从知识库检索相关内容并回答]

预期结果 ✓：Bot能够基于知识库回答问题
```

如果测试通过，恭喜！你的基础版投标助理已经可用了 🎉

---

## 📈 进阶配置（可选）

### 选项A：添加工作流（推荐）

如果你想要更强大的功能，可以添加工作流：

#### 创建"招标文件解析"工作流：

1. 左侧菜单 → 【资源空间】→ 【工作流】→ 【创建工作流】
2. 命名：`招标文件解析`
3. 添加节点（按顺序）：

```
[开始节点]
  ↓
[LLM节点] - 提取基本信息
  设置：
  - 模型：选择最强的模型
  - 提示词：见 coze-implementation-guide.md 中的详细配置
  ↓
[LLM节点] - 提取关键要求
  ↓
[LLM节点] - 分析评分标准
  ↓
[代码节点] - 整合结果
  语言：Python
  代码：整合三个LLM输出
  ↓
[结束节点]
```

4. 保存工作流
5. 在Bot中关联工作流

**详细配置**：参见 `coze-implementation-guide.md` 第三步

---

### 选项B：发布到多平台

Bot创建完成后，可以发布到：

#### 1. 网页Widget（推荐）
```
Bot页面 → 【发布】→ 【网页插件】
→ 获取嵌入代码
→ 添加到公司网站
```

#### 2. API接口
```
Bot页面 → 【发布】→ 【API】
→ 获取API Key
→ 使用SDK调用
```

示例代码：
```python
from coze import Coze

client = Coze(api_key="你的API_KEY")

response = client.chat.create(
    bot_id="你的BOT_ID",
    user_id="user_123",
    messages=[{
        "role": "user",
        "content": "请帮我分析这份招标文件",
        "attachments": [...]
    }]
)

print(response.content)
```

#### 3. 企业平台集成
- 飞书/Lark
- 企业微信
- 钉钉

---

## 🎓 常见问题

### Q1: Bot不回复或回复错误？

**检查清单**：
- [ ] Persona提示词是否完整复制？
- [ ] 知识库是否成功关联？
- [ ] 模型是否选择正确？（建议用最强的模型）
- [ ] 是否触发了内容审核？（调整敏感词）

**解决方案**：
1. 查看Bot的【日志】功能，看具体错误
2. 简化Persona提示词，逐步添加功能
3. 检查知识库内容是否被正确索引

---

### Q2: 如何让Bot理解上传的文件？

**当前限制**：
- Coze的Bot在对话中可以接收图片
- 对于PDF、Word文件，需要通过工作流处理

**临时方案**：
1. 用户先将文件内容复制为文本
2. 直接粘贴给Bot
3. Bot进行文本分析

**完整方案**：
1. 创建文件处理工作流
2. 使用代码节点调用文件解析库
3. 或集成第三方OCR/文档解析服务

---

### Q3: 生成的内容太通用，如何定制？

**优化方向**：
1. **完善知识库**：上传你们公司的真实案例（脱敏后）
2. **细化Persona**：添加更多行业专属的指导
3. **添加示例**：在Prompt中加入Few-shot示例
4. **使用变量**：存储公司信息，自动填充

---

### Q4: 如何实现真正的Word导出？

**方案1：后处理（推荐）**
1. Bot生成Markdown内容
2. 用户使用Pandoc等工具转换
3. 在Word中最终调整

**方案2：集成API**
1. 创建自定义插件
2. 调用文档生成API（如ONLYOFFICE API）
3. 返回Word下载链接

**方案3：工作流集成**
1. 在工作流中添加代码节点
2. 使用python-docx库生成Word
3. 保存到云存储，返回链接

---

## 💡 优化建议

### 短期优化（1周内）
- [ ] 测试各种招标文件，完善Prompt
- [ ] 收集真实案例，丰富知识库
- [ ] 调整对话流程，提升用户体验
- [ ] 记录常见问题，建立FAQ

### 中期优化（1个月内）
- [ ] 创建完整的工作流
- [ ] 添加更多专业插件
- [ ] 建立文档模板库（多行业）
- [ ] 实现Word自动生成

### 长期优化（3个月内）
- [ ] Multi-Agent协作（解析专家+写作助手）
- [ ] 用户历史管理（数据库集成）
- [ ] 定时提醒功能
- [ ] 质量自动检查

---

## 📚 学习资源

**官方文档**：
- Coze官方文档：https://www.coze.com/docs
- 工作流教程：https://www.coze.com/docs/guides/workflow
- 插件开发指南：https://www.coze.com/docs/guides/plugin

**社区资源**：
- Coze社区：分享成功案例
- Discord频道：技术交流
- GitHub：开源项目参考

**本项目资源**：
- `coze-implementation-guide.md`：完整实施方案
- `coze-persona-prompt.md`：Persona详细配置
- `knowledge-base-template.md`：知识库内容模板

---

## 🆘 获取帮助

遇到问题？告诉我你：

1. **卡在哪一步了**？
   - 创建知识库？
   - 配置Persona？
   - 创建工作流？
   - 测试对话？

2. **具体什么问题**？
   - Bot不回复？
   - 回复不准确？
   - 功能不工作？
   - 不知道如何配置某个功能？

3. **你的目标**？
   - 只是想快速测试？
   - 想要完整功能？
   - 需要特定定制？

我会根据你的具体情况提供针对性的指导！🚀

---

## ✅ 下一步行动

**立即开始**：
1. [ ] 打开Coze平台
2. [ ] 创建知识库（5分钟）
3. [ ] 创建Bot（5分钟）
4. [ ] 测试基本功能（5分钟）
5. [ ] 根据效果决定是否添加工作流

**准备好了吗？**

开始你的第一个对话吧："你好" → 看看Bot如何响应！

祝你成功！🎯