> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hive Agent Quick Start

> Create a Hive Agent, configure budget guardrails, start a run, and inspect the result

By the end of this guide, you'll have a Hive Agent run that plans an objective, executes nodes, verifies output, and shows its result in logs.

## Prerequisites

* A Fetch Hive account ([sign up here](https://app.fetchhive.com))
* An active workspace **Default** API key - see [API Keys](../workspace/api-keys)

You can start Hive Agent runs from the dashboard or with the async public API. This quick start uses the dashboard flow first, then links to code invocation.

## Step 1: Create a Hive Agent

Open **Hive Agents** in the sidebar.

Click **New Agent Task**.

Rename the new Hive Agent from the breadcrumb menu.

## Step 2: Review the stage agents

Click **PLAN**, **EXECUTE**, and **VERIFY** on the canvas.

Confirm the model and runtime settings for each stage. Keep the defaults for your first run unless you already know a stage needs a different model.

## Step 3: Add executor tools

Click **EXECUTE**.

Use **Add Tool** to attach any tools the run needs, such as search, file, or integration tools.

Skip this step for a simple objective that the model can answer without tools.

## Step 4: Set budget guardrails

Click the dollar button in the editor header.

Set a **Budget Hint (USD)**, a **Budget Cap (USD)**, and **Budget Strictness**.

Keep **Max Concurrent Nodes** low for your first run if you want spending to be easier to watch.

## Step 5: Start a run

Click **Start Run**.

Enter a specific **Run objective**.

Add a **Website**, **File Upload**, **Knowledge Base**, or **Knowledge Base Item** source if the run needs grounding.

Click **Start Run**.

## Step 6: Open logs

Open **Hive Agents** > **Logs**.

Find the run by Hive Agent name, objective, status, or request ID.

Click the row to open the detail sheet.

## Step 7: Read the result

Review the final response, source list, node overview, budget ledger, and trace.

If a node was rejected, read the rejection reason and tune the matching stage before starting another run.

## Next steps

* [Creating and Configuring](../hive-agents/creating-and-configuring)
* [Running Tasks](../hive-agents/running-tasks)
* [Invoke from Code](../hive-agents/invoke-from-code)
* [Logs](../hive-agents/logs)
* [Budget Approval](../hive-agents/budget-approval)
