Update: masked_QUICK-START.md

2026-03-28 20:28:40 +08:00
parent 2f410a510f
commit 5536508289
1 changed files with 331 additions and 0 deletions
@@ -0,0 +1,331 @@
+# 商务投标助理 - 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如何响应！
+
+祝你成功！🎯