话术推荐模型 - 文档 - 企业微信开发者中心

第三方应用开发

快速入门服务端API 客户端API 工具与资源运营规范附录更新日志联系我们

第三方应用开发

服务端API

数据与智能专区

专区程序调用sdk

话术推荐模型

最后更新：2024/08/08

创建话术推荐任务

获取话术推荐结果

频率限制说明

应用在专区的程序可调用本接口传入会话内容，通过模型进行话术推荐。

详细说明

该接口仅支持分析文本消息

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

创建话术推荐任务

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

请求接口名：
create_recommend_dialog_task

请求包体：

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

参数说明：

参数	是否必须	说明
kb_id	是	大语言模型知识集id，可通过调用「获取知识集列表」接口获取
msg_list	是	消息列表，最多10个
msg_list.msgid	是	每条消息对应的msgid。多次出现同一个msgid，以首次出现的为准
msg_list.encrypt_info.secret_key	是	该消息的密钥，将encrypted_secret_key用RSA私钥解密后得到

返回结果：

{
    "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_recommend_dialog_result

请求包体：

{
    "jobid": "JOBID"
}

参数说明：

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

返回结果：

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

参数说明：

参数	说明
errcode	错误码
errmsg	错误码说明
status	任务执行状态 0: 执行未完成 1: 执行完成 2: 执行失败
fail_list	错误的消息列表，如msgid不存在、非文本等，详见“创建话术推荐任务”的FailMsg说明
response_data	话术推荐的结果