alicloud-ai-chatbot について
OpenAPI を通じて Alibaba Cloud Chatbot(beebot)のリソースを管理するスキルです。API の検出を起点に、リソースの照会・変更・ステータス確認を行い、管理やトラブルシューティングに利用できます。
主な機能
- 01OpenAPI による beebot リソース管理
- 02API 操作とパラメーターの検出
- 03リソースの一覧表示と確認
- 04設定の作成または更新
- 05トラブルシューティング用のステータス照会
活用シーン
- 01利用可能な Chatbot API の検出
- 02既存 Chatbot リソースの確認
- 03リソース設定の変更
- 04問題調査時のサービス状態確認
MCP 対応
入力には MCP 連携や MCP インターフェースについての記載がありません。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-ai-chatbotインストール後、Claude Code で/alicloud-ai-chatbotを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdscripts/list_openapi_meta_apis.py詳細
Category: service
チャットボット(beebot)
Alibaba Cloud OpenAPI(RPC)と公式 SDK または OpenAPI Explorer を使用して、beebot のリソースを管理します。
ワークフロー
- リージョン、リソース識別子、実行する操作を確認します。
- API リストと必須パラメーターを確認します(参考情報を参照)。
- SDK または OpenAPI Explorer で API を呼び出します。
- describe/list API で結果を確認します。
AccessKey の優先順位(必ず従ってください)
- 環境変数:
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET/ALICLOUD_REGION_IDリージョンポリシー:ALICLOUD_REGION_IDは任意のデフォルト値です。設定されていない場合は、タスクに最も適したリージョンを選択します。不明な場合はユーザーに確認してください。 - 共有設定ファイル:
~/.alibabacloud/credentials
API の確認
- 製品コード:
Chatbot - デフォルトの API バージョン:
2022-04-08 - OpenAPI メタデータエンドポイントを使用して、API の一覧表示とスキーマの取得を行います(参考情報を参照)。
高頻度の操作パターン
- インベントリ/一覧表示:現在のリソースを取得するには、
List*/Describe*API を優先します。 - 変更/設定:変更には、
Create*/Update*/Modify*/Set*API を優先します。 - ステータス/トラブルシューティング:診断には、
Get*/Query*/Describe*StatusAPI を優先します。
最小限の実行可能なクイックスタート
ビジネス API を呼び出す前に、メタデータを確認します。
python scripts/list_openapi_meta_apis.py
任意のオーバーライド:
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>
スクリプトは、API インベントリアーティファクトをスキルの出力ディレクトリに書き込みます。
出力ポリシー
レスポンスまたは生成されたアーティファクトを保存する必要がある場合は、次の場所に書き込みます。
output/alicloud-ai-chatbot/
検証
mkdir -p output/alicloud-ai-chatbot
for f in skills/ai/service/alicloud-ai-chatbot/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-chatbot/validate.txt
合格条件:コマンドが 0 で終了し、output/alicloud-ai-chatbot/validate.txt が生成されること。
出力と証拠
- アーティファクト、コマンド出力、API レスポンスの要約を
output/alicloud-ai-chatbot/に保存します。 - 再現できるよう、証拠ファイルに主要なパラメーター(リージョン/リソース ID/期間)を含めます。
前提条件
- 実行前に、最小権限の Alibaba Cloud 認証情報を設定します。
- 環境変数
ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET、任意のALICLOUD_REGION_IDの使用を推奨します。 - リージョンが不明な場合は、変更操作を実行する前にユーザーに確認してください。
参考情報
- ソース:
references/sources.md
コメント
Markdown 対応