alicloud-ai-recommend-airec

Category: service

AIRec

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

ワークフロー

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

AccessKey の優先順位（必ず従ってください）

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

API の検出

• プロダクトコード：Airec
• デフォルトの API バージョン：2020-11-26
• 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/alicloud-ai-recommend-airec/

検証

mkdir -p output/alicloud-ai-recommend-airec
for f in skills/ai/recommendation/alicloud-ai-recommend-airec/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-recommend-airec/validate.txt

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

出力と証跡

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

前提条件

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

参考資料

• ソース：references/sources.md