Agents

What are Agents?

Agents are preset conversation configurations that define how AI models behave in specific scenarios. Each agent includes a unique personality, expertise, and parameter settings, allowing you to quickly switch between different AI assistants without manual configuration.

An agent contains:

Name: Display name of the agent
Icon: Emoji icon for visual identification
Description: Brief description of the agent's purpose
Default Model: Optional preferred model for the agent
System Prompt: Instructions that define the AI's behavior and role
Parameters: Temperature, Top P, Top K settings

Agents Overview

Using Agents in Chat

The Chat Interface Layout

The chat page features a flexible three-column layout with collapsible panels:

Left Sidebar: Agent selection and conversation history
Main Area: Chat messages and input
Right Panel: Session settings

Switching Agents

Open Agent Selector

Click the current agent card at the top of the left sidebar to enter Agent View

Browse Available Agents

You'll see all your agents in a searchable list. Each card shows the agent's icon, name, and description

Select an Agent

Click any agent to select it. The view automatically returns to the conversation list, and a new chat session is created

Agent Selection

Quick Tip

Hover over any agent in the Agent View for quick actions: Edit, Delete, or Clear Session History.

Agent Features in Chat

When chatting with an agent, you get:

Custom System Prompt: The agent's personality and instructions are automatically applied
Optimized Parameters: Temperature, Top P, and Top K are set to the agent's defaults
Preferred Model: If configured, the agent's default model is automatically selected
Isolated History: Each agent maintains its own conversation history

Creating Agents

Create a New Agent

Enter Agent View

Click the current agent card in the left sidebar to switch to Agent View

Open Creation Panel

Click the + button at the top of the Agent View

Configure the Agent

Fill in the sliding panel on the right:

Select an Emoji icon - Click the icon picker to choose
Enter a name (required) - Give your agent a memorable name
Add a description (optional) - Briefly describe what the agent does
Select default model (optional) - Choose a preferred model, with search filtering
Write system prompt - Define the AI's role and behavior
Adjust parameters - Set Temperature, Top P, and Top K

Save the Agent

Click "Create Agent" to save your new agent

Create Agent Panel

Writing Effective System Prompts

The system prompt is the most important part of an agent. Here are some tips:

Managing Agents

Editing Agents

Enter Agent View

Click the current agent card in the left sidebar

Open Edit Panel

Right-click the agent you want to edit and select "Edit"

Modify Settings

Update any configuration in the sliding panel

Save Changes

Click "Save Changes" to apply

Note

The default agent "OllaMan" can be edited but cannot be deleted.

Deleting Agents

Enter Agent View
Right-click the target agent
Select "Delete"
Confirm the deletion

Warning

Deleting an agent will also delete all its conversation history. This action cannot be undone.

Reordering Agents

In Agent View, simply drag and drop agents to rearrange their order. The order is automatically saved.

Clearing Agent History

To delete all conversations for a specific agent:

Enter Agent View
Right-click the agent
Select "Clear History"
Confirm in the dialog

General, Academic, Career, Copywriting, Design
Education, Emotions, Entertainment, Games, Life
Marketing, Office, Programming, Translation

Programming

Python experts, code debuggers, Cron expression helpers, and more

Academic

Research paper assistants, thesis readers, literature review experts

Life

Nutrition advisors, recipe assistants, plant care guides

Translation

Multi-language translators, style adapters, localization helpers

Entertainment

Game hosts, food critics, creative writing partners

Session Settings Override

Each chat session can temporarily override the agent's default settings without changing the agent itself.

How It Works

Snapshot Mechanism: When you start a new session, a copy of the agent's settings is saved
Temporary Override: Changes only affect the current session
Save to Agent: You can save current settings back to the agent

System Prompt: Override the agent's prompt for this session
Temperature: 0.0 - 2.0 (step: 0.1)
Top P: 0.0 - 1.0 (step: 0.05)
Top K: 1 - 100 (step: 1)

Track Changes

An orange "Modified" badge appears when settings differ from the agent's defaults

Session Settings

Reset or Save

Reset: Click "Reset to Agent Defaults" to restore original settings
Save: Click "Save to Agent" to update the agent with current settings (only shown when modified)

Default Agents

OllaMan comes with two built-in agents:

Agent	Description
OllaMan	Default assistant for general conversations. Cannot be deleted.
Frontend Dev	Specialized in HTML/CSS/JavaScript code generation

Best Practices

1. Be Specific

Write detailed system prompts that clearly define the agent's expertise and response style

2. Match Parameters

Use low temperature (0.1-0.3) for code tasks, higher (0.8-1.2) for creative writing

3. Test and Iterate

Create an agent, test it with real conversations, then refine the prompt

4. Use Session Override

Experiment with settings in a session before saving to the agent

Keyboard Shortcuts

Shortcut	Action
`⌘N` / `Ctrl+N`	Create new conversation
`Enter`	Send message
`Shift+Enter`	New line in input
`Escape`	Cancel message editing

Need Help?

Get Support

Check the Quick Start guide for basic setup
Browse Features for more capabilities
Join community discussions to share agent configurations
Submit feedback on GitHub

Define a Clear Role

Set Behavioral Guidelines

Define Output Format