alibabacloud-tair-ai-assistant

Tair データベース AI アシスタント

この Skill は、Alibaba Cloud Tair（Redis OSS 互換）データベースのインテリジェントな O&M に重点を置いています。aliyun CLI DAS プラグインを通じて get-yao-chi-agent API を呼び出し、診断と分析を行います。

アーキテクチャ：Aliyun CLI → DAS Plugin (Signature V3) → get-yao-chi-agent API → Tair インテリジェント診断

対応機能

機能	説明
インスタンス一覧の照会	リージョン、タイプ、ステータスで Tair／Redis インスタンスを一覧表示・フィルタリングします
メモリ使用量の分析	メモリ消費量の内訳、断片化率、エビクション統計
ホットスポットキーの検出	ホットキーの特定、アクセス頻度の分析、キャッシュの最適化
ビッグキーの分析	大きなキーの検出、メモリ分布の分析、最適化の提案
レイテンシ診断	コマンドレイテンシの分析、低速コマンドの検出、ネットワークレイテンシのトラブルシューティング
スローログの分析	低速コマンドログの照会、高レイテンシ操作の特定
パラメーターのチューニング	インスタンスパラメーターの説明、構成の提案、パフォーマンスへの影響分析
接続セッションの分析	接続数の監視、クライアントセッションのトラブルシューティング、接続プールの最適化
バックアップステータスの確認	バックアップ完了の検証、保持ポリシー、復旧時点
パフォーマンス監視	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 を参照してください

コアワークフロー

すべてのインテリジェントな O&M 操作は、aliyun das get-yao-chi-agent（DAS プラグインのケバブケース形式のコマンドで、Signature V3 をサポート）をストリーミングレスポンス解析付きでラップする scripts/call_yaochi_agent.sh を通じて実行します。

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 使用率が高い場合のトラブルシューティング方法を教えてください
スローログ分析	過去 1 時間にインスタンス r-xxx で実行された低速なコマンドを表示してください
メモリ分析	インスタンス r-xxx のメモリ断片化を分析してください
ビッグキー検出	インスタンス r-xxx のビッグキーを検出し、最適化を提案してください
ホットスポットキー	インスタンス r-xxx のホットスポットキーを見つけてください
パラメーター調整	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	受け入れ基準