AgentKit Studio
Reference

Deployment state machine

The 19 deployment states, 9 polled and 7 requiring attention, with UI labels and source locations.

State sets

The deployment state machine has 19 states in two sets: 9 polled and 7 requiring attention. The sets may overlap.

StateUI labelPolledAttentionSource
PREPARED待提交——src/client/state/deployment.mjs:1
UPLOADING上传运行包——src/client/state/deployment.mjs:1
UPLOAD_UNKNOWN上传结果待核对—⚠️src/client/state/deployment.mjs:1
UPLOADED已上传——src/client/state/deployment.mjs:1
CREATING创建中——src/client/state/deployment.mjs:1
CREATE_UNKNOWN创建结果待核对—⚠️src/client/state/deployment.mjs:1
PROVISIONING准备实例✅—src/client/state/deployment.mjs:1
CONFIGURING配置访问令牌✅—src/client/state/deployment.mjs:1
TOKEN_PENDING等待配置生效✅⚠️src/client/state/deployment.mjs:1
STARTING启动中✅—src/client/state/deployment.mjs:1
UPDATING切换版本 · 等待入口确认✅—src/client/state/deployment.mjs:1
UPDATE_UNKNOWN更新结果待核对✅⚠️src/client/state/deployment.mjs:1
READY就绪——src/client/state/deployment.mjs:1
AVAILABLE_UPDATING入口可用 · 平台更新中✅—src/client/state/deployment.mjs:1
ACTION_REQUIRED需要处理—⚠️src/client/state/deployment.mjs:1
FAILED失败—⚠️src/client/state/deployment.mjs:1
DELETING删除中✅—src/client/state/deployment.mjs:1
DELETE_UNKNOWN删除结果待核对✅⚠️src/client/state/deployment.mjs:1
DELETED已删除——src/client/state/deployment.mjs:1

"Polled" means the client keeps refreshing; "attention" means the UI must offer an action instead of spinning. UI labels are the product's own Chinese copy and are kept verbatim.

All three constants are single-line definitions in src/client/state/deployment.mjs: DEPLOYMENT_LABELS (line 1), DEPLOYMENT_POLL_STATES (line 3) and DEPLOYMENT_ATTENTION_STATES (line 5), which is why every Source cell points at the same place.

Polled states

These states mean the platform is still working; the client may safely keep polling:

StateUI label
UPDATING切换版本 · 等待入口确认
UPDATE_UNKNOWN更新结果待核对
PROVISIONING准备实例
CONFIGURING配置访问令牌
TOKEN_PENDING等待配置生效
STARTING启动中
AVAILABLE_UPDATING入口可用 · 平台更新中
DELETING删除中
DELETE_UNKNOWN删除结果待核对

Attention states

These states mean the outcome is unknown or needs a human; more polling will not change them:

StateUI label
CREATE_UNKNOWN创建结果待核对
UPLOAD_UNKNOWN上传结果待核对
UPDATE_UNKNOWN更新结果待核对
DELETE_UNKNOWN删除结果待核对
ACTION_REQUIRED需要处理
FAILED失败
TOKEN_PENDING等待配置生效

Unknown is not failed

A *_UNKNOWN state means the last request has an unknown outcome. Reconcile against the cloud side before retrying or rolling back; a blind retry can create a second resource.

Happy path

PREPARED → UPLOADING → UPLOADED → CREATING → PROVISIONING → CONFIGURING
        → TOKEN_PENDING → STARTING → READY
READY → UPDATING → AVAILABLE_UPDATING → READY
any state → FAILED | ACTION_REQUIRED
any state → DELETING → DELETED

Only two branches leave the happy path: failure and deletion. Every *_UNKNOWN state is an interrupted step on the happy path, not a separate branch.

Version and compatibility

ItemValueNotes
States19A new state must land here and in the client
Polled states9DEPLOYMENT_POLL_STATES
Attention states7DEPLOYMENT_ATTENTION_STATES
UI labelsHardcoded Chinese copySee src/client/state/deployment.mjs

Developer entry points

ItemSource
Deployment statessrc/client/state/deployment.mjs
Deployment clientsrc/studio-deployments.mjs
Deployment versionssrc/deployment-versions.mjs
Deployment rolloutssrc/deployment-rollouts.mjs

Related tests:

Test fileLocation
studio-deployments.test.mjstests/studio-deployments.test.mjs

On this page