创建 Session - CreateCoreSpaceSession

agentarts:memorySpace:createCoreSpaceSession

Write

memorySpace *

g:ResourceTag/<tag-key>

-

-

-

agentarts:MemoryActorId

space_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

id

否

String

参数解释：

Session ID，如果为空则服务生成ID，如果非空则以此ID创建session（若冲突报错）。

约束限制：

同一space下不可重复。

取值范围：

由字母、数字、连字符（-）、下划线（_）或点号（.）组成的字符串，长度0-64字符。

默认取值：

不涉及。

actor_id

否

String

参数解释：

归属 Actor ID，用于标识对话参与者，提取长期记忆时用于标记会话归属。

约束限制：

不涉及。

取值范围：

长度1-64字符。

默认取值：

不涉及。

assistant_id

否

String

参数解释：

归属 Assistant ID，用于标识 AI 助手。

约束限制：

不涉及。

取值范围：

长度1-64字符。

默认取值：

不涉及。

enable_session_auth

否

Boolean

参数解释：

是否启用 Session 权限隔离。启用后，响应中会携带api_key，该 API Key 可访问的数据范围为：

• 对当前 Session 的消息进行新增和查询；

• 查询当前Session详情；

• 查询当前Session关联的记忆，如果指定了actor_id，assistant_id 字段，可查询相关的 actor_id，assistant_id 关联的长期记忆；

约束限制：

不涉及。

取值范围：

• true: 表示启用 Session 权限隔离

• false: 表示不启用 Session 权限隔离

默认取值：

false。

meta

否

Object

参数解释：

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

约束限制：

不涉及。

取值范围：

自定义json格式，示例：{"title":"订单查询对话","tags":["customer-service","order"]}。

默认取值：

不涉及。

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）。

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

长度1-4096字符。

details

Array of Error objects

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

长度1-4096字符。

details

Array of Error objects

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

201

Session 创建成功

400

请求参数错误

401

认证失败

403

权限不足

429

请求过于频繁

500

内部服务错误