请求说明

项目	内容
请求方式	`GET`
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/signed/agent/sessionList?appId=1&agentId=11&limit=30&before=2629`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`

在 A2A 发起数据问答之外，OpenAPI 侧同样提供会话列表查询接口，用于按 Agent / 应用维度分页拉取当前用户的历史会话。鉴权方式与其他 OpenAPI 接口一致，均使用 JWT。
鉴权方式： jwtToken 鉴权。

请求参数

参数名	类型	是否必填	说明
agentId	int	否	Agent ID，按指定 Agent 过滤会话
appId	int	否	应用 ID
limit	int	否	单页返回条数，默认 20
before	int	否	分页游标，返回该会话 ID 之前的数据，首页可不传或传 -1
fuzzySearch	string	否	按会话名称模糊搜索
sessionType	int	否	会话类型
startDate	string	否	起始日期过滤，格式 `YYYY-MM-DD`
customTag	string	否	自定义标签过滤
source	string	否	来源标识
isMixed	bool	否	是否混合会话
isKnowledgeQA	bool	否	是否知识问答会话
isNewAgent	bool	否	是否新版 Agent

请求示例

curl -X GET \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/signed/agent/sessionList?appId=1&agentId=430&limit=30" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  --silent | jq

返回参数

参数名	类型	说明
code	string	状态码，“llm/ok” 表示成功
msg	object	提示信息
data.sessionList	array	会话列表
data.sessionList[].id	int	会话 ID
data.sessionList[].name	string	会话名称
data.sessionList[].emailPrefix	string	会话所属用户的邮箱前缀
data.sessionList[].dataSetId	int	关联数据集 ID
data.sessionList[].isExpired	bool	会话是否已过期
data.sessionList[].sessionType	int	会话类型
data.sessionList[].latestTaskStatus	string	最近一次任务状态
data.sessionList[].isMixed	bool	是否混合会话
data.sessionList[].createTime	string	创建时间，格式 `YYYY-MM-DD HH:MM:SS`
data.sessionList[].lastActiveTime	string	最后活跃时间
data.sessionList[].serverTime	string	服务端当前时间
data.sessionList[].agentInfo	object	Agent 信息（当会话关联到有效 Agent 时返回，否则返回 `agentId` 字段）
data.sessionList[].isKnowledgeQA	bool	是否知识问答会话
data.sessionList[].customTag	array	自定义标签列表

返回示例

{
  "JSONIFY_PRETTYPRINT_REGULAR": false,
  "code": "llm/ok",
  "data": {
    "sessionList": [
      {
        "agentInfo": {
          "agentType": "Expert",
          "avatar": "system3",
          "creatorPrefix": "admin",
          "description": "openApi 测试",
          "detail": null,
          "id": 430,
          "isNewAgent": true,
          "isPersonal": false,
          "mtime": "2026-08-11 11:29:17",
          "name": "openApi",
          "privilegeType": "agent"
        },
        "createTime": "2026-08-11 11:46:04",
        "customTag": [],
        "dataSetId": null,
        "emailPrefix": "admin",
        "id": 14442,
        "isExpired": true,
        "isKnowledgeQA": true,
        "isMixed": false,
        "lastActiveTime": "2026-08-11 11:51:07",
        "latestTaskStatus": "completed",
        "name": "分析一下最近的电商平台销售情况",
        "serverTime": "2026-08-11 16:13:47",
        "sessionType": "deep_research"
      }
    ]
  },
  "msg": {}
}

最近更新时间：2026.08.17 14:31:59

这个页面对您有帮助吗？

有用

无用

数据智能体

请求说明 #

请求参数 #

请求示例 #

返回参数 #

返回示例 #

请求说明

请求参数

请求示例

返回参数

返回示例