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

# Creating an Agent

> Step-by-step guide to creating a new AI agent.

# Creating an Agent

Create a new AI agent in Neural Factory. You'll need an **Admin** role.

## Step-by-step

<Steps>
  <Step title="Open the Agents page">
    Navigate to **Agents** in the sidebar. You'll see a list of all agents in your organization.
  </Step>

  <Step title="Click Create Agent">
    Click the **Create Agent** button in the top right. This opens the agent configuration form.
  </Step>

  <Step title="Set basic information">
    Fill in the required fields:

    * **Name** — A clear, descriptive name (e.g., "HR Policy Assistant", "Engineering Docs Bot")
    * **Description** — A brief summary of what the agent does, shown to users in the agent picker
  </Step>

  <Step title="Write the system prompt">
    The system prompt is the most important configuration. It tells the agent who it is, how to behave, and what to do. Write clear instructions covering:

    * The agent's role and expertise area
    * Tone and communication style
    * What the agent should and shouldn't do
    * How to handle questions outside its scope

    **Example:**

    ```
    You are the HR Policy Assistant for Acme Corp. Your job is to help 
    employees find answers about company policies, benefits, and procedures.

    Always cite the specific policy document when answering. If you don't 
    find relevant information in the knowledge base, say so clearly rather 
    than guessing. Be professional but friendly.
    ```
  </Step>

  <Step title="Select a model">
    Choose the AI model that powers the agent. Different models have different capabilities:

    * **GPT-4o / GPT-4.1** — Strong general-purpose models, good balance of quality and speed
    * **o-series** — Advanced reasoning models for complex analytical tasks
    * **Claude** — Alternative models with different strengths

    Your administrator may have specific models available based on your organization's configuration.
  </Step>

  <Step title="Connect knowledge bases">
    Select one or more knowledge bases for the agent to search. The agent will retrieve relevant documents from these knowledge bases when answering questions.
  </Step>

  <Step title="Enable tools">
    Choose which tools the agent can use:

    * **Knowledge search** — Search connected knowledge bases (enabled by default)
    * **Web search** — Search the internet for current information
    * **Code execution** — Run code in a sandboxed environment
    * **External integrations** — Connect to Jira, Confluence, Outlook, etc.

    See [Built-in Tools](/user-guide/toolkits/built-in-tools) for details on each tool.
  </Step>

  <Step title="Save the agent">
    Click **Save** to create the agent. It will immediately appear in the agent list and be available for users to chat with (subject to access control settings).
  </Step>
</Steps>

## What's next

After creating the agent, you may want to:

* [Configure advanced settings](/user-guide/agents/configuring-agents) like strict mode or custom error messages
* [Set up access control](/user-guide/agents/agent-access-control) to restrict who can use the agent
* Test the agent by starting a conversation from the chat interface