Product docs

Governed Automation

Console Bots

Shape bounded ArchiBot tasks in chat, review the task packet, and (for operators) set the bot policy, profiles and blueprints that decide when bots may run.

Customer adminsPlatform operators

Last updated

Bots on the Task chat tab with the Task packet view: team, profile and source fields and the Overview, Source, Product and QA & save tabs, on safe example data.
Safe example data: the Task packet collects what the bot task needs before you save the draft.

Bots (/bots) turns a bounded, well-described change into ArchiBot work: “Create bounded ArchiBot work that ends in a Console merge event, review, QA, and human approval before anything can merge.” A bot task records the repository and branch, the paths the bot may touch, and the QA notes that prove the change.

Saving a task never merges code. Until execution is enabled for the team, a Setup only badge shows and tasks are reviewable records only. With Workspace handoff enabled, Console still checks the policy, profile, blueprint, concurrent-run limit and monthly budget before any workspace starts.

Who can see it

  • Team admins draft and manage bot work for their team.
  • Platform operators and platform admins do the same for any team, and manage the Bot policy, Bot profiles and Blueprints that gate execution.
  • Team members don’t see Bots. Ask a team admin to draft the task.

The tabs

TabWhat it holds
Task chatThe chat builder and the task packet for the draft.
Bot tasksDrafted and finished tasks with their review, QA, logs and approval state.
Run historyRun requests, with their runner, activity and sanitized logs.
Bot policyThe team switch and the limits that gate execution.
Bot profilesProfiles that set the worker template, reasoning and limits.
BlueprintsThe fixed workflow templates and whether each is enabled for the team.

Shape a task in chat

  1. Choose New bot task, or stay on Task chat → Chat with ArchiBot.
  2. Describe what needs to change, what counts as done and how QA should prove it. Starters help: Acceptance criteria, QA plan, Add evidence and Narrow scope.
  3. Type in Message ArchiBot and send. Each reply updates the QA notes and may suggest a title or scope.
  4. Open Task packet to see what was captured: the team, profile and source, then the Overview, Source (Repository, base branch, Path scope), optional Product (Add dependent product repository) and QA & save tabs.
  5. Choose Save draft (setup-only teams) or Start bot (handoff enabled). It stays disabled until the title and required fields are set. Operators choose the team first.

Keep tasks specific. “Add a field to Space Console” with acceptance criteria works. “Fix the app” doesn’t.

Task packet with team, profile and source cards above the Overview, Source, Product and QA & save tabs, on safe example data.

Bot tasks and runs

Bot tasks lists every task. Cancelling a task keeps its audit record and sets it to canceled rather than deleting it.

Run history lists run requests, with Run detail showing the mode, branch, runner job, activity timeline and sanitized logs. When a merge event exists, Open merge request links to it. A person approves and merges in CI & Review.

Bot policy (operators)

Bot policy decides whether a team can run bots, and shows Team enabled or disabled:

  1. Allow bot runs for this team. The platform switch and run orchestrator must also be on.
  2. The default profile and workspace target for new runs.
  3. The monthly bot budget and concurrent runs, with presets.
  4. Log and artifact retention, workspace cleanup after runs, and artifact handling (for example, archiving to Shared Drive).
  5. The blueprints this team may use.

Choose Save policy.

Bot profiles (operators)

On Bot profiles, choose the team, then New profile. Set the name, the blueprint and a description of what it may change. Turn on Make this profile selectable, then set the workspace target, template, reasoning effort, runtime cap, budget, concurrent runs and tool allowlist. Choose Save profile.

Blueprints (operators)

Blueprints lists the fixed workflows (managed feature, fix and docs), each with its review model, QA step, runtime cap and file budget. Enable for team / Disable for team controls which ones the team may use. Enabling a blueprint doesn’t start any work.

On a phone

  • The six tabs scroll sideways, and every control has a full-size tap target.
  • Save policy and Save profile stay pinned to the bottom of the screen while you edit.
  • In Task packet, the QA & save row with Save draft stays pinned to the bottom of the screen while it is on screen.
  • Day and number presets are full-size buttons.

Bot policy on a phone: the sideways-scrolling Bots tabs and the Allow bot runs for this team setting with Save policy pinned at the bottom, on safe example data.

Safe content

Never put passwords, API keys, cookies, invitation links, webhook secrets, repository tokens, database URLs, raw logs or customer data in a task, QA note, profile or blueprint. Repository URLs, branch names, issue references, path scopes and visible Console errors are fine.

Done When

  • The task title, repository, branch, path scope and QA notes contain no secrets.
  • Bot execution is enabled by team policy and ISM before you expect a workspace or merge event.
  • A person still approves and merges from CI & Review.