Building Your First Agent
Every Sophon installation starts with a default agent. But the real power comes when you create specialized agents for different tasks.
What is an Agent?
An agent in Sophon is a configured personality backed by an LLM. Each agent has:
- SOUL.md — Personality definition (tone, behavior, knowledge)
- Model configuration — Which LLM to use
- Skills — Which tools are available
- Memory — Agent-scoped memory space
Creating an Agent
Via Chat
The simplest way is to ask your existing agent:
> "Create a new agent called 'code-reviewer' that specializes in reviewing code. It should be thorough, point out potential bugs, and suggest improvements."
Sophon creates the agent with an appropriate SOUL.md and enables relevant skills.
Via Dashboard
1. Navigate to Agents
2. Click Create Agent
3. Fill in the name and description
4. Edit the SOUL.md
5. Select which skills to enable
6. Choose the preferred model
Via CLI
sophon agents create code-reviewer
Then edit ~/.sophon/agents/code-reviewer/SOUL.md to customize the personality.
SOUL.md Best Practices
Keep your SOUL.md focused and specific:
Code Reviewer
You are a meticulous code reviewer. Your job is to find bugs, suggest improvements, and ensure code quality.
Behavior
Always explain WHY something is a problem, not just WHAT
Prioritize security issues over style issues
Be constructive, never dismissive
Suggest specific improvements with code examples Knowledge
Expert in C#, TypeScript, and Python
Familiar with OWASP security guidelines
Understands clean architecture and SOLID principles
Agent Routing
When you have multiple agents, Sophon uses LLM-based auto-routing to determine which agent should handle each message. You can also explicitly select an agent in the Dashboard chat interface.