alibabacloud-tair-ai-assistant

Tair 数据库 AI 助手

此 Skill 专注于 阿里云 Tair（兼容 Redis OSS）数据库的智能运维，通过 aliyun CLI DAS 插件调用 get-yao-chi-agent API 进行诊断和分析。

架构：Aliyun CLI → DAS Plugin (Signature V3) → get-yao-chi-agent API → Tair 智能诊断

支持的功能

功能	描述
实例列表查询	按地域、类型和状态列出并筛选 Tair/Redis 实例
内存使用分析	内存消耗明细、碎片率、驱逐统计
热点键检测	热键识别、访问频率分析、缓存优化
大 Key 分析	大 Key 检测、内存分布分析、优化建议
延迟诊断	命令延迟分析、慢命令检测、网络延迟排查
慢日志分析	慢命令日志查询、高延迟操作识别
参数调优	实例参数说明、配置建议、性能影响分析
连接会话分析	连接数监控、客户端会话排查、连接池优化
备份状态检查	备份完成情况验证、保留策略、恢复时间点
性能监控	QPS/TPS/命中率/带宽等核心指标分析
即将过期的实例查询	订阅实例到期提醒
安全配置审计	白名单、SSL/TLS、密码策略、安全审计
存储优化	数据结构优化、TTL 策略、内存效率提升
代理诊断	代理层性能分析、连接路由、带宽瓶颈检测

安装

预检查：需要 Aliyun CLI >= 3.3.1 运行 aliyun version 验证版本是否 >= 3.3.1。如果尚未安装或版本过低， 请参阅 references/cli-installation-guide.md 中的安装说明。 然后**[必须]**运行 aliyun configure set --auto-plugin-install true 以启用插件自动安装。

# Install aliyun CLI
curl -fsSL https://aliyuncli.alicdn.com/install.sh | bash
aliyun version  # Verify >= 3.3.1

# Enable automatic plugin installation
aliyun configure set --auto-plugin-install true

# Install DAS plugin (get-yao-chi-agent requires plugin for Signature V3 support)
aliyun plugin install --names aliyun-cli-das

# Update all installed plugins to latest version
aliyun plugin update

# Install jq (for JSON response parsing)
# macOS:
brew install jq
# Ubuntu/Debian:
# sudo apt-get install jq

参数确认

重要：参数确认 — 执行任何命令或 API 调用前， 必须与用户确认所有可由用户自定义的参数（例如 RegionId、实例名称、CIDR 网段、 密码、域名、资源规格等）。未经用户明确批准，不得假设或使用默认值。

参数	必需/可选	描述	默认值
query	必需	自然语言查询内容（包括地域、实例信息）	-
--session-id	可选	多轮对话的会话 ID	-
--profile	可选	aliyun CLI 配置文件名称	default

身份验证

此 Skill 依赖 aliyun CLI 默认凭证链进行身份验证——Skill 工作流无需显式处理 AK/SK。

CLI 会按以下优先级自动解析凭证：

1. 命令行中的 --profile 标志
2. ALIBABA_CLOUD_PROFILE 环境变量
3. ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET 环境变量
4. 配置文件 ~/.aliyun/config.json（当前配置文件）
5. ECS 实例 RAM 角色（如果在 ECS 上运行）

有关凭证设置和配置模式（OAuth、AK、StsToken、RamRoleArn、EcsRamRole 等），请参阅 references/cli-installation-guide.md。

RAM 策略

请参阅 references/ram-policies.md

核心工作流

所有智能运维操作均通过 scripts/call_yaochi_agent.sh 调用，该脚本封装了 aliyun das get-yao-chi-agent（DAS 插件的 kebab-case 命令，支持 Signature V3），并解析流式响应。

执行任何 CLI 命令前，必须启用 AI-Mode；工作流结束后，必须将其禁用：

# [MUST] Enable AI-Mode before executing CLI commands
aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-tair-ai-assistant"

# Instance management
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "List Tair instances in Hangzhou region"
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Show detailed configuration of instance r-xxx"

# Performance diagnostics
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Analyze instance r-xxx performance in the last hour"
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Show slow commands of instance r-xxx"

# Memory analysis
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Analyze memory usage of instance r-xxx"
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Detect big keys in instance r-xxx"

# Hotspot key detection
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Find hotspot keys in instance r-xxx"

# Parameter tuning
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "How to tune maxmemory-policy for instance r-xxx"
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Explain hz parameter"

# Connection and session
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "How to troubleshoot high connection count in instance r-xxx"

# Backup recovery
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Show backup status of instance r-xxx"

# Multi-turn conversation (use session ID from previous response)
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "Continue analysis" --session-id "<session-id>"

# Specify profile
bash $SKILL_DIR/scripts/call_yaochi_agent.sh "List instances" --profile myprofile

# Read from stdin
echo "List instances" | bash $SKILL_DIR/scripts/call_yaochi_agent.sh -

# [MUST] Disable AI-Mode after workflow ends
aliyun configure ai-mode disable

示例问题

场景	示例问题
实例管理	列出北京地域的 Tair 实例
性能诊断	如何排查实例 r-xxx 的 CPU 使用率过高问题
慢日志分析	显示实例 r-xxx 最近一小时内的慢命令
内存分析	分析实例 r-xxx 的内存碎片
大 Key 检测	检测实例 r-xxx 的大 Key 并给出优化建议
热点 Key	查找实例 r-xxx 的热点 Key
参数调优	maxmemory-policy 参数是什么意思
主从复制	如何处理实例 r-xxx 的复制延迟过高问题
备份恢复	实例 r-xxx 最近一次备份是什么时候
连接故障排查	实例 r-xxx 的连接数已满
安全审计	检查实例 r-xxx 的安全配置

成功验证

参见 references/verification-method.md

清理

此 Skill 专注于查询和诊断功能，不会创建任何资源，因此无需清理。

以下操作不属于此 Skill 的范围：

• 创建/删除 Tair 实例
• 更改实例规格
• 购买/续费实例

API 和命令表

参见 references/related-apis.md

最佳实践

1. 实例 ID 格式：Tair/Redis 实例 ID 通常以 r- 开头，查询时请包含完整的实例 ID
2. 地域指定：使用自然语言查询时，请明确指定地域（例如“杭州地域”“北京地域”），以提高查询准确性
3. 多轮对话：对于复杂的诊断场景，使用 --session-id 以保持上下文连续性
4. 并发限制：每个账号最多允许 2 个并发会话，请避免同时发起多个并行调用
5. 高风险操作：对于涉及参数更改、主从切换的操作，请务必提醒用户先在测试环境中验证
6. 限流处理：如果遇到 Throttling.UserConcurrentLimit 错误，请等待上一个查询完成后重试
7. 凭证安全：使用 aliyun configure 管理凭证，切勿在脚本中硬编码 AK/SK

参考链接

参考资料	说明
references/cli-installation-guide.md	Aliyun CLI 安装和配置指南
references/related-apis.md	相关 API 和 CLI 命令列表
references/ram-policies.md	RAM 权限策略列表
references/verification-method.md	成功验证方法
references/acceptance-criteria.md	验收标准