alicloud-compute-fc-agentrun

カテゴリー：サービス

Function Compute AgentRun（OpenAPI）

AgentRun OpenAPI（ROA）を使用して、ランタイム、サンドボックス、モデルサービス、メモリ、認証情報を管理します。

前提条件

• RAM ユーザー経由の AccessKey（最小権限）。
• 正しいリージョンエンドポイントを選択します（references/endpoints.md を参照）。不明な場合は、タスクに最も適したリージョンを選ぶか、ユーザーに確認してください。
• 手動署名を避けるため、OpenAPI Explorer または公式 SDK を使用します（ROA では SignatureV1 が必要です）。

ワークフロー

1. リージョンエンドポイントを選択します（agentrun.cn-<region>.aliyuncs.com）。
2. ランタイムを作成 → バージョンを公開 → ランタイムエンドポイントを作成します。
3. 必要に応じて、サンドボックス／テンプレートを作成します。
4. 必要に応じて、認証情報とモデルサービスを設定します。
5. トラブルシューティングのためにリソースを照会します。

API グループ

API の一覧とグループ分けについては、references/api_overview.md を参照してください。

スクリプトのクイックスタート

python skills/compute/fc/alicloud-compute-fc-agentrun/scripts/quickstart.py

環境変数：

• AGENTRUN_ENDPOINT
• ALICLOUD_ACCESS_KEY_ID
• ALICLOUD_ACCESS_KEY_SECRET
• OUTPUT_DIR（任意）

ランタイムフローのスクリプト

AGENTRUN_RUNTIME_NAME="my-runtime" \\
AGENTRUN_RUNTIME_ENDPOINT_NAME="my-runtime-endpoint" \\
python skills/compute/fc/alicloud-compute-fc-agentrun/scripts/runtime_flow.py

環境変数：

• AGENTRUN_ENDPOINT
• ALICLOUD_ACCESS_KEY_ID
• ALICLOUD_ACCESS_KEY_SECRET
• AGENTRUN_RUNTIME_NAME
• AGENTRUN_RUNTIME_ENDPOINT_NAME
• AGENTRUN_RUNTIME_DESC（任意）
• OUTPUT_DIR（任意）

クリーンアップスクリプト

AGENTRUN_RUNTIME_ID="runtime-id" \\
AGENTRUN_RUNTIME_ENDPOINT_ID="endpoint-id" \\
python skills/compute/fc/alicloud-compute-fc-agentrun/scripts/cleanup_runtime.py

環境変数：

• AGENTRUN_ENDPOINT
• ALICLOUD_ACCESS_KEY_ID
• ALICLOUD_ACCESS_KEY_SECRET
• AGENTRUN_RUNTIME_ID
• AGENTRUN_RUNTIME_ENDPOINT_ID
• OUTPUT_DIR（任意）

SDK に関する注意事項

SDK の入手方法については、references/sdk.md を参照してください。

出力ポリシー

生成したファイルやレスポンスを保存する場合は、次のディレクトリに保存してください： output/compute-fc-agentrun/。

検証

mkdir -p output/alicloud-compute-fc-agentrun
for f in skills/compute/fc/alicloud-compute-fc-agentrun/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-compute-fc-agentrun/validate.txt

合格条件：コマンドが終了コード 0 で終了し、output/alicloud-compute-fc-agentrun/validate.txt が生成されること。

出力と証跡

• 成果物、コマンド出力、API レスポンスの要約を output/alicloud-compute-fc-agentrun/ に保存します。
• 再現性を確保できるよう、証跡ファイルに主要なパラメーター（リージョン／リソース ID／時間範囲）を含めます。

参考資料

• API の概要と操作一覧：references/api_overview.md

• リージョンエンドポイント：references/endpoints.md

• SDK のガイダンス：references/sdk.md

• ソース一覧：references/sources.md