用途：通过 aliyun agentloop 命令操作 AgentLoop 公开 Dataset 能力，包括管理 Dataset 资源与 schema、以类型化结构化行追加数据、用只读 execute-query 查询，以及全文、语义、SQL 或 search-pipe-SQL 检索。不暴露也不操作服务部署、数据库、缓存等内部实现；除非用户单独要求，不管理 AgentSpace。
前置条件：需 Aliyun CLI 3.3.3 或更高版本，AgentLoop 插件 0.7.1 或更高。检查命令：aliyun version、aliyun plugin show --name agentloop。缺失或版本过低时用 aliyun plugin install --names agentloop 安装后验证。CLI 本身缺失或过低应停止，由用户在会话外按组织流程升级，不从本技能下载安装二进制。
认证：使用已有 CLI profile、环境凭证、STS、OAuth 或实例 RAM 角色。不得读取、输出或粘贴 AccessKey、token 等凭证，不得要求用户在命令中传明文凭证，不得用 aliyun configure set 写明文凭证；仅用 aliyun configure list 检查身份与地域。权限失败时记录 API action、被拒 RAM action 和请求 ID，参考 ram-policies.md，可用时调用 ram-permission-diagnose，待用户确认授权后再重试。
参数：执行前确认 --region、--agent-space、--dataset-name 等。Dataset 名用 4–63 位 ASCII，匹配 ^[a-z][a-z0-9](?:_[a-z0-9]+)$。--description 不超过 255 字节。schema 字段类型仅 text、long、double、json；text 分词用 chn；embedding 仅可用于 text/json 字段，值固定为 agentloop-embedding-v4；jsonKeys 仅用于顶层 json 字段。禁止定义 id、time、__dataset_seq、__effective_seq、__expired_seq 保留字段。schema 更新为仅新增。结构化写入优先用 add-dataset-data，dataArray 非空且每项为对象，字段匹配不区分大小写但不得重复大小写变体；请求原子提交。
查询安全：--type 必须为 SQL。execute-query 仅用于只读 SELECT 或 SearchExpr，不得发 INSERT、UPDATE、DELETE、DDL 或多语句。不使用不可信文本拼接 SQL，用户提供值尽量走 add-dataset-data。默认结果 1000 行，最大 100000；查询文本上限 10 MiB，请求体上限 100 MiB。semantic_distance 需显式距离类型如 l2，字段须启用 embedding。相似度阈值在 [0,1]，topk 为 1 到 100000 的整数。
可观测性：首次请求前生成一次 32 位小写十六进制 SESSION_ID，并在本会话所有调用（含 dry run、重试、变更、验证）中复用 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-agentloop-dataset/{session-id}"。
流程：分类意图、确认参数、检查前置、读对应 reference、复杂 JSON 先 --cli-dry-run、执行、验证、报告请求 ID 与证据。
（注：价格、地区可用性等资料暂未提供。）