应用在专区中的程序可调用本接口传入会话内容，使用企业微信通用的大语言模型进行会话分析，目前通用的大模型有 Hunyuan · 深度思考（灰度中）、 DeepSeek · 深度思考（灰度中） 与 Hunyuan · 快速回答 三种选项。

详细说明

该接口仅支持分析文本、语音、音频存档消息
目前该接口部分字段只支持第三方应用和代开发应用进行调用
输入协议中各类占位符完成替换后，总长度不超过大约30000个UTF-8字符，否则任务失败

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

• 会话内容
  识别并替换占位符 {chat}，将传入的msg_list对应的会话分行拼接，示例：
  

  A(员工)说：今天天气真不错！
  B(客户)说：确实呀！

  
  识别并替换占位符 {chatcontent}，将传入的msg_list对应的会话内容填入（不包含发送者），示例：
  

  今天天气真不错！
  确实呀！

• 知识集文档片段
  识别并替换占位符 {knowledge}，通过对比与会话内容的相似度来提取到topK个知识集文档片段，示例：
  普通知识集文件：
  

  文档1：文本片段1
  文档2：文本片段2

  
  「问答对」知识集文件：
  

  文档1：问题：问题1, 回答：答案1
  文档2：问题：问题2, 回答：答案2

• 客户标签
  识别并替换占位符 {tagjson}，通过将客户标签组内的标签展开并表示为 json，可以在输入协议中引导模型理解该 json，示例：
  

  {
      "tag_group": [{
          "group_id": "xxx",
          "group_name": "xxx",
          "tag_list": [{
              "tag_id": "xxx",
              "tag_name": "xxx"
          },{
              "tag_id": "xxx",
              "tag_name": "xxx"
          }]
      }]
  }

  
  
• 文档检索
  识别并替换占位符{doc_fragments}，按关键词搜索或指定在线文档/微盘文件拉取全文得到的文档片段，结合自行输入的文档片段（可选）重排后替换成如下格式。
  

  资料1[ref:{ref_id}]
  {文档片段}
  资料2[ref:{doc_url}]
  {文档片段}

  
  如果资料是用户传入的，那么中括号中的ref后就是用户传入的ref_id；如果资料是在专区中检索到的在线文档，那么中括号中的ref后就是企业微信文档URL；
  开发者如有生成带引用来源的回答的需要，可以根据这个结构设计提示词。

• 自定义变量
  在接口中传入name和value组成的自定义变量对，识别并替换自定义占位符，将形如 {$name$} 的占位符内容替换为value，示例：
  模型输入协议：
  

  请执行{$task$}任务

  
  接口传入：
  

  "var_args": [{
      "name": "task",
      "value": "数据分析"
  }]

  
  替换结果为：
  

  请执行数据分析任务

创建企微通用模型任务

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

请求接口名：
create_ww_model_task

请求包体：

{
    "ability_id": "ABILITY_ID",
    "tag_group_list": [{
        "group_id": "GROUP_ID1"
    },{
        "group_id": "GROUP_ID2"
    }],
    "kb_id": "KBID",
    "kb_retrieval_words": "KB_RECALL_STRING",
    "msg_list": [{
        "msgid": "MSGID1",
        "encrypt_info": {
            "secret_key": "SECRETKEY1"
        }
    },{
        "msgid": "MSGID2",
        "encrypt_info": {
            "secret_key": "SECRETKEY2"
        }
    }],
    "model_id": "MODEL_ID",
    "need_think_result": false,
    "var_args": [{
        "name": "VAR_ARGS_NAME1",
        "value": "VAR_ARGS_VALUE1"
    },{
        "name": "VAR_ARGS_NAME2",
        "value": "VAR_ARGS_VALUE2"
    }],
    "doc_retrieval_params": {
          "oper_userid": "USERID1",
          "user_doc_ticket": "TICKET",
          "keywords": ["关键词1", "关键词2"],
          "create_time_start": 1700000000,
          "create_time_end": 1700100000,
          "creator_userid_list": ["USERID2"],
          "docid_list": ["DOCID1"],
          "wedrive_fileid_list": ["WEDRIVE_FILEID1"],
          "doc_type": 8,
          "retrieved_knowledge_list":[
                {
                    "fragment": "DOCFRAGMENT",
                    "ref_id": "REF1"
                }
            ]
        }
}

参数说明：

DocRetrievalParams参数说明（应用需具备「数据与智能专区权限 - 分析企业文档数据」权限，并且企业授权该「数据与智能专区」文档数据权限未过期，功能灰度中）：
两种调用模式（任选其一）
传入了keywords字段即视为调用模式1，未传入keywords字段即视为调用模式2

支持的在线文档类型包括：在线文档、在线表格、智能表格、思维导图、智能文档
支持的微盘文件类型包括：txt、pdf、excel、doc、docx、csv

字段定义

¹ keywords、docid_list、wedrive_fileid_list、retrieved_knowledge_list 至少传一个。仅传 docid_list / wedrive_fileid_list 走模式 2；传 keywords 走模式 1。

RetrievedKnowledgeItem参数说明：

ability_id字段获取示例（所有通用模型都需要，以Hunyuan · 快速回答为例）
在对应模型上图的界面中，点击自定义模型能力按钮，编辑提示词并完成审核发布流程，即可获取能力id(即ability_id)

model_id字段获取示例（Hunyuan · 深度思考 和 DeepSeek · 深度思考 灰度中）：

返回结果：

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

参数说明：

FailMsg说明：

获取企微通用模型结果

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

请求接口名：
get_ww_model_result

请求包体：

{
    "jobid": "JOBID"
}

参数说明：

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "status": 1,
    "fail_list":[{
        "errcode": 710601,
        "errmsg": "xxx",
        "msgid": "MSGID"
    }],
    "response_data": "RESULT",
    "filtered_doc_list":[{
        "docid": "DOCID1",
        "errcode": 710728,
        "errmsg": "xxx"
    },{
        "wedrive_fileid": "WEDRIVE_FILEID1",
        "errcode": 710729,
        "errmsg": "xxx"
    }]
}

参数说明：

FilteredContentItem说明：

频率限制说明

• 每企业每天不超过1万次（按调用次数限制）。
• 每服务商每分钟调用量不超过100次，超过后将导致任务延迟或者任务失败。
• 若资源紧张，任务重试超过24小时仍未有足够资源执行，任务将失败