mcpField
A
aliyun-chatbot-manage

aliyun-chatbot-manage

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

aliyun-chatbot-manage について

Chatbot OpenAPI を使って Alibaba Cloud beebot のリソースを管理するスキルです。先に API メタデータを調べ、Describe や List の呼び出しで変更を検証します。

主な機能

  1. 01API とパラメーター仕様の確認
  2. 02リソースの一覧表示と確認
  3. 03設定の作成・更新
  4. 04状態確認とトラブルシューティング
  5. 05環境変数または共有認証情報の利用

活用シーン

  1. 01リージョン内の chatbot リソースの棚卸し
  2. 02beebot リソース設定の変更
  3. 03状態の診断と変更の検証

インストール

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

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

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

同梱ファイル

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

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

詳細

Category: サービス

Chatbot(beebot)

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

ワークフロー

  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 の確認

  • プロダクトコード:Chatbot
  • デフォルトの API バージョン:2022-04-08
  • 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-chatbot-manage/

検証

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

合格基準:コマンドが終了コード 0 で終了し、output/aliyun-chatbot-manage/validate.txt が生成されること。

出力とエビデンス

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

前提条件

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

参考資料

  • ソース:references/sources.md

コメント