What promotion means
Promoting an agent creates a team member record linked to that agent. The agent keeps its configuration — active version, Focuses, skills, assigned Actions — but also gains a seat on your organization team. It appears alongside humans on My Team and becomes eligible for work routed through Evolve. Think of it as hiring the agent: configuration in Agent Manager is the interview and onboarding; promotion is when they get a badge and a desk.Screenshot placeholder
Agent detail Overview or actions menu with Promote to team member (or similar). Show confirmation dialog: display name, optional email, team role.
Before you promote
Promotion is for finalized agents — not first drafts.What happens after promotion
Promoted agents participate in Evolve’s execution environment with the same instructions, linked context, and assigned Actions they had when promoted — enriched with whatever context Evolve supplies for each task.
Screenshot placeholder
My Team list with at least one agent-backed member (badge or type label “Agent”). Optional: same member assigned on an Evolve request detail panel.
Evolve tasks and requests
On Evolve, requests move from scoping through build and review. Promoted agent team members can:- Take assigned tasks on active requests
- Execute work using their Focus, skills, and assigned Actions
- Appear in team pickers when you staff a request
Demoting or deactivating
If an agent should stop receiving team work, deactivate the team member or remove promotion from Agent Manager (exact control depends on your workspace). The agent configuration remains in My Agents for future use; it simply no longer appears as an assignable teammate.Recommended path to promotion
- Build — create agent, prompt, Focus, linked context
- Extend — import and assign skills for specialized procedures
- Test — Lab and Chat Review until behavior is stable
- Activate — save and set the right active version
- Promote — add to team when ready for Evolve
- Monitor — Chat Review and Evolve request outcomes; iterate versions and skills
Where to go next
Versions & testing
Finalize before promotion.
Agent skills
Playbooks to assign before promoting.
Evolve
Where promoted agents take on tasks and requests.
Glossary
Definitions for team member agent and related terms.

