开放文档
复刻人产品
复刻人管理相关接口

复刻人观点训练

# 1.复刻人观点训练状态查询

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTrainViewPointStatus (opens new window)
请求方式： HTTP GET
接口鉴权：参见接口鉴权

# 输入参数

参数名称	必选	字段类型	说明
robotId	是	String	复刻人ID

# 输出参数

参数名称	必选	字段类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
success	是	boolean	true：成功；false：失败
data	是	object	业务数据
\|-data.trainStatus	是	String	复刻人观点训练状态（0：训练中；2：空闲）; 训练中的复刻人不可再训练。

# 示例

输入示例:

https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTrainViewPointStatus?robotId=****WY-JCALWrAPhkc7mU

输出示例：

{
    "msg": "ok",
    "code": 0,
    "success":true,
    "data": {
        "trainStatus": 2
    }
}

# 快速测试

curl

curl --location --request GET 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTrainViewPointStatus?robotId=****WY-JCALWrAPhkc7mU' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \

# 2.创建经历训练任务

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/trainViewPoint (opens new window)
请求方式： HTTP POST
请求类型：application/json; charset=utf-8
接口鉴权：参见接口鉴权

# 输入参数

参数名称	必选	类型	说明
robotId	是	String	复刻人ID
viewPoints	是	array	复刻人观点列表对象（如果viewPoints参数为空，提交训练会清空复刻人观点）
\|-viewPoints.viewPointInfo	否	String	观点内容（最多500字）
\|-viewPoints.focus	否	integer	观点强度（最小0，最大100）
callbackUrl	否	String	复刻人观点训练回调接口URL（复刻人系统通过该接口将测试结果反馈给用户）

# 输出参数

参数名称	必选	类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
success	是	boolean	true：成功；false：失败
data	是	object	业务数据
\|-data.errList	是	array	上传文件错误列表，若无错误则为null
\|-data.taskNo	是	string	任务id

# 示例

输入示例:

{
    "robotId": "****WY-JCALWrAPhkc7mU",
    "callbackUrl": "https://xxxxxxxx/xxx/taskStatusCallBack",
    "viewPoints": [
        {
            "focus":50,
            "viewPointInfo":"你非常反感战争，认为战争是愚蠢的"
         },
         {
            "focus":50,
            "viewPointInfo":"你认为做好事就会得到好的回报"
         }
    ]
}

输出示例:

{
    "msg": "ok",
    "code": 0,
    "success":true,
    "data": {
        "taskNo": "03b87337-5b44-48b2-9b66-ceed6b81563f"
    }
}

# 快速测试

curl

curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/trainViewPoint' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "robotId": "****WY-JCALWrAPhkc7mU",
    "callbackUrl": "http://xxxxxxxx/xxx/taskStatusCallBack",
    "viewPoints": [
        {
            "focus":50,
            "viewPointInfo":"你非常反感战争，认为战争是愚蠢的"
         }，
         {
            "focus":50,
            "viewPointInfo":"你认为做好事就会得到好的回报"
         }
    ]
}'

# 3.训练状态查询

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTrainViewPointResult (opens new window)
请求方式： HTTP GET
接口鉴权：参见接口鉴权

# 输入参数

参数名称	必选	类型	说明
taskNo	是	String	任务号
robotId	是	String	复刻人ID

# 输出参数

参数名称	必选	类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
success	是	boolean	true：成功；false：失败
data	是	object	业务数据
\|-data.taskNo	是	int	任务号
\|-data.status	是	int	训练状态（ -1:失败； 0:运行中； 1：成功）
\|-data.startTime	是	String	训练开始时间
\|-data.endTime	是	String	训练结束时间
\|-data.taskNum	是	integer	任务量
\|-data.trainNum	是	integer	训练量

# 示例

输入示例:

https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTrainViewPointResult?taskNo=03b87337-5b44-48b2-9b66-ceed6b81563f&robotId=****WY-JCALWrAPhkc7mU

输出示例：

{
    "msg": "ok",
    "code": 0,
    "success":true,
    "data": {
        "taskNo": "03b87337-5b44-48b2-9b66-ceed6b81563f",
        "startTime": "2023-04-11 15:18:57",
        "endTime": "2023-04-11 15:18:57",
        "status": 1,
        "taskNum":2,
        "trainNum":2
    }
}

# 快速测试

curl

curl --location --request GET 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getTrainViewPointResult?taskNo=03b87337-5b44-48b2-9b66-ceed6b81563f&robotId=****WY-JCALWrAPhkc7mU' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \

# 4.观点训练结果回调

# 接口描述

接口地址：/xxx/taskStatusCallBack(接口名称仅作示例，开发者可自定义)
请求方式： HTTP POST
请求类型：application/json; charset=utf-8
特别说明：回调地址端口仅支持默认80或443端口

# 输入参数

参数名称	必选	类型	说明
taskNo	是	string	任务号
taskStatus	是	integer	任务状态（ -1:失败； 0:运行中； 1：成功）
startTime	是	string	任务开始时间
endTime	是	string	任务结束时间
taskNum	是	integer	任务量
trainNum	是	integer	训练量

# 输出参数

北冥复刻人系统在回调该接口时不解析参数内容，http状态码为200即代表回调成功。因此，输出参数可由开发者自行定义，此处定义仅做参考。

参数名称	必选	类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
success	是	boolean	true：成功；false：失败

# 示例

输入示例:

{
    "taskStatus":1,
    "taskNo":"03b87337-5b44-48b2-9b66-ceed6b81563f",
    "startTime":"2023-04-11 15:18:57",
    "endTime":"2023-04-11 15:18:57",
    "taskNum":2,
    "trainNum":2
}

输出示例：

{
    "code":0,
    "msg":"ok",
    "success":true
}

# 快速测试

略

# 5.复刻人观点查询接口

# 接口描述

接口地址：https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getViewPointContent (opens new window)
请求方式： HTTP GET
接口鉴权：参见接口鉴权

# 输入参数

参数名称	必选	类型	说明
robotId	是	String	复刻人ID

# 输出参数

参数名称	必选	类型	说明
code	是	int	状态码
msg	是	String	状态描述信息
data	是	object	业务数据
\|-data.items	是	String	当前生效观点条数
\|-data.viewPoints	是	array	复刻人观点列表对象
\|\|-viewPoints.viewPointInfo	是	String	观点内容
\|\|-viewPoints.focus	是	integer	观点强度

# 示例

输入示例

https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getViewPointContent？robotId=****WY-JCALWrAPhkc7mU

输出示例

{
    "msg": "ok",
    "code": 0,
    "success":true,
    "data": {
        "items": 2,
        "viewPoints": [
            {
                "focus":50,
                "viewPointInfo":"你非常反感战争，认为战争是愚蠢的"
            },
            {
                "focus":50,
                "viewPointInfo":"你认为做好事就会得到好的回报"
            }
        ]
    }
}

# 快速测试

curl

curl --location --request GET 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/robotProvider/getViewPointContent?robotId=****WY-JCALWrAPhkc7mU' \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \

# 6.状态码

返回码	返回码说明	备注
-1	当前机器人没配置引擎 ; 当前返回对象为空 ; 观点段落数量超过500，请修改后再次提交; 观点训练，强度值范围为0-100，当前值：XX;
8223	复刻人不属于当前租户
57000	远程调用查询机器人当前状态异常; 远程调用创建机器人经历,观点训练任务异常; 远程调用获取机器人当前经历,观点异常 ; 远程调用查询机器人当前状态异常	请联系管理员
5700	agent远程调用查询任务状态异常	请联系管理员
11053	机器人正在训练中，请稍后再试
11051	观点内容格式错误
8100	robotId字段不允许为空
56001	请检查robotId和tenantId

上次更新: 2024/07/15, 14:36:24

← 复刻人基础属性配置复刻人经历训练→