Category: service
Function Compute AgentRun (OpenAPI)
Use AgentRun OpenAPI (ROA) to manage runtimes, sandboxes, model services, memory, and credentials.
Prerequisites
-
AccessKey via RAM user (least privilege).
-
Select the correct regional endpoint (see references/endpoints.md ). If unsure, choose the most reasonable region for the task or ask the user.
-
Use OpenAPI Explorer or official SDK to avoid manual signing (ROA requires SignatureV1).
Workflow
-
Choose region endpoint (agentrun.cn-<region>.aliyuncs.com ).
-
Create runtime → publish version → create runtime endpoint.
-
Create sandbox/template if needed.
-
Configure credentials and model services as required.
-
Query resources for troubleshooting.
API Groups
See references/api_overview.md for the full API list and grouping.
Script quickstart
python skills/compute/fc/alicloud-compute-fc-agentrun/scripts/quickstart.py
Environment variables:
-
AGENTRUN_ENDPOINT
-
ALICLOUD_ACCESS_KEY_ID
-
ALICLOUD_ACCESS_KEY_SECRET
-
OUTPUT_DIR (optional)
Runtime flow script
AGENTRUN_RUNTIME_NAME="my-runtime" \ AGENTRUN_RUNTIME_ENDPOINT_NAME="my-runtime-endpoint" \ python skills/compute/fc/alicloud-compute-fc-agentrun/scripts/runtime_flow.py
Environment variables:
-
AGENTRUN_ENDPOINT
-
ALICLOUD_ACCESS_KEY_ID
-
ALICLOUD_ACCESS_KEY_SECRET
-
AGENTRUN_RUNTIME_NAME
-
AGENTRUN_RUNTIME_ENDPOINT_NAME
-
AGENTRUN_RUNTIME_DESC (optional)
-
OUTPUT_DIR (optional)
Cleanup script
AGENTRUN_RUNTIME_ID="runtime-id" \ AGENTRUN_RUNTIME_ENDPOINT_ID="endpoint-id" \ python skills/compute/fc/alicloud-compute-fc-agentrun/scripts/cleanup_runtime.py
Environment variables:
-
AGENTRUN_ENDPOINT
-
ALICLOUD_ACCESS_KEY_ID
-
ALICLOUD_ACCESS_KEY_SECRET
-
AGENTRUN_RUNTIME_ID
-
AGENTRUN_RUNTIME_ENDPOINT_ID
-
OUTPUT_DIR (optional)
SDK Notes
See references/sdk.md for SDK acquisition guidance.
Output Policy
If you store any generated files or responses, write them under: output/compute-fc-agentrun/ .
Validation
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
Pass criteria: command exits 0 and output/alicloud-compute-fc-agentrun/validate.txt is generated.
Output And Evidence
-
Save artifacts, command outputs, and API response summaries under output/alicloud-compute-fc-agentrun/ .
-
Include key parameters (region/resource id/time range) in evidence files for reproducibility.
References
API overview and operation list: references/api_overview.md
Regional endpoints: references/endpoints.md
SDK guidance: references/sdk.md
Source list: references/sources.md