> ## 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.

# Creating and Configuring

> Create an agent, tune its settings, and add tools in the Fetch Hive editor

Create an agent from the **Agents** page, then tune its behavior in the editor.

## Overview

The **Agents** page shows your active agents and lets you start a new one with **Add Agent**. After you save, Fetch Hive opens the editor automatically. From there, you can adjust **Agent Settings**, add tools, test with **Chat**, and watch save state changes like **Editing...**, **Saving...**, and **Saved**.

## How do I create a new agent? <a href="#create-agent" id="create-agent" />

1. Open **Agents** from the sidebar.
2. Click **Add Agent**.

3) Enter a **Name** for the agent.
4) Choose a **Category** if your workspace uses categories.
5) Click **Save**.

Fetch Hive opens the agent editor as soon as the agent is created.

## How do I configure an agent in the editor? <a href="#configure-agent" id="configure-agent" />

1. In the editor, select the root agent node to open **Agent Settings**.

2) Update the fields you need, including **Name**, **Description**, **Model**, **Max Tokens**, **Temperature**, **Tool Choice**, **Max Tool Calls**, **Instruction Prompt**, and **Charge Type**.
3) Watch the save indicator in the header while your changes are written. Fetch Hive shows **Editing...** while you have unsaved changes, **Saving...** while it writes them, and **Saved** when the update completes.

Agents can use supported OpenAI, Anthropic, Google Gemini, and xAI models. Some settings change based on the selected model. For example, some models show **Reasoning Effort** or **Max Thinking Tokens** instead of **Temperature**. Gemini 2.5 thinking models and older Claude thinking models show **Max Thinking Tokens**. Gemini 3 Flash models show **Thinking Level** (`minimal`, `low`, `medium`, `high`). Newer adaptive Claude models, including Claude Sonnet 4.6+, Claude Opus 4.6+, Claude Opus 5, and Claude Fable 5, show **Reasoning Effort**. Claude agents also show **Prompt Cache**, with **Disabled**, **5 minutes**, and **1 hour** options for Anthropic prompt caching across repeated agent calls. **Max Tool Calls** appears for OpenAI and xAI agents only (`0` is unlimited): OpenAI sends it as provider `max_tool_calls`, and xAI sends it as `max_turns`. Anthropic, Gemini, and Perplexity agents hide the control.

If a saved agent uses a retired model, Fetch Hive shows a warning in **Agent Settings** and blocks chat/API runs with `model_deprecated`. Select an active model before testing or invoking the agent.

## How do I add an MCP tool? <a href="#add-mcp-tool" id="add-mcp-tool" />

1. Click the add-tool button in the editor header.
2. In the picker, use search if you need to filter the list.
3. Choose a tool from **MCP Tools**.

Fetch Hive currently shows these active MCP tools in the picker:

* **Auto Summarize**
* **SERP API**
* **Google Search**
* **Google Grounding**
* **Vector Search**
* **GPT Search**
* **xAI Web Search**
* **X Search**
* **Image Generation**
* **Airtable**
* **Linear**
* **Google Calendar**

Tools marked **Soon** are not available yet. If you add a tool, select its node to open the settings sheet for that tool. Some tools expose extra configuration, such as **Dataset** for **Vector Search**, **Context Size** and **Location Country** for **GPT Search**, **Allowed/Excluded Handles**, **Date Range**, and media understanding toggles for **X Search**, or an **Authentication** account for **Airtable** and **Linear**. **xAI Web Search** and **X Search** require an xAI Grok model. **Google Grounding** requires a Gemini model.

## How do I add a workflow tool? <a href="#add-workflow-tool" id="add-workflow-tool" />

Choose a deployed workflow from **Workflow Tools** in the tool picker. Fetch Hive lets the agent call the selected workflow endpoint variant as a tool. The workflow run keeps its own workflow request ID and logs, and the parent agent trace records the call under `agent.tool.workflow`.

See [Workflow Tools](./workflow-tools) for setup details and logging behavior.

## How do I remove a tool or archive an agent? <a href="#remove-tool-or-archive-agent" id="remove-tool-or-archive-agent" />

To remove an MCP tool, hover over its node in the editor and click the remove action. Fetch Hive asks you to confirm with **Remove tool?** and **Remove tool**.

To archive an agent, open the menu next to the agent name in the editor and choose **Archive**. Fetch Hive asks you to confirm with **Archive agent?** and **Archive agent**.

Archiving removes the agent from the active **Agents** list. For workflow tools, see [Workflow Tools](./workflow-tools). For sub agents, see [Sub Agents](./sub-agents). For testing, see [Testing with Chat](./testing-with-chat).