Create a Graph
Create your first agent graph, manage metadata, and work with versions in Agent Playground.
About
Create a new graph to start building your AI workflow. A graph is the container for your entire pipeline. For background on what graphs are, see Understanding Agent Playground.
Create a New Graph
Navigate to Agent Playground
Go to Agent Playground from the main navigation. You will see the agent list view showing all your existing graphs.
Create the graph
Click Create Agent in the top-right corner. The platform creates a new graph with a blank draft version and takes you directly to the builder canvas.
Set graph metadata
Give your graph a meaningful name and description.
Manage Versions
Agent Playground uses a version system to track changes and let you roll back safely. Every graph starts with a draft version.
View Versions
Switch to the Changelog tab to see all versions of your graph. The left sidebar lists every version with its status and creation date. Click a version to preview its workflow structure in read-only mode on the right panel.
Activate a Draft
When your draft is ready for use:
- Click Save
The platform validates the graph (checking for cycles, missing connections, and incomplete configurations). If validation passes, the draft is saved and becomes the version that runs when you execute the graph. The previous version is kept in your version history.
Create a Draft from a Previous Version
To iterate on an older version:
- Open the Changelog tab
- Select any previous version
- Click Create Draft
This creates a new draft that is a copy of that version’s workflow structure. You can then modify it freely without affecting the saved version.
Edit a Non-Draft Version
If you try to edit a node while viewing a non-draft version, the platform prompts you to create a draft first. Your edits go into the new draft, leaving the saved version unchanged until you explicitly save the draft.
Next Steps
- Build a Workflow: Add nodes, configure them, and connect them into a pipeline
- Run & Monitor: Execute your workflow and inspect results