企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
数据与智能专区
专区程序调用sdk
通用模型
通用模型
最后更新:2025/02/20

目录

  • 创建企微通用模型任务
  • 获取企微通用模型结果
  • 频率限制说明
  • 应用在专区中的程序可调用本接口传入会话内容,使用企业微信通用的大语言模型进行会话分析,目前通用的大模型有 DeepSeek-R1(灰度中) 与 Hunyuan 两种选项。

    详细说明

    该接口仅支持分析文本消息
    目前该接口只支持自建应用进行调用

    模型的输入协议由管理端的配置决定,除自定义文本外,还可以使用以下3项数据:

    • 会话内容
      识别并替换占位符 {chat},将传入的msg_list对应的会话分行拼接,示例:
      A说:今天天气真不错!
      B说:确实呀!

      识别并替换占位符 {chatcontent},将传入的msg_list对应的会话内容填入(不包含发送者),示例:
      今天天气真不错!
      确实呀!
    • 知识集文档片段
      识别并替换占位符 {knowledge},通过对比与会话内容的相似度来提取到topK个知识集文档片段,示例:
      普通知识集文件:
      文档1:文本片段1
      文档2:文本片段2

      「问答对」知识集文件:
      文档1:问题1:答案1
      文档2:问题2:答案2

      应用类型权限要求
      自建应用需具备「数据与智能专区权限
      代开发应用暂不支持
      第三方应用暂不支持

    创建企微通用模型任务

    请求方法
    通过SDK调用,具体方式参考专区程序使用指引

    请求接口名:
    create_ww_model_task

     

    请求包体:

    {
    	"kb_id": "KBID",
        "msg_list":[{
            "msgid": "MSGID1",
            "encrypt_info":{
                "secret_key": "SECRETKEY1"
            }
        },{
            "msgid": "MSGID2",
            "encrypt_info":{
                "secret_key": "SECRETKEY2"
            }
        }],
    	"model_id": "MODELID"
    }

    参数说明:

    参数是否必须说明
    kb_id知识集id
    msg_list消息列表,最多10个
    msg_list.msgid每条消息对应的msgid。多次出现同一个msgid,以首次出现的为准
    msg_list.encrypt_info.secret_key该消息的密钥,将encrypted_secret_key用RSA私钥解密后得到
    model_id调用的模型id,用于区分调用的是DeepSeek-R1(灰度中)还是Hunyuan模型,在管理端获取。
    只能传入DeepSeek-R1或者Hunyuan模型的模型id,否则会报错。
    不填默认为Hunyuan模型

    model_id字段获取示例(DeepSeek-R1灰度中):
    enter image description hereenter image description here

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok",
        "jobid": "JOBID",
        "fail_list":[
            {
                "errcode": 710601,
                "errmsg": "xxx",
                "msgid": "MSGID2",
                "encrypt_info":{
                    "secret_key": "SECRETKEY2"
                }
            }
        ]
    }

    参数说明:

    参数说明
    errcode错误码
    errmsg错误码说明
    jobid任务id。首次提交时返回
    fail_tag_group_id_list非法的客户标签组id列表
    fail_list提交出错的消息列表,只有msgid重复项返回至该列表,详见FailMsg说明

    FailMsg说明:

    参数说明
    errcode错误码
    errmsg错误码说明
    msgid每条消息对应的msgid,与入参对应
    encrypt_info每条消息对应的加密信息,与入参对应
    encrypt_info.secret_key加密消息用的secret_key

    获取企微通用模型结果

    请求方法
    通过SDK调用,具体方式参考专区程序使用指引

    请求接口名:
    get_ww_model_result

    请求包体:

    {
        "jobid": "JOBID"
    }

    参数说明:

    参数是否必须说明
    jobid任务id

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok",
    	"status": 1,
        "fail_list":[{
            "errcode": 710601,
            "errmsg": "xxx",
            "msgid": "MSGID"
        }],
    	"response_data": "RESULT"
    }

    参数说明:

    参数说明
    errcode错误码
    errmsg错误码说明
    status任务执行状态
    0: 执行未完成
    1: 执行完成
    2: 执行失败
    fail_list错误的消息列表,如msgid不存在、非文本等,详见“创建企微通用模型任务”的FailMsg说明
    response_data企微通用模型的返回结果
    使用DeepSeek-R1模型时,返回的结果开头将是模型的思考过程,以<think>开头,</think>结尾

    频率限制说明

    • 每企业每天不超过1千次(按调用次数限制)
    上一篇管理企业知识集
    下一篇话术推荐模型
      本节内容
    服务端API
    基础
    连接微信
    办公
    会议
    会议统计管理
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们