Skip to main content
By the end of this guide, you’ll have an agent configured in the dashboard, tested in chat, and ready to call through the public API.

​
Prerequisites

  • A Fetch Hive workspace
  • A workspace API key if you want to run the public cURL example - see API Keys

​
Step 1: Create an agent

Open Agents in the sidebar, then click Add Agent. Enter a Name. If your workspace uses categories, you can also choose a Category. Click Save to open the agent editor. The first time you open the agent editor, a short walkthrough highlights the agent card, settings, and toolbar.

​
Step 2: Configure the root agent

In the editor, click the root agent node to open Agent Settings. Add a short Instruction Prompt that tells the agent what to do. You can also confirm the Model, but you can keep the default settings for this first pass. For example:

​
Step 3: Test the agent in chat

Click Chat in the editor header. Send a short test message in the chat panel and confirm that the agent responds the way you expect. This chat panel is for dashboard testing. The UI explicitly says these messages are not saved, so treat it as a safe place to iterate on behavior before you wire the agent into your app.

​
Step 4: Copy the public invoke snippet

Open Get Code in the editor control bar, or use More in the sidebar and click Get Code. Select your Agent and API Key. The dialog shows the public invoke snippet for POST /v1/agent/invoke. Use the Agent Prompt tab to copy a ready-to-paste instruction block for a coding agent such as Cursor or Claude Code. It tells the agent to add a call to this agent using the official Fetch Hive SDK for your project’s language.
Replace YOUR_API_KEY and YOUR_AGENT_ID with your real values. The in-app Chat panel uses a private dashboard testing flow. The snippet above is the public API flow you use outside the dashboard.

​
Next steps