Skip to main content
A Build is an immutable snapshot of your Agent Graph and pinned tool versions — the artifact you assign to environments and deploy to channels, triggers, or A2A.

Build lifecycle

Draft → validated → published → deployed.

Publishing

Publish tools and graph versions before building.

Environments

DEV, UAT, and PROD assignment.

Deploy

Channel, Chat API, trigger, or A2A targets.

​
What is a build?

Build form with graph and tool version pins

Build dialog — confirm Agent Graph version and pinned tools

​
Create a build

  1. In Graph Studio, Save the graph.
  2. Click Build on the toolbar.
  3. Wait while Phinite validates the graph and packages tool versions.
  4. Add a Description.
  5. Confirm Agent Graph version and Tools — click Publish on any unpublished tool.
  6. Click Create Build.
Builds appear under Studio sidebar → Agent Builds.
Build stays disabled until the graph is saved. Unpublished tools block build creation until you publish them from Dev Studio.

​
Build lifecycle

See Build lifecycle for detailed transitions.

​
Assign to environments

  1. Open Agent Builds in Graph Studio sidebar or the build list.
  2. Select a build and open the Assign environment drawer.
  3. Choose DEV, UAT, or PROD.
  4. Confirm — the build becomes active for that environment.
Each environment reads its own env variables and integration credentials at runtime.
Promote builds DEV → UAT → PROD after testing. Never edit a deployed build — create a new build from an updated graph instead.

​
Builds vs Agent Cards

Agent Cards reference a build when you Expose as A2A. See Agent Cards & builds.