文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 记忆库/ 会话管理/ 查询 Session 详情 - ShowCoreSpaceSession
更新时间:2026-11-09 GMT+08:00
分享

查询 Session 详情 - ShowCoreSpaceSession

功能介绍

该接口用于根据 Session ID 获取指定会话的详细信息,在需要查看某个会话的完整属性(如 actor_id、assistant_id、meta 等元数据)时使用。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:memorySpace:showCoreSpaceSession

Read

memorySpace *

g:ResourceTag/<tag-key>

-

-

-

  • agentarts:MemoryActorId

  • agentarts:MemorySessionId

URI

GET /v1/core/spaces/{space_id}/sessions/{session_id}

表1 路径参数

参数

是否必选

参数类型

描述

space_id

是

String

参数解释:

Space ID是记忆空间的唯一标识,可通过"创建Space"获取。

约束限制:

不涉及。

取值范围:

UUID格式。示例:123e4567-e89b-12d3-a456-426614174001。

默认取值:

不涉及。

session_id

是

String

参数解释:

Session ID:会话的唯一标识,可通过"创建Session"接口生成或由调用方指定。

约束限制:

不涉及。

取值范围:

长度1-64字符。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

id

String

参数解释:

Session ID,唯一标识一个会话,可通过"创建Session"接口生成或由调用方指定。

取值范围:

长度1-64字符。

space_id

String

参数解释:

所属 Space ID,标识该记录所属的记忆空间,可通过"创建Space"接口获取。

取值范围:

长度36-36字符。

actor_id

String

参数解释:

归属 Actor ID,标识该记录所属的 Actor。

取值范围:

长度1-64字符。

assistant_id

String

参数解释:

归属 Assistant ID,标识该记录所属的 AI 助手。

取值范围:

长度1-64字符。

meta

Object

参数解释:

扩展元数据,用于存储自定义的附加信息,如标题、标签等。

取值范围:

不涉及。

api_key

String

参数解释:

Session 访问API Key,仅在创建Session指定 enable_session_auth 为 true 时非空。

取值范围:

长度32-128字符。

created_at

String

参数解释:

记录的创建时间,由系统自动生成。

取值范围:

格式为 ISO 8601(YYYY-MM-DDTHH:mm:ssZ)。

updated_at

String

参数解释:

记录的最近更新时间,由系统自动更新。

取值范围:

格式为 ISO 8601(YYYY-MM-DDTHH:mm:ssZ)。

状态码:401

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:403

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

长度1-4096字符。

details

Array of Error objects

参数解释:

依赖的下游服务错误信息列表,包含导致当前请求失败的下游服务错误详情。

取值范围:

不涉及。

表5 Error

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:429

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

长度1-4096字符。

details

Array of Error objects

参数解释:

依赖的下游服务错误信息列表,包含导致当前请求失败的下游服务错误详情。

取值范围:

不涉及。

表8 Error

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

请求示例

/v1/core/spaces/123e4567-e89b-12d3-a456-426614174000/sessions/123e4567-e89b-12d3-a456-426614174001

响应示例

状态码:200

无

状态码:401

{
  "error_code" : "AgentArts.01020002",
  "error_msg" : "Authentication failed"
}

状态码:403

{
  "error_code" : "AgentArts.01020003",
  "error_msg" : "Insufficient permissions"
}

状态码:404

{
  "error_code" : "AgentArts.01020005",
  "error_msg" : "Session does not exist"
}

状态码:429

{
  "error_code" : "AgentArts.01020008",
  "error_msg" : "Too many requests"
}

状态码:500

{
  "error_code" : "AgentArts.01020004",
  "error_msg" : "Internal service error"
}

状态码

状态码

描述

200

成功获取 Session 信息

401

认证失败

403

权限不足

404

Session 不存在

429

请求过于频繁

500

内部服务错误

错误码

请参见错误码。

相关文档