# Creating and Configuring

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 MCP 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"></a>

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"></a>

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.

Some settings change based on the selected model. For example, some models show **Reasoning Effort** or **Max Thinking Tokens** instead of **Temperature**.

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

1. Click the button with the tooltip **Add MCP Tool or Sub Agent** in the editor header.
2. In the picker, use **Search tools and agents...** 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:

* **SERP API**
* **Google Search**
* **Vector Search**
* **GPT Search**

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** or **Context Size** and **Location Country** for **GPT Search**.

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

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 sub agents, see [Sub Agents](https://docs.fetchhive.com/agents/sub-agents). For testing, see [Testing with Chat](https://docs.fetchhive.com/agents/testing-with-chat).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fetchhive.com/agents/creating-and-configuring.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
