Worker Management (for Administrators)
Overview
A worker is the execution environment where the AI runs jobs (agents). Administrators register workers, control access to them, and check that they are running.
Worker-related administration is split across two places.
| Location | Contents |
|---|---|
| Gear icon → "Workers & Skills" | Listing, registering, and editing workers themselves (covered on this page) |
| Gear icon → "Settings" → "Worker Usage" | Operational policies such as usage quotas, alerts, and cost approvals (preview feature) |
Note: This feature is available to organization administrators only.
Worker List
Select the gear icon in the header → "Workers & Skills" to open the worker management screen.
List Columns
| Column | Description |
|---|---|
| Name | Identifier name of the worker |
| Description | Description of the worker |
| Access Control | "Everyone" or the groups granted access |
| Status | "Active" / "Inactive". Click the badge to toggle it immediately |
| Updated At | Last updated date and time |
| Actions | Edit / Delete |
Registering a Worker
Registering via Auto-Discovery (Recommended)
You can scan for running, unregistered workers and register them with a single click.
- In the "Worker Auto-Discovery" panel on the worker management screen, click "Scan Workers"
- Scan results are displayed grouped into "Registered", "Unregistered", and "Unreachable"
- Each worker shows a status of "Running" or "Health check failed"
- Click "Register" on an unregistered worker
If no workers are found, check that the worker-side service (worker-api) is running.
Registering Manually
- Click the "Create New" button
- Enter the worker name and other information, and configure the following as needed:
- Enable: Whether to make the worker available for use
- Allow skill deployment: Whether commands created in skill development can be deployed to this worker
- Allowed Groups: Only members of the checked groups can use the worker. If none are selected, everyone has access
- Click "Create"
Editing and Deleting a Worker
- Edit: Use the edit button in the list to change the same fields as during registration
- Delete: Confirm the deletion in the confirmation dialog
Note: Deleting a worker cannot be undone. All settings related to the worker are also deleted. Before deleting or deactivating, check the impact on the jobs (agents) tied to that worker.
Quotas & Alerts (Preview Feature)
The "Worker Usage" category of the settings modal lets you configure operational policies for workers. It appears when you enable "Cost management" under "Organization & Features" → "Preview Releases".
Quotas & Alerts
Manage limits on worker execution counts and credit consumption, plus notifications when they are exceeded.
- Quotas: Define limits by target (user / group / organization) × resource (concurrent workers / executions / credit consumption) × period (monthly / daily / cumulative)
- Alerts: Configure notification destinations (Slack / Email / Webhook) for when a threshold is exceeded
Cost Approvals
Manage monthly cost estimates for worker templates through a two-person approval flow.
- Requests show a status of "Pending", "Approved", "Rejected", or "Superseded"
- Decide with "Approve" or "Reject" (a rejection reason is required)
- The requester and the approver must be different administrators
Relationship with Jobs (Agents)
- Jobs are created tied to a specific worker
- The commands a job uses are provided by the worker it is tied to
- If a worker is inactive or stopped, jobs tied to that worker cannot run