Resources / Swarm

Swarm

A swarm of platform agents with fixed roles (triage, investigator, fixer, reviewer, librarian) that keeps the platform healthy above the automatic remediation: they read the platform, hand work to each other and propose actions; the platform's own remediation carries them out. Only in the platform's agents project. Starts in plan mode.

Overview

APIintelligence.etorm.com/v1alpha1
Resourceswarms (cluster-scoped inside its cluster)
Short namesswarm
Available inproject clusters only
Statuswritten by a controller through /status

Minimal example

apiVersion: intelligence.etorm.com/v1alpha1
kind: Swarm
metadata:
  name: example
spec:
  endpointRef:
    name: "<name>"
  embeddingEndpointRef:
    name: "<name>"

Spec

FieldTypeRequiredDefaultAllowedDescription
endpointRefreference to InferenceEndpointyesThe chat endpoint (the model) all agents of the swarm think with.
embeddingEndpointRefreference to InferenceEndpointyesThe embedding endpoint the swarm's memories use.
roleslist of string["triage","investigator"]up to 9 itemsWhich roles the swarm has. The default is the read-only start: triage and investigator only, which change nothing on the platform. Add fixer to let the swarm propose actions, reviewer to verify and write postmortems, librarian to tidy the memory.
statestring (one of)"Running"Running, Paused, StoppedThe kill switch: Stopped ends every agent of the swarm at once; Paused keeps their place and calls nothing.
applybooleanfalsefalse is plan mode: the platform's remediation records what the swarm's proposals would do and does nothing. Set true only by a person, after reading the plans.
changeRepositorieslist of objectup to 5 itemsThe repositories the automation roles (gatekeeper, maintainer, scribe, chronicler) may propose changes to, and read. Only a person sets this; without it those roles can read nothing of any repository and propose nothing.
changeRepositories[].clusterstringyeslength 1 to 63The project that holds the Repository.
changeRepositories[].namestringyeslength 1 to 63Name of the Repository.
changeRepositories[].branchstring"main"up to 100 charactersThe branch changes are proposed against.
changeApplylist of stringup to 4 itemsThe kinds of change proposal that are applied (a branch, a change request and a ticket are made). A kind not listed stays a recorded plan, whatever apply says (apply is for remediation proposals). Only a person sets this; the default is none.
ticketBoardobjectWhere the automation roles' tickets are made (Forge cards). Only a person sets this. Without it a change proposal opens only the change request.
ticketBoard.clusterstringyeslength 1 to 63The project that holds the Board.
ticketBoard.namestringyeslength 1 to 63Name of the Board.
ticketBoard.columnstringyeslength 1 to 63The column new cards go to.
budgetobject{}Limits of the whole swarm.
budget.tokensPerDayinteger4000001000 to 50000000Model tokens per UTC day for the whole swarm, split between the roles.
preAuthoriselist of stringup to 10 itemsActions the swarm may run without a person's approval each time (high-risk ones included). Only a person sets this.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringPending, Running, Paused, Stopped or Degraded.
roleslist of objectOne entry per role.
roles[].rolestringtriage, investigator, fixer, reviewer or librarian.
roles[].agentstringThe agent of the role.
roles[].phasestringThe agent's phase.
usageobjectWhat the swarm's agents used, summed.
usage.tokensTodayintegerTokens on the day of the agents' counters.
usage.actionsintegerAPI calls in all.
usage.refusedintegerCalls refused in all.
openHandoffsintegerHandoffs not yet done.
proposalsobjectProposals by phase.
conditionslist of objectDetailed state; Ready says whether the swarm is working.
conditions[].typestringAspect.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.

Columns in listings

ColumnFrom
State.spec.state
Apply.spec.apply
Handoffs.status.openHandoffs
Phase.status.phase
Detail.status.conditions[0].message

All resources