应用在专区中的程序可调用本接口传入会话内容，使用企业微信通用的大语言模型进行会话分析，目前通用的大模型有 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": ["USERID2"],
		  "docid_list": ["DOCID1"],
		  "retrieved_knowledge_list":[
		  		{
					"fragment": "DOCFRAGMENT",
					"ref_id": "REF1"
				}
			]
		}
}

参数说明：

DocRetrievalParams参数说明（应用需具备「数据与智能专区权限 - 分析企业文档数据」 权限，并且企业授权该「数据与智能专区」文档数据权限未过期，功能灰度中）：

RetrievedKnowledgeItem参数说明：

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"
}

参数说明：

频率限制说明

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