# AI Agent 工作流运行接口
接口说明：工作流执行接口，用于执行指定 Agent 的工作流。
请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/ai_agent/v1/workflowRun/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| agentId | String | 是 | Agent ID，用于标识要执行的工作流 Agent |
| traceId | String | 否 | 追踪 ID，用于请求链路追踪，默认为空 |
| source | String | 否 | 请求来源，如 web、api 等，默认为空 |
| payload | Object | 否 | 工作流执行所需的业务数据，格式为 JSON 对象，具体结构根据工作流定义而定 |
响应示例：
{
"return_code": "0",
"return_msg": "成功",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
{
"analysisDuration": 5.856,
"analysisNo": "7245648139254996170",
"requestlime": "2025-12-16 17:10:42",
"result": "根据当前天气情况（建邺区，中国江苏省南京市），以下是穿衣建议：\n\n### **天气核心信息**\n- **天气现象**：晴 \n- **温度**：当前17℃，体感温度16℃ \n- **风向/风力**：西北风1级 \n- **湿度**：27%（干燥） \n- **紫外线指数**：0（无紫外线辐射） \n- **云量**：0%（晴朗无云） \n\n\n### **穿衣建议**\n#### **1. 温度与体感** \n当前温度17℃，体感接近16℃，属于**凉爽舒适**区间，适合穿**薄外套+单衣**组合。\n\n#### **2. 具体搭配** \n- **上衣**： \n - 内搭：长袖T恤、薄针织衫或卫衣（材质可选纯棉、羊毛混纺）。 \n - 外搭：轻便风衣、牛仔外套、薄款西装或短款夹克（防风保暖，早晚温差小但风感明显）。 \n- **下装**： \n - 长裤：牛仔裤、休闲裤或薄款西装裤（避免短裤，早晚微凉）。 \n - 裙装：若偏好裙装，可搭配薄款长袜+过膝裙，或选择加绒裤袜。 \n- **鞋子**： \n - 运动鞋、短靴或乐福鞋（舒适为主，无需厚重棉鞋）。 \n- **配件**： \n - 围巾/帽子：可选防风薄围巾（西北风1级，微风感），帽子非必需，晴天可备遮阳帽。 \n - 防晒：紫外线指数0，无需防晒用品，但晴天可备墨镜防强光。 \n\n\n### **注意事项** \n- **干燥环境**：湿度仅27%，皮肤易干燥，建议随身携带保湿护肤品。 \n- **昼夜温差**：南京冬季早晚温差较小（当前体感16℃，夜间可能降至10℃左右），若夜间外出，可加一件厚外套。 \n- **空气质量**：AQI 60（良好），PM2.5 34，户外活动无需佩戴口罩。 \n\n\n**总结**：以"**薄外套+长袖内搭+长裤**"为核心，兼顾保暖与透气，适合日常通勤、散步或轻度户外活动。"
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| analysisDuration | Number | 分析耗时（秒） |
| analysisNo | String | 分析编号，唯一标识本次分析 |
| requestlime | String | 请求时间，格式：yyyy-MM-dd HH:mm:ss |
| result | String | 工作流执行结果内容，具体格式根据工作流定义而定 |
响应参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| return_code | String | 返回码，0 表示成功，1 表示失败 |
| return_msg | String | 返回消息，描述请求处理结果 |
| msg_id | String | 消息 ID，与请求中的 msg_id 一致 |
| response_data | String | 响应数据，JSON 字符串格式。当 HTTP 状态码为 200 时，包含 agent 接口返回的内层 data 对象；失败时包含完整的错误响应信息 |
# 查询客户洞察AGENT对象数据
请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/ai_agent/v1/insightList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| objectKey | VARCHAR(32) | 是 | 对象key |
| page | INT | 是 | 页数，默认值为1 |
| rows | INT | 是 | 条数，默认值为100 |
| sorts | List | 是 | 排序，默认按创建时间倒序排序 |
| sorts.field_key | VARCHAR(30) | 是 | 排序字段 |
| sorts.type | VARCHAR(4) | 是 | 排序类型：asc 正序，desc 倒序 |
| query_group | List | 是 | 查询条件列表 |
| query_group.connector | List | 是 | 组内查询条件，条件AND或OR |
| query_group.filters | VARCHAR(4) | 是 | 组内查询条件 |
| query_group.filters.field_key | VARCHAR(32) | 是 | 字段key |
| query_group.filters.operator | VARCHAR(10) | 是 | 操作符，详见附录操作符说明 (opens new window) |
| query_group.filters.field_values | List | 是 | 字段值集合 |
响应示例：
{
"msg_id":"X000001",
"return_code":0,
"return_msg":"",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"field_QxaDA__c": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"field_T08db__c": "222",
"field_TtFXb__c": "222",
"field_dWPHL__c": [
{
"code": "91CIFbjO",
"label": "选项1",
"status": "1"
}
],
"id": "9222626961451321265",
"field_pOceu__c": "1",
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"field_whz1e__c": "222",
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-03-13 15:23:46"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"field_3kgN5__c": {
"code": "nPFlJR4S",
"label": "选项1"
},
"name": "0313cs02",
"creator_id": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"field_GOITb__c": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"field_8JouQ__c": {
"code": "true",
"label": "是"
},
"status": {
"code": "NORMAL",
"label": "正常"
},
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-03-13 15:23:46"
},
"field_Dxf38__c": "1.00",
"field_Y4dFC__c": "00005",
"business_type": {
"code": "busitype_default__c",
"id": "8438431948543484993"
},
"modifyier_id": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"department": {
"name": "IP16",
"id": "10",
"status": "1"
},
"owner": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"field_MhfYa__c": {
"format": "YYYY-MM-DD HH:mm",
"value": "2025-03-13 15:23"
},
"field_ujceN__c": "222"
}
]
异常示例：
{
"msg_id":"X000001",
"return_code":1,
"return_msg":"查询失败！"
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| id | VARCHAR(32) | 数据id |
| owner | VARCHAR(32) | 负责人 |
| create_time | long | 创建时间 |
| creator_id | long | 创建人 |
| modify_time | long | 修改时间 |
| modifyier_id | long | 修改人 |
| name | long | 主属性 |
| status | long | 状态 |