Getting Started

Quick Start: Build Your First Agent

Create and test your first basic Zirpa agent in a few practical steps.

Definition #

This quick start guides you through creating a minimal working agent and testing the runner flow.

Why it matters #

A successful first build gives immediate understanding of how paths, steps, and outcomes work together.

How it works #

  1. Create a new agent.
  2. Add one path and simple steps.
  3. Configure completion message.
  4. Run in test mode.
  5. Review result and iterate.

Configuration fields #

  • Agent name
  • Path name
  • Step types
  • Completion title/message
  • Test candidate details

Example scenario #

A user creates an agent with contact confirmation and one form step, then verifies completion in the runner.

Common mistakes #

  • Adding too many steps initially
  • Forgetting completion settings
  • Skipping test mode validation

Troubleshooting checklist #

  • Confirm step order
  • Validate required field settings
  • Check runner displays expected content
  • Verify completion screen appears correctly

Last updated Mar 28, 2026