CreateContextStore --Agent 观测与优化 AgentLoop(AgentLoop)-阿里云帮助中心

创建上下文库

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

agentloop:CreateContextStore

create

*ContextStore

acs:agentloop:{#regionId}:{#accountId}:agentspace/{#AgentSpaceName}/contextstore/{#ContextStoreName}

无

请求语法

POST /agentspace/{agentSpace}/contextstore HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
agentSpace	string	是	AgentSpace 名称，长度 2-64 字符	my-agent-space

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体
contextStoreName	string	是	上下文库名称，AgentSpace 内全局唯一，长度 2-64 字符	my-context-store
contextType	string	是	上下文库类型，枚举值，例如 experience（经验库）、memory（记忆库）等	experience
description	string	否	上下文库描述，便于业务方理解用途	我的上下文库
config	object	否	上下文库配置，包含数据源、元数据字段映射等
source	object	否	数据源配置，仅作为数据源根标识；可选块
agentSpace	string	否	trace 数据源所在的 AgentSpace；不传默认为当前 path 中的 AgentSpace。本期不支持跨 AgentSpace，若传入必须等于 path AgentSpace，否则返回 400 参数错误。创建后不可变更	my-agent-space
startTime	string	否	数据回灌起始时间，ISO 8601 UTC 格式；不传表示从当前时间开始	2026-01-01T00:00:00Z
serviceNames	array	是	服务名列表，必填且非空；与 source.agentSpace 协同定位 trace 数据源（trajectory 抽取服务用 agentSpace 自查绑定的 cms workspace + project/logstore，再按 serviceName 过滤）。创建后不可变更（本期无修改入口）	["order-service","payment-service"]
	string	否	服务名	order-service
metadataField	object	否	元数据字段映射，key 为业务字段，value 为存储字段	{"userId":"user_id","sessionId":"session_id"}
	string	否
miningInterval	string	否	经验挖掘间隔，控制多久执行一次经验挖掘；可选 1h/6h/12h/1d，默认 1d。创建后不可变更	1d
clientToken	string	否	幂等 Token，客户端生成的唯一字符串，保证创建操作幂等	a1b2c3d4-1234-5678-90ab-cdef12345678

返回参数

名称	类型	描述	示例值
	object	响应数据
requestId	string	请求 Id，用于排查问题时定位本次请求	9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M

示例

正常返回示例

JSON格式

{
  "requestId": "9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。