文档中心

数据智能体

请输入

会话管理

IDA-创建会话

请求说明

项目	内容
请求方式	`POST`
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/signed/agent/createSession`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`

调用 A2A 接口前，先通过 createSession 创建会话，并将返回的 data.sessionInfo.id 转为字符串作为 A2A 请求的 contextId。需要恢复页面或查询会话详情时，可调用 sessionInfo 获取会话、消息和任务信息。
鉴权：createSession 与 sessionInfo 两个接口均支持现有 OpenAPI 的 JWT 鉴权或 x-token 签名鉴权。

JWT 调用：使用 Authorization: Bearer ${JWT_TOKEN}
当请求体为 JSON 时：设置 Content-Type: application/json

请求参数

参数名	类型	是否必填	说明
agentId	integer	是	智能体 ID。用于指定要创建会话的目标智能体。
name	string	否	会话名称（用于展示/区分会话）。
source	string	否	调用来源标识。示例：`openapi`。
version	string	否	调用版本标识。示例：`v5`。

请求示例

标准 cURL 示例：

curl -X POST \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/signed/agent/createSession" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data-raw '{"agentId":430,"name":"OpenAPI 数据问答","source":"openapi","version":"v5"}' \
  --silent | jq

返回参数

成功返回：data.sessionInfo 返回新会话信息。当前实现可稳定获取 id 与 name；后续 A2A 调用使用其中的 id（转为字符串）作为 contextId。

字段路径	类型	说明
code	string	返回码。成功示例：`llm/ok`。
msg	object	返回信息（可能为空对象）。
data	object	返回数据。
data.sessionInfo	object	新创建的会话信息。
data.sessionInfo.id	integer	会话 ID。后续 A2A 调用需将其转为字符串作为 `contextId`。
data.sessionInfo.name	string	会话名称。

成功返回示例：

{
  "JSONIFY_PRETTYPRINT_REGULAR": false,
  "code": "llm/ok",
  "data": {
    "sessionInfo": {
      "id": 14468,
      "name": "OpenAPI 数据问答"
    }
  },
  "msg": {}
}

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

这个页面对您有帮助吗？

有用

无用

数据智能体

请求说明 #

请求参数 #

请求示例 #

返回参数 #

请求说明

请求参数

请求示例

返回参数