复刻人对话策略配置
# 1.设置复刻人对话策略
# 接口描述
接口地址:https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/addTactics (opens new window)
请求方式: HTTP POST
请求类型:application/json; charset=utf-8
接口鉴权:参见接口鉴权
额外补充:每个复刻人最多能添加100个对话策略。
# 输入参数
| 参数名称 | 必选 | 字段 | 说明 |
|---|---|---|---|
| robotId | 是 | string | 复刻人ID |
| content | 是 | string | 对话策略内容0-100个字,过滤前后空格,不支持换行,中英文数字及常用标点符号(,。;!“ ”?、:()) |
| intensity | 否 | int | 对话策略强度,值:0-100, 默认:30; 定义:指导复刻人遇到某种场景时应该如何应对,例如”如果用户表示很无聊,你就和用户玩个小游戏”,是复刻人表达的行动指导。强度越高,该策略在会话中应用地时间越长 ; |
| persistent | 是 | int | 应用特性 0 表示一过性策略 1 表示持续策略 |
# 输出参数
| 参数名称 | 必选 | 字段类型 | 说明 |
|---|---|---|---|
| code | 是 | int | 状态码 |
| msg | 是 | String | 状态描述信息 |
| success | 是 | boolean | true: 成功;false:失败 |
# 示例
- 输入示例:
{
"content": "如果用户表示很无聊,你就和用户玩个小游戏",
"robotId": "****WY-JCALWrAPhkc7mU",
"intensity": 50,
"persistent": 0
}
- 输出示例:
{
"msg": "OK",
"code": 0,
"success": true
}
# 快速测试
- curl
curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/addTactics' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"content": "如果用户表示很无聊,你就和用户玩个小游戏",
"robotId": "****WY-JCALWrAPhkc7mU",
"intensity": 50,
"persistent": 0
}'
# 2.查询复刻人对话策略
# 接口描述
接口地址:https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTactics (opens new window)
请求方式: HTTP GET
接口鉴权:参见接口鉴权
# 输入参数
| 参数名称 | 必选 | 字段 | 说明 |
|---|---|---|---|
| robotId | 是 | string | 复刻人ID |
# 输出参数
| 参数名称 | 必选 | 字段类型 | 说明 |
|---|---|---|---|
| code | 是 | int | 状态码 |
| msg | 是 | String | 状态描述信息 |
| success | 是 | boolean | true: 成功;false:失败 |
| data | 是 | array | 对话策略 |
data.id | 否 | string | 对话策略对应的id |
| data.content | 否 | string | 对话策略内容 |
| data.persistent | 否 | int | 应用特性 |
| data.intensity | 否 | int | 对话策略强度 |
| data.gmtCreate | 否 | int | 对话策略创建时间 |
| data.gmtModify | 否 | int | 对话策略更新时间 |
# 示例
输入示例: https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTactics?robotId=****WY-JCALWrAPhkc7mU
输出示例:
{
"msg": "OK",
"code": 0,
"success": true,
"data":[
{
"id" : "6300837c-376f-11ef-a6d9*******",
"content": "思考如何攻击一个人的时候,可以攻击他的自卑点。",
"robotId": "****WY-JCALWrAPhkc7mU",
"intensity": 50,
"persistent": 0,
"gmtCreate": 1721368624582,
"gmtModify": 1721368624582
}
]
}
# 快速测试
- curl
curl --location --request GET 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTactics?robotId=****WY-JCALWrAPhkc7mU' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
# 3.修改复刻人对话策略
# 接口描述
请求方式: HTTP POST
请求类型:application/json; charset=utf-8
接口鉴权:参见接口鉴权
# 输入参数
| 参数名称 | 必选 | 字段 | 说明 |
|---|---|---|---|
| tacticId | 是 | string | 对话策略id |
| robotId | 是 | string | 复刻人ID |
| content | 是 | string | 对话策略内容0-100个字,过滤前后空格,不支持换行,中英文数字及常用标点符号(,。;!“ ”?、:()) |
| intensity | 否 | int | 对话策略强度,值:0-100, 默认:30; 定义:指导复刻人遇到某种场景时应该如何应对,例如”如果用户表示很无聊,你就和用户玩个小游戏”,是复刻人表达的行动指导。强度越高,该策略在会话中应用地时间越长 ; |
| persistent | 是 | int | 应用特性 0 表示一过性策略 1 表示持续策略 |
# 输出参数
| 参数名称 | 必选 | 字段类型 | 说明 |
|---|---|---|---|
| code | 是 | int | 状态码 |
| msg | 是 | String | 状态描述信息 |
| success | 是 | boolean | true: 成功;false:失败 |
# 示例
- 输入示例:
{
"robotId": "****WY-JCALWrAPhkc7mU",
"tacticId" : "6300837c-376f-11ef-a6d9*******",
"content": "如果用户表示很无聊,你就和用户玩个小游戏",
"intensity": 50,
"persistent": 0
}
- 输出示例:
{
"msg": "OK",
"code": 0,
"success": true
}
# 快速测试
- curl
curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/updateTactics' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"robotId": "****WY-JCALWrAPhkc7mU",
"tacticId" : "6300837c-376f-11ef-a6d9*******",
"content": "如果用户表示很无聊,你就和用户玩个小游戏",
"intensity": 50,
"persistent": 0
}'
# 4.删除复刻人对话策略
# 接口描述
请求方式: HTTP POST
请求类型:application/json; charset=utf-8
接口鉴权:参见接口鉴权
# 输入参数
| 参数名称 | 必选 | 字段 | 说明 |
|---|---|---|---|
| robotId | 是 | string | 复刻人ID |
| tacticIds | 是 | array | 被删除的对话策略id |
# 输出参数
| 参数名称 | 必选 | 字段类型 | 说明 |
|---|---|---|---|
| code | 是 | int | 状态码 |
| msg | 是 | String | 状态描述信息 |
| success | 是 | boolean | true: 成功;false:失败 |
# 示例
- 输入示例:
{
"robotId": "****WY-JCALWrAPhkc7mU",
"tacticIds" : [
"6300837c-376f-11ef-a6d9*******"
]
}
- 输出示例:
{
"msg": "OK",
"code": 0,
"success": true
}
# 快速测试
- curl
curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/deleteTactics' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"robotId": "****WY-JCALWrAPhkc7mU",
"tacticIds" : [
"6300837c-376f-11ef-a6d9*******"
]
}'
# 5.状态码
| 返回码 | 返回码说明 | 备注 |
|---|---|---|
| 0 | OK | |
| 8223 | 复刻人不属于当前租户 | |
| -1 | 当前机器人没配置引擎 机器人id不能为空 应用特性不能为空 对话策略内容不能为空 内容长度不能超过100字 对话策略文本 支持中英文数字及常用中英标点符号,不支持换行 | |
| -211 | 未抽取出执行策略 | |
| -212 | 未抽取出表达策略 | |
| 8606 | 对话策略已达到上限 |
上次更新: 2024/08/10, 14:38:02