> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seekr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an agent

> Build a new agent with models and tools in the SeekrFlow UI.

This guide walks through creating an agent in the SeekrFlow UI.

## Before you begin

* Decide which model to use – see [Models](/flow/components/agents/models) for guidance on base models and fine-tuned deployments.
* If using file search, create a vector store first – see [Create a vector store](/flow/app/vector-stores).

## Create the agent

<Steps>
  <Step>
    Navigate to **Agent Builder > Agents** in the sidebar.
  </Step>

  <Step>
    Click **Create Agent**.
  </Step>

  <Step>
    Enter the agent details:

    * **Name** – A unique identifier for the agent
    * **Instructions** – The system prompt that defines how the agent responds. Be specific about the task, expected behavior, and any constraints.
    * **Reasoning mode** – Choose based on your use case:
      * **Speed-optimized** – For straightforward tasks requiring quick responses
      * **Performance-optimized** – For complex tasks requiring deeper analysis

    For more on reasoning modes, see [Agents](/flow/components/agents).
  </Step>

  <Step>
    Select a model:

    * **Base models** – Pre-trained models hosted on the SeekrFlow platform
    * **Deployments** – Your fine-tuned models (must have an active deployment)
  </Step>

  <Step>
    Configure tools (optional). For available tools, see [Tools](/flow/components/agents/tools). For each tool, provide **tool instructions** that tell the agent when to use it.

    If adding file search:

    a. Select a **vector store** containing your documents.<br /><br />
    b. Set **Top K** – Number of results to retrieve (5–10 for precision, 20–50 for broader coverage).<br /><br />
    c. Set **Score threshold** – Minimum similarity score (0.7–0.9 for strict relevance, 0.2–0.5 for exploratory searches).
  </Step>

  <Step>
    Review your configuration and click **Create Agent**. The agent appears in your agents list with a **Pending** status while SeekrFlow provisions it. After a few minutes, the status changes to **Active** and the agent is ready to use.
  </Step>
</Steps>

## Next steps

* [Manage agents](/flow/app/manage-agents) – Activate, deactivate, or modify agents
* [Chat with an agent](/flow/app/chat-with-an-agent) – Test your agent in Agent Chat