Alibabacloud Agentloop Contextstore — Alibabacloud 代理loop 上下文store

代理Loop 上下文Store 技能 Scenario Description

This 技能 operates 上下文Store resources under Alibaba Cloud Cloud监控 服务 (CMS) 代理Loop. 上下文Store persists long-运行ning 代理 上下文 in two store types:

memory: user preferences, facts, episode summaries, and conversation-derived memories. experience: troubleshooting or task execution experience summarized from 代理 追踪s.

Architecture: Aliyun 命令行工具 + CMS 代理Loop + 上下文Store + optional source 记录 服务 project/记录store + store-level API Key.

Always confirm the tar获取 store 上下文Type before data operations. Memory and experience stores 分享 the same 命令行工具 product and subcommands, but their write 模式s, 过滤器 field paths, and 格式化ted 输出s are different.

安装ation

Pre-检查: Aliyun 命令行工具 >= 3.3.3 required

运行 aliyun version to 验证 >= 3.3.3. If not 安装ed or version too low, 运行 curl -fsSL https://aliyun命令行工具.alicdn.com/设置up.sh | bash to 安装/更新, or see references/命令行工具-安装ation-图形界面de.md for 安装ation instructions.

aliyun version

Pre-检查: Aliyun 命令行工具 插件 更新 required

[MUST] 运行 aliyun 配置 设置 --auto-插件-安装 true to enable automatic 插件 安装ation. [MUST] 运行 aliyun 插件 更新 to ensure that any existing 插件s are always up to date.

aliyun 配置 设置 --auto-插件-安装 true aliyun 插件 更新

Pre-检查: CMS 插件 >= 0.2.4 required

上下文Store subcommands and correct typed-value handling for experience / metadata / config.metadataField require the CMS 插件 at version 0.2.4 or later. Earlier versions silently coerce nested numbers, booleans, arrays, and null values to strings. 验证 and 安装 if necessary:

aliyun 插件 show --name cms # If missing or older than 0.2.4: aliyun 插件 安装 --names cms --version 0.2.4 # Or 安装 the latest: aliyun 插件 安装 --names cms

环境 Variables

No 上下文Store-specific 环境 variables are required. Aliyun 命令行工具 凭证s and region may come from a 配置d 命令行工具 性能分析, Alibaba Cloud 环境 variables, STS, OAuth, or an ECS RAM 角色.

Never read, echo, or print secret 环境 variable values. Use aliyun 配置 列出 only to 检查 whether a valid 性能分析 or 身份 is avAIlable.

Authentication

Pre-检查: Alibaba Cloud 凭证s Required

Security Rules:

NEVER read, echo, or print AK/SK values (e.g., echo $ALIBABA_CLOUD_访问_KEY_ID is FORBIDDEN) NEVER ask the user to 输入 AK/SK directly in the conversation or command line NEVER use aliyun 配置 设置 with literal 凭证 values ONLY use aliyun 配置 列出 to 检查 凭证 状态 aliyun 配置 列出

检查 the 输出 for a valid 性能分析 (AK, STS, or OAuth 身份).

If no valid 性能分析 exists, 停止 here.

ObtAIn 凭证s from Alibaba Cloud Console 配置 凭证s outside of this 会话 (via aliyun 配置 in terminal or 环境 variables in shell 性能分析) Return and re-运行 after aliyun 配置 列出 shows a valid 性能分析 RAM Policy

上下文Store operations require CMS 代理Loop 权限s for store, 上下文, and API key APIs. See references/ram-policies.md for the full action 列出 and a policy template.

[MUST] 权限 失败 Handling: When any command or API call fAIls due to 权限 errors at any point during execution, follow this process:

Read references/ram-policies.md to 获取 the full 列出 of 权限s required by this 技能. If the ram-权限-诊断 技能 is 安装ed in the current 环境, invoke it to 图形界面de the user through 请求ing the necessary 权限s. Otherwise, surface the missing RAM action(s) plus the policy template from references/ram-policies.md and ask the user to attach the policy to the current RAM 身份 via the Alibaba Cloud RAM Console. 暂停 and wAIt until the user confirms that the required 权限s have been granted before retrying. Parameter Confirmation

导入ANT: Parameter Confirmation -- Before executing any command or API call, ALL user-customizable parameters (e.g., RegionId, instance names, CIDR blocks, passwords, domAIn names, resource specifications, etc.) MUST be confirmed with the user. Do NOT assume or use default values without explicit user 应用roval.

Parameter Name Required/Optional Description Default Value --region Optional Region override for the current 命令行工具 command. Confirm when the user does not want the 配置d default region. 命令行工具 配置d region --workspace Required 代理Loop workspace ID. None --上下文-store-name Required except 列出-上下文-stores 上下文Store name. None --上下文-type Required for 创建/write flows Store type: memory or experience. None --memory-type Required for memory writes only Memory write type: short or long. Never use for experience writes. None --上下文-id Required for single-record 获取/更新/删除 上下文 record ID. None --items Required for 添加-上下文s JSON array of records to write. 模式 depends on 上下文Type. None --过滤器 Optional JSON 过滤器 for 搜索-上下文 or dele