For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /docs/agent-and-computer/agent-variants.md.

Agent variants

A variant is created from an existing Agent and inherits it live: edits on the original Agent sync to the variant automatically, while the variant can still override individual settings and reset them to inherit at any time. Use one when the same Agent needs slightly different behavior in another Space or on another Computer.

  • Entry: two — Create variant in the ⋯ menu on an Agent's directory card, and Create variant next to Clone in the Agent's settings page. Hovering the entry shows a guide: a variant inherits all of the agent's settings; some of them (default Space, Computer, Runtime, prompt, Git repositories, working directory, and more) can be overridden on the variant, and the rest follow the original agent in real time.
  • Who can create: controlled by the original Agent's Advanced settings (who can create variants: Managers / Users, default Users); a variant cannot create further variants.
  • Naming: the default name is the original's name plus " variant" and can be edited; after creation you land on the variant's settings page.
  • Recognition: a variant's name carries a fork icon, and hovering it shows which original Agent it comes from.
  • Override and reset: in the variant's settings, fields inherited from the original carry an Inherited badge and sync automatically; fields with their own value carry an Overridden badge and offer Reset to inherit. Instructions, description, avatar, type, Runtime and model, execution Computer, visibility and Space, concurrency, and Git repositories can all be overridden.
  • Skills: live-synced from the original Agent and read-only on the variant.

When should you create a variant?

A variant solves the common question, “Can one Agent be used in more than one environment?” The original Agent keeps its own settings; each variant is an independent, assignable Agent and belongs to one Space. Common uses include:

  • Use the Agent in another Space: when one Agent cannot belong to multiple Spaces at once, create a variant and move the variant to the target Space. The original and the variant can then be assigned in their respective Spaces.
  • Run it on another Computer: override the execution Computer on a variant so the same responsibilities work with another Computer's code, credentials, or local tools.
  • Use multiple Runtimes: create variants for different Runtimes and override the Runtime while keeping the same role and Skills.
  • Use a different default model: override the model on a variant so it uses another model by default without changing the original Agent.
  • Test prompt changes safely: edit the variant's instructions to try a new prompt without changing what other people use on the original Agent.
  • Keep multiple execution setups: use separate variants for different Space, Computer, Runtime, or model combinations instead of repeatedly reconfiguring the original Agent.

After you edit a field on a variant, it is marked Overridden and later changes to that field on the original Agent no longer replace it. Use Reset to inherit when the variant should follow the original again. The default model, environment variables, custom parameters, and timeouts inside a Runtime are each independent: changing one does not affect the inheritance of the others, and resetting one does not reset the rest.

Use one Agent across multiple Spaces

A single Agent belongs to exactly one Space at a time, so the same Agent cannot be placed in several Spaces directly. To reuse one Agent setup across multiple Spaces:

  1. Keep the original Agent and create one variant for each additional Space;
  2. Override the variant's Space so it belongs to the target Space;
  3. The original and each variant are then assigned and used in their own Spaces.

Settings you have not overridden follow the original Agent live, so the role, instructions, and Skills stay maintained in one place on the original. When one Space needs slightly different behavior, override individual settings on that variant — they do not interfere with each other. See Override and reset above for the rules.

When you create an Agent or edit its settings, the Space picker's bottom shows "Want to use this Agent in multiple Spaces?". Hover it for the explanation and click "Learn more about variants" to come back to this page.