Skip to content

Create a Visible Agent

Create a named visible agent under an existing installation so activity, assignees, and attribution can point to a meaningful product actor.

Best for Workspace manager Updated April 3, 2026
CLI In this interface
4 steps Steps
3 interfaces Available in
Use this path when

The CLI create command can also immediately set the newly created visible agent as the active linked agent for the current profile.

What you'll finish here
  • Start from the correct installation.
  • Capture the returned profile id.
  • Choose the right team scope and role.

Where this happens

LabelValueNotes
Command./backlog.sh admin agents create [options]Creates a visible agent.

Same Task, Other Interfaces

Use the version that matches where you are working now. The subject matter stays the same; the delivery changes by surface.

Do the work

  1. 1. Run the create command with `--installation-id` and `--name` first.
  2. 2. Add repeated `--team-id` flags and `--role member` or `--role commentator` as needed.
  3. 3. Add `--use` if the current CLI profile should immediately adopt the new visible agent id.
  4. 4. Record the returned `profileId` for future automation-backed requests.

Keep Going in Automation and Agents

Stay in the same interface and move to the next closest task in this topic when needed.

Nearby Guides

These guides stay close to the current workflow so you can keep moving without restarting discovery.