Skip to main content
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

string
required
A descriptive name for your agent (e.g., “Research Assistant”, “Content Writer”)
string
required
The LLM model to use. Options include GPT-4o, Claude Sonnet, Gemini Pro, and more.
string
A short description of what this agent does, visible in the agent list.

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.
Write your SOUL.md as if you’re briefing a new team member. Be specific about behavior, tone, and output format.

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 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 for details.

Agent Templates

Use pre-built templates to quickly create agents for common use cases. See Agent Templates.