Skip to main content
The build lifecycle tracks how an Agent Graph moves from active design to a frozen Agent Build running in a target environment.
A build is immutable once created. To ship graph or tool changes, create a new build and reassign deploy targets — do not edit an existing build snapshot.

​
Lifecycle stages

​
End-to-end workflow

  1. Design and Save the Agent Graph in Graph Studio.
  2. Click Build — confirm graph and tool versions (Builds overview).
  3. Configure Env. variables for DEV (Environments).
  4. Deploy or assign the build to DEV (Deploy).
  5. Run smoke tests — channel messages, trigger webhooks, or A2A TEST URL.
  6. Promote the same build assignment to UAT, then PROD, when stakeholders sign off.
  7. For A2A: promote Agent Card TEST → LIVE via Agent Cards.

​
Promotion rules

  • Channels and triggers: each integration exposes separate webhook URLs per environment. Update provider config when switching from DEV to PROD URLs.
  • A2A: only one LIVE build per Agent Graph per workspace. Push To Prod demotes the previous LIVE row to TEST.
  • Rollback: assign an older build row to the environment or promote a prior TEST A2A build to LIVE.
Production deploys may require Admin or SuperAdmin role depending on workspace policy. Validate in DEV and UAT first.