企业微信机器人腾讯云模型配置说明

# 企业微信机器人腾讯云模型配置说明 ## 功能概述 企业微信机器人现在支持在全局配置中选择腾讯云混元大模型，并可以选择具体使用哪个腾讯云模型。 ## 配置步骤 ### 1. 配置腾讯云密钥 首先需要在"腾讯云AI"页面配置腾讯云的SecretId和SecretKey： 1. 进入后台 → 腾讯云AI 2. 填写SecretId和SecretKey 3. 点击"测试连接"确保配置正确 4. 保存配置 ### 2. 配置全局AI设置 进入"企业微信 → 全局配置 → AI配置"： 1. **AI服务商**：选择"腾讯云混元" 2. **腾讯云混元模型**：选择要使用的模型 - 混元-Lite（性价比高）- `hunyuan-lite` - 混元-Standard（标准版）- `hunyuan-standard` - 混元-Pro（专业版）- `hunyuan-pro` - 混元-Turbo（极速版）- `hunyuan-turbo` - 混元-Turbo（最新版）- `hunyuan-turbos-latest` 3. **系统提示词**：定义AI的角色和行为规范 4. 点击"保存配置" ### 3. 机器人使用全局配置 创建或编辑企业微信机器人时： - 如果机器人的"AI模型"字段为空，将自动使用全局配置的腾讯云模型 - 如果机器人指定了自己的AI模型，将优先使用机器人自己的配置 ## 技术实现 ### 配置存储 全局AI配置存储在 `wework_global_config` 表中： ```json { config_key: "default_ai_config" | config_value: { provider: "tencent" | ai_model: "" | tencent_model: "hunyuan-lite" | system_prompt: "你是一个专业的客服助手..." } } ``` ### 调用流程 1. **企业微信机器人接收消息** (`app/Controllers/Wework.php`) - 读取机器人配置 - 读取全局AI配置 - 构建API请求参数，包含 `provider` 和 `model` 2. **OpenAPI处理请求** (`app/Controllers/OpenApi/Chat.php`) - 接收 `provider` 和 `model` 参数 - 根据 `provider` 选择对应的AI服务商 - 如果是腾讯云，从全局配置读取SecretId作为API Key - 调用腾讯云混元OpenAI兼容接口 3. **腾讯云API调用** - Base URL: `https://api.hunyuan.cloud.tencent.com/v1` - 认证方式: `Authorization: Bearer {SecretId}` - 接口: `/chat/completions` - 模型: 使用配置的 `tencent_model` 值 ## 模型选择建议 | 模型 | 适用场景 | 特点 | |------|---------|------| | hunyuan-lite | 日常客服、简单问答 | 性价比高，响应快 | | hunyuan-standard | 标准客服场景 | 平衡性能和成本 | | hunyuan-pro | 复杂问题、专业咨询 | 理解能力强，回答质量高 | | hunyuan-turbo | 高并发场景 | 极速响应 | | hunyuan-turbos-latest | 需要最新能力 | 最新版本，持续更新 | ## 注意事项 1. **必须先配置腾讯云密钥**：在使用腾讯云模型前，必须在"腾讯云AI"页面配置SecretId和SecretKey 2. **API Key就是SecretId**：腾讯云混元OpenAI兼容接口使用SecretId作为API Key，不需要拼接SecretKey 3. **配置优先级**：机器人自定义配置 > 全局配置 4. **刷新页面生效**：修改全局配置后，需要刷新企业微信全局配置页面才能看到模型选择框 ## 相关文件 - `app/Views/admin/wework/config.php` - 全局配置页面（前端） - `app/Controllers/Admin/WeworkConfig.php` - 全局配置保存逻辑 - `app/Controllers/Wework.php` - 企业微信机器人消息处理 - `app/Controllers/OpenApi/Chat.php` - AI对话API - `docs/腾讯云API签名问题修复.md` - 腾讯云API接入说明 ## 更新日期 2024-01-21