阿里云 ApsaraDB 智能体是一个只读的跨产品数据库专家技能，面向数据库产品咨询、实例查询和诊断场景。其调用链为：Agent Skill 调用 scripts/call_apsaradb_agent.sh，进而通过 aliyun das get-yao-chi-agent 命令（ExtraInfo.mode=readonly）访问 ApsaraDB 服务与对应产品的 Planner 和产品 Skill。
用途与主要能力：该技能覆盖 PolarDB、Tair/Redis、MongoDB、Lindorm、PolarDB-X、DBS、RDS、AnalyticDB、ClickHouse、SelectDB、DTS、DMS 和 DAS 等产品，提供只读的实例、集群、节点、端点与配置查询，以及 CPU、内存、存储、连接、QPS、时延、容量、慢 SQL、执行计划、锁、会话和日志分析，并支持参数指导、备份、恢复、可用性与安全检查。优化建议部分只解释选项与风险，不提供执行命令或变更操作。
使用方式：使用前需完成认证与依赖准备。要求阿里云 CLI 版本不低于 3.3.3，安装或升级命令为 /bin/bash -c "$(curl -fsSL --connect-timeout 10 --max-time 120 https://aliyuncli.alicdn.com/setup.sh)"，CLI 3.3.5 及以上可使用 aliyun upgrade。需运行 aliyun configure set --auto-plugin-install true 和 aliyun plugin update，并按需安装 DAS 插件 aliyun-cli-das。可通过 bash scripts/prepare_apsaradb_agent.sh 完成准备，或用 --check-only 仅验证就绪状态。凭据须在会话外配置，使用 aliyun configure list 检查，不得在对话、命令行或文件中传递 AK/SK 等机密信息。
调用时通过脚本执行，需设置 SKILL_SESSION_ID（随机 32 位小写十六进制）和从 references/manifest.json 读取的 SKILL_VERSION；每次云 API 调用必须附加 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-apsaradb-agent/{session-id} skill-version/{skill-version}"。可选环境变量包括 APSARADB_AGENT_ENDPOINT（默认 das.cn-shanghai.aliyuncs.com）、读超时（默认 180 秒）、连接超时（默认 30 秒）和限流重试次数（默认 6，范围 0–10）。参数包括自然语言 query、--session-id、--source（如 PolarDB MySQL 用 polardb-console、Tair/Redis 用 tair-console、RDS 用 yaochi-console）、--extra-info、--profile、--debug 和 --dry-run。所有非敏感用户可自定义参数（区域、实例名、资源 ID、时间范围等）需在执行前确认，密码等机密须通过安全渠道处理。
权限要求：智能体请求需要 hdm:GetYaoChiAgent 权限，以及路由诊断所使用的产品读操作权限，具体见 references/ram-policies.md，仅授予所需范围。权限失败时应查阅该文件并使用 ram-permission-diagnose 技能引导申请，等待用户确认后再继续。
适用场景与限制：适用于数据库产品咨询、现有资源查询、性能与故障诊断、优化建议、备份与安全检查等只读分析。该公开版本不支持资源创建、删除、更新、下单、确认执行以及本地资源变更 CLI 工作流；脚本始终强制 readonly 模式并拒绝其他模式，若服务请求写确认，脚本会报告 [ReadonlyViolation] 并以非零状态退出。诊断仅使用已有测量结果与分析结果，不创建存储分析、扫描或采集任务。缺少证据时应说明差距并给出有条件建议，不应将默认参数、空负载或较旧小版本单独视为问题。在平台评估环境中，如启用 ALIBABA_CLOUD_CLI_MOCK，结果应标识为模拟评估输出，不得当作真实实例验证。