<span id="执行器"></span>

# Runners

Choose an API for the resource you need to operate on, then prepare the identity, IDs, and parameters listed on its action page.

<span id="选择任务"></span>

## Choose a task

| Task | Page | Description |
| --- | --- | --- |
| Get compute instance Python dependency observations | [Get compute instance Python dependency observations](compute-workers.md) | Return saved observations for the current desired SHA, cloud provider, and instance states STARTING/READY/STOPPING. This is not a list of all Workers or live Pods. |
| Register a custom Runner | [Register a custom Runner](create-runner.md) | HTTP 200 means record and ownership creation completed. phase=pending does not mean Edge is connected. |
| Unregister a Runner | [Unregister a Runner](delete-runner.md) | Deregistration involves blocking new invocations, cleaning associated native sessions, revoking tokens, and deleting ownership and records. |
| Get visible executor connection states | [Get visible executor connection states](executor-health.md) | Return connection projections for currently visible Runners and enabled Sandboxes. |
| Get Runner details | [Get Runner details](get-runner.md) | Read records and token expiration without issuing new credentials or retrieving historical connect_cmd. |
| Runner connectivity and observation lifecycle | [Runner connectivity and observation lifecycle](lifecycle.md) | Successful registration, Edge connection, execution admission, and compute dependency installation each have independent states. Each step needs its own decision criteria. |
| List Runners | [List Runners](list-runners.md) | Return Runners readable in the current workspace with internal lifecycle active, sorted by creation time descending, without filtering by registering user. |
| Runner and compute observation objects | [Runner and compute observation objects](objects.md) | These APIs distinguish product-identity management, connectivity, Edge-holder renewal, and compute dependency observations. |
| Get Python dependency configuration limits | [Get Python dependency configuration limits](py-deps-limits.md) | Read dynamic deployment configuration for enabled status, size/line limits, index domains, and installation timeout. This is not specific to a compute instance and does not modify global configuration. |
| Refresh Runner connection credentials | [Refresh Runner connection credentials](refresh-runner.md) | Use agent_runner.manage to revoke the old JTI, update the current binding, and return a new connect_cmd while retaining Runner and Edge IDs. |
| Renew an Edge registration token | [Renew an Edge registration token](renew-edge-token.md) | Holder protocol, without product identity wrapping. |

```{toctree}
:hidden:
:maxdepth: 1

Get compute instance Python dependency observations <compute-workers>
Register a custom Runner <create-runner>
Unregister a Runner <delete-runner>
Get visible executor connection states <executor-health>
Get Runner details <get-runner>
Runner connectivity and observation lifecycle <lifecycle>
List Runners <list-runners>
Runner and compute observation objects <objects>
Get Python dependency configuration limits <py-deps-limits>
Refresh Runner connection credentials <refresh-runner>
Renew an Edge registration token <renew-edge-token>
```
