aliyun-ccai-manage

Category：サービス

コンタクトセンター AI

Alibaba Cloud OpenAPI（RPC）を公式 SDK または OpenAPI Explorer と組み合わせて使用し、Contact Center AI のリソースを管理します。

ワークフロー

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

• プロダクトコード：ContactCenterAI
• デフォルト API バージョン：2024-06-03
• 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-ccai-manage/

検証

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

合格基準：コマンドが 0 で終了し、output/aliyun-ccai-manage/validate.txt が生成されます。

出力とエビデンス

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

前提条件

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

リファレンス

• ソース：references/sources.md