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

# Creating Agents

> Build intelligent agents with custom personality, tools, and knowledge.

Agents are the core of Dify. Each agent is a specialized AI assistant with its own personality, tools, knowledge base, and LLM model.

## Creating Your First Agent

Navigate to the **Agents** section in the sidebar and click **New Agent**.

### Basic Configuration

<ParamField body="name" type="string" required>
  A descriptive name for your agent (e.g., "Research Assistant", "Content Writer")
</ParamField>

<ParamField body="model" type="string" required>
  The LLM model to use. Options include GPT-4o, Claude Sonnet, Gemini Pro, and more.
</ParamField>

<ParamField body="description" type="string">
  A short description of what this agent does, visible in the agent list.
</ParamField>

## Personality (SOUL.md)

Every agent has a **SOUL.md** — a markdown document that defines its personality, behavior, and instructions. This is the most important part of your agent.

```markdown theme={null}
# Research Assistant

## Role
You are a thorough research assistant that finds, analyzes,
and summarizes information from multiple sources.

## Behavior
- Always cite your sources
- Present findings in structured format
- Ask clarifying questions when the request is ambiguous
- Use tables and lists for comparisons

## Tone
Professional but approachable. Clear and concise.
```

<Tip>
  Write your SOUL.md as if you're briefing a new team member. Be specific about behavior, tone, and output format.
</Tip>

## Adding Tools

Agents can use tools to interact with the real world. In the agent settings, select which tools are available:

* **Web Search** — Search the internet for current information
* **File Upload** — Process documents, images, and files
* **Browser** — Navigate and extract data from websites
* **Image Generation** — Create images with AI
* **YouTube** — Extract transcripts and analyze videos

See the [Tools guide](/guides/tools) for the full list.

## Adding Knowledge

Upload documents to give your agent specialized knowledge:

1. Go to the agent's **Knowledge** tab
2. Upload PDFs, text files, or markdown documents
3. The system automatically creates embeddings for semantic search
4. Your agent can now reference this knowledge in conversations

See the [Knowledge Base guide](/guides/knowledge-base) for details.

## Agent Templates

Use pre-built templates to quickly create agents for common use cases. See [Agent Templates](/guides/agent-templates).