Common Build Failures - Phinite Docs

Build freezes an Agent Graph plus pinned tool versions into an immutable Agent Build. Failures usually mean missing publish steps or failing tests.

Frequent issues

Symptom	Likely cause
Build button disabled	Graph not Saved or validation errors on canvas
Unpublished tools listed	Tool lacks a published version in Dev Studio
Env export warnings	Missing env variables referenced by tools
Test failures	Tool test failed in target environment

Resolution checklist

Save the graph in Graph Studio; resolve canvas validation errors.
Publish all tools referenced on agent nodes (Tools & Dev Studio).
Run tool tests with realistic inputs in Dev/UAT (Custom tools — Test).
Add version notes for each changed tool.
Verify credentials per environment before rebuilding for Prod.

Builds capture graph + tool versions together. Fixing a tool requires a new publish and a new build before redeploy.