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

作者: 系统管理员 | 更新时间: 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配置存储在 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 和 model

  • OpenAPI处理请求 (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
  • 配置优先级：机器人自定义配置 > 全局配置
  • 刷新页面生效：修改全局配置后，需要刷新企业微信全局配置页面才能看到模型选择框

    • 相关文件

    更新日期

    2024-01-21