用途:通过 aliyun CLI 操作阿里云云监控服务(CMS)AgentLoop 下的 ContextStore,持久化长期运行的智能体上下文。ContextStore 分两类:memory(用户偏好、事实、情节摘要、对话记忆)与 experience(从智能体轨迹总结的排障或任务执行经验)。数据操作前必须先确认目标存储的 contextType,两类存储共用同一 CLI 产品与子命令,但写入 schema、过滤字段路径与格式化输出不同。
主要能力:存储管理(创建、获取、列出、更新、删除存储及管理存储级 API Key)、memory 与 experience 数据的写入/搜索/更新/删除、过滤条件构造与结果验证。
必要用法:需 Aliyun CLI >= 3.3.3,运行 aliyun version 校验,不足时用 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 安装或更新。执行 aliyun configure set --auto-plugin-install true 与 aliyun plugin update;CMS 插件需 >= 0.2.4,用 aliyun plugin show --name cms 校验,必要时 aliyun plugin install --names cms --version 0.2.4。凭据通过 CLI profile、环境变量、STS、OAuth 或 ECS RAM 角色提供,仅用 aliyun configure list 检查,禁止读取或打印 AK/SK。执行前需启用 AI 模式:aliyun configure ai-mode enable 与 aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-agentloop-contextstore",任何退出点前须执行 aliyun configure ai-mode disable。所有命令须带 --api-version 2024-03-30。
限制:contextType、contextStoreName、config.source 创建后不可变;immutable 记录不可更新或删除,批量删除会跳过且不计入 deletedCount;delete-contexts 仅接受 --context-ids 或 --filter,二者互斥且不接受请求体;API Key 明文仅在创建时返回一次。权限不足时需参考 RAM 策略申请授权。其余细节暂未提供。