mcpField
A
aliyun-ccc-manage

aliyun-ccc-manage

github.com/cinienceクラウド・DevOps39655 回インストール11 週間前に更新
リポジトリ

aliyun-ccc-manage について

aliyun-ccc-manageは、Alibaba Cloud OpenAPIを通じてCloud Call Centerのリソースを管理するスキルです。リソースの調査や設定、トラブルシューティングに向け、APIとパラメーターを確認してから実行結果を検証します。

主な機能

  1. 01CCC APIとパラメーターの確認
  2. 02リソースの一覧・詳細取得
  3. 03設定の作成・更新
  4. 04状態確認とトラブルシューティング
  5. 05証跡と成果物の保存

活用シーン

  1. 01Cloud Call Centerリソースの棚卸し
  2. 02リソース設定の作成や変更
  3. 03変更後のリソース状態の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-ccc-manage

インストール後、Claude Code で/aliyun-ccc-manageを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
sources.md
scripts/
list_openapi_meta_apis.py

詳細

Category: サービス

Cloud Call Center

Alibaba Cloud OpenAPI(RPC)を公式 SDK または OpenAPI Explorer で使用して、Cloud Call Center のリソースを管理します。

ワークフロー

  1. リージョン、リソース識別子、実行する操作を確認します。
  2. API の一覧と必須パラメーターを確認します(参考資料を参照)。
  3. SDK または OpenAPI Explorer で API を呼び出します。
  4. describe/list API で結果を検証します。

AccessKey の優先順位(必ず従うこと)

  1. 環境変数:ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID リージョンの方針:ALIBABACLOUD_REGION_ID は任意のデフォルト値です。設定されていない場合は、タスクに最も適したリージョンを選択してください。不明な場合はユーザーに確認してください。
  2. 共有設定ファイル:~/.alibabacloud/credentials

API の検出

  • プロダクトコード:CCC
  • デフォルトの API バージョン:2020-07-01
  • OpenAPI メタデータエンドポイントを使用して、API の一覧表示とスキーマの取得を行います(参考資料を参照)。

頻繁に使用する操作パターン

  1. インベントリー/一覧表示:現在のリソースを取得するには、List* / Describe* API を優先します。
  2. 変更/設定:変更には、Create* / Update* / Modify* / Set* API を優先します。
  3. ステータス確認/トラブルシューティング:診断には、Get* / Query* / Describe*Status API を優先します。

最小限の実行可能なクイックスタート

ビジネス API を呼び出す前に、メタデータを優先して検出します。

python scripts/list_openapi_meta_apis.py

任意のオーバーライド:

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

スクリプトは、スキルの出力ディレクトリに API インベントリーの成果物を書き込みます。

出力ポリシー

応答または生成された成果物を保存する必要がある場合は、次の場所に書き込みます。 output/aliyun-ccc-manage/

検証

mkdir -p output/aliyun-ccc-manage
for f in skills/ai/service/aliyun-ccc-manage/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-ccc-manage/validate.txt

合格条件:コマンドが 0 で終了し、output/aliyun-ccc-manage/validate.txt が生成されます。

出力とエビデンス

  • 成果物、コマンド出力、API 応答の要約を output/aliyun-ccc-manage/ に保存します。
  • 再現性を確保するため、エビデンスファイルには主要なパラメーター(リージョン/リソース ID/期間)を含めます。

前提条件

  • 実行前に、最小権限の Alibaba Cloud 認証情報を設定してください。
  • 環境変数を優先してください:ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、任意の ALIBABACLOUD_REGION_ID。
  • リージョンが不明な場合は、変更操作を実行する前にユーザーに確認してください。

参考資料

  • ソース:references/sources.md

コメント