---
title: "Build your first graph"
type: HOW-TO
updated: 2026-09-23
---

# Build your first graph

Start with a built-in graph or a blank canvas, connect the steps, and validate the paths before running it.

Last updated 2026-09-23

## Create and connect

1. Open Graphs.
2. Open a built-in graph or choose New Graph.
3. Add the steps you need and configure each node.
4. Connect the success and failure paths.

A graph is the whole workflow. Use a loop only where steps need to repeat.

## Validate and run

1. Run graph validation and read each reported issue.
2. Fix missing paths or invalid connections.
3. Run the graph and inspect its progress.

A graph with a missing required failure path will not run. Validation does not prove that every tool or model action will succeed.

## Continue learning

- [Publish to the Marketplace](/docs/graphs/publish)

- [Run an agent on your repository](/docs/running-agents)