aliyun-fc-agentrun

Category: サービス

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/aliyun-fc-agentrun/scripts/quickstart.py

環境変数：

• AGENTRUN_ENDPOINT
• ALIBABACLOUD_ACCESS_KEY_ID
• ALIBABACLOUD_ACCESS_KEY_SECRET
• OUTPUT_DIR（任意）

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

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

環境変数：

• AGENTRUN_ENDPOINT
• ALIBABACLOUD_ACCESS_KEY_ID
• ALIBABACLOUD_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/aliyun-fc-agentrun/scripts/cleanup_runtime.py

環境変数：

• AGENTRUN_ENDPOINT
• ALIBABACLOUD_ACCESS_KEY_ID
• ALIBABACLOUD_ACCESS_KEY_SECRET
• AGENTRUN_RUNTIME_ID
• AGENTRUN_RUNTIME_ENDPOINT_ID
• OUTPUT_DIR（任意）

SDK に関する注意事項

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

出力ポリシー

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

検証

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

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

出力と証拠

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

参考資料

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

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

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

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