Skip to main content
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

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. The first time you open the Hive Agent editor, a short walkthrough highlights the stages, toolbar, budget and notification settings, and how to start a run. 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 control bar. 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

Click Logs in the editor control bar, or 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 the objective asked for a spreadsheet or document, downloadable files appear with the final output when the run completes successfully. If a node was rejected, read the rejection reason and tune the matching stage before starting another run.

​
Next steps