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

作者: 系统管理员
更新时间: 2026-03-24 05:39:29

----------------------------------------

企业微信机器人腾讯云模型配置说明功能概述企业微信机器人现在支持在全局配置中选择腾讯云混元大模型，并可以选择具体使用哪个腾讯云模型。配置步骤1. 配置腾讯云密钥首先需要在"腾讯云AI"页面配置腾讯云的SecretId和SecretKey：进入后台 → 腾讯云AI
填写SecretId和SecretKey
点击"测试连接"确保配置正确
保存配置2. 配置全局AI设置进入"企业微信 → 全局配置 → AI配置"：AI服务商：选择"腾讯云混元"
腾讯云混元模型：选择要使用的模型
   - 混元-Lite（性价比高）- hunyuan-lite
   - 混元-Standard（标准版）- hunyuan-standard
   - 混元-Pro（专业版）- hunyuan-pro
   - 混元-Turbo（极速版）- hunyuan-turbo
   - 混元-Turbo（最新版）- hunyuan-turbos-latest
系统提示词：定义AI的角色和行为规范
点击"保存配置"3. 机器人使用全局配置创建或编辑企业微信机器人时：如果机器人的"AI模型"字段为空，将自动使用全局配置的腾讯云模型
如果机器人指定了自己的AI模型，将优先使用机器人自己的配置

技术实现配置存储全局AI配置存储在 wework_global_config 表中：{
config_key: "default_ai_config" | 
config_value: {
provider: "tencent" | 
ai_model: "" | 
tencent_model: "hunyuan-lite" | 
system_prompt: "你是一个专业的客服助手..."
  }
}
调用流程企业微信机器人接收消息 (app/Controllers/Wework.php)
   - 读取机器人配置
   - 读取全局AI配置
   - 构建API请求参数，包含 provider 和 modelOpenAPI处理请求 (app/Controllers/OpenApi/Chat.php)
   - 接收 provider 和 model 参数
   - 根据 provider 选择对应的AI服务商
   - 如果是腾讯云，从全局配置读取SecretId作为API Key
   - 调用腾讯云混元OpenAI兼容接口腾讯云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 | 需要最新能力 | 最新版本，持续更新 |注意事项必须先配置腾讯云密钥：在使用腾讯云模型前，必须在"腾讯云AI"页面配置SecretId和SecretKey
API Key就是SecretId：腾讯云混元OpenAI兼容接口使用SecretId作为API Key，不需要拼接SecretKey
配置优先级：机器人自定义配置 > 全局配置
刷新页面生效：修改全局配置后，需要刷新企业微信全局配置页面才能看到模型选择框相关文件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