> ## 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? [#create-agent](#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**.

You can also start from a template. Open **Agents > Templates**, choose
**Use template**, preview the agent, then name the new agent and create it
in this workspace. The Agents list also shows a few popular marketplace
templates at the top.

A template copies the agent's instructions, model settings, and built-in
tools. MCP servers, sub-agents, and workflow tools are not copied. After
you create the agent, open the editor and reconnect those items for this
workspace.

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

## How do I save an agent as a template? [#save-agent-template](#save-agent-template)

Open the agent in the editor. Use the menu next to the agent name and choose **Save as template**. Enter a name and description. You can also submit a copy for the marketplace.

Templates are created from standalone agents only. After someone uses the template, they still need to reconnect MCP servers, sub-agents, and workflow tools in their own workspace.

## How do I delete a template? [#delete-agent-template](#delete-agent-template)

Open **Agents > Templates** and choose **Use template** on one of your account's
templates to open its preview. Choose **Delete**, then confirm. Anyone in your
account can delete your account's templates. Deleting can't be undone. Agents
you already created from the template keep working. If you submitted the
template to the marketplace, the published marketplace copy stays. Marketplace
templates from Fetch Hive and other authors can't be deleted.

## How do I configure an agent in the editor? [#configure-agent](#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**, **Workflow Catalog**, **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, xAI, Perplexity, and Moonshot (Kimi) 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**. Kimi K3 shows **Reasoning Effort** with `low`, `high`, and `max`. Kimi K2.5 and K2.6 show a thinking toggle. 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, Perplexity, and Kimi agents hide the control. Kimi agents cannot use remote MCP tools. They can use sub-agents and workflow tools. Add **Kimi Web Search** from the tool picker when you want web search.

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? [#add-mcp-tool](#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**
* **Kimi Web Search**
* **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. **Kimi Web Search** requires a Kimi model.

## How do I add a workflow tool? [#add-workflow-tool](#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](https://docs.fetchhive.com/agents/workflow-tools.md) for setup details and logging behavior.

## How do I remove a tool or archive an agent? [#remove-tool-or-archive-agent](#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](https://docs.fetchhive.com/agents/workflow-tools.md). For sub agents, see [Sub Agents](https://docs.fetchhive.com/agents/sub-agents.md). For testing, see [Testing with Chat](https://docs.fetchhive.com/agents/testing-with-chat.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.