glossary · Running it

Agent team

definition

An agent team is a named group of AI agents set up for one kind of work, where each member is either pinned to the revision the team was tested with or follows the agent's latest active revision.

in one line: Agents grouped for one job, pinned or following.

in context

Where does an agent team fit?

Teams pin what they tested. A save to an agent moves only the members that follow it.

Pinnedone revision, the default
Follows activemoves with the agent
On an environmentruns receive the team
Each member says which revision it means.
two ways to say it

What is an agent team, in plain words?

Same idea at two depths: the plain version, then what the engine actually does.

A review needs a reviewer, a tester and a security check. A team gives that set one name.

Pin what was tested. Follow what should always be newest.

for engineers

teams_manage add_member pins the active revision at add time; follow_active=True follows it.

agent_environments_manage team=<name>: every isolated run receives the team's members.

the longer answer

Why does an agent team matter?

Real work rarely needs one agent. A merge request review might want a reviewer, a tester and a security check, each with its own instructions and model. Grouping them as a team gives that set a name, a note on when to use it, and one place to change it.

The hard question is what happens when one member changes. Some teams must not change underneath the people relying on them: they were tested with a specific text. Others should always get the newest version. A team that records the choice per member makes the difference explicit instead of accidental.

in convops

How does an agent team work in ConvOps?

In ConvOps, a team holds members from the workspace agent catalog. Each member has a role hint, an optional alias, and a mode: pinned (the default, which pins the active revision at the moment it is added) or follow active. An environment can name a team, and every isolated run on that environment receives the team's members, plus any agent a workflow step names. A team that an environment uses cannot be deleted until the environment lets go of it.

questions

What do people ask about an agent team?

What is the difference between a pinned and a following team member?

A pinned member means one revision of the agent and keeps it when the agent changes. A following member means whatever revision is active now, so it moves with every save. In ConvOps a new member is pinned by default.

How does a run get a team?

In ConvOps an environment names a team, and every isolated run on that environment receives the team's members, plus any agent a workflow step names.