> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minibuddies.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Agents
> Learn about Minibuddies agents - pre-built specialists and custom agents. Switch agents, understand plan limits, and create your own with Pro+.
## What are agents?
**Agents** are AI assistants in Minibuddies, each with a specific role and toolset. The **Brain** is your general-purpose agent. **Specialized agents** (Luma, Optimus, Atlas, Scribe, and others) are tuned for particular domains - social media, SEO, data analysis, meetings, finance, legal, and more. **Custom agents** (Pro+ only) let you define your own agent with a custom prompt and selected tools.
Choosing the right agent improves response quality because each one has domain-specific knowledge, prompts, and integrations.
## Pre-built agents
Minibuddies includes these specialized agents:
| Agent | Role | Best for |
| ------------ | -------------------- | ---------------------------------------------------------------------------- |
| **Luma** | Social Media Manager | Content creation, scheduling, trend detection. Works with LinkedIn and more. |
| **Optimus** | SEO Specialist | Site audits, keyword research, content optimization. Drives organic traffic. |
| **Atlas** | Data Analyst | CSV/JSON analysis, data cleaning, reports. Turns data into insights. |
| **Scribe** | Meeting Summarizer | Joins Google Meet. Records, transcribes, summarizes with action items. |
| **Beacon** | HR & Recruiting | Resume screening, interview scheduling, candidate communications. |
| **Justice** | Legal Assistant | Contract review, risk highlighting, legal research. Compliance support. |
| **Ledger** | Finance & Accounting | Expenses, invoicing, financial reports. |
| **Hunter** | Business Strategist | Market analysis, business models, growth opportunities. |
| **Polyglot** | Translation | Document and content translation. 100+ languages with cultural nuance. |
Each agent has access to integrations relevant to its domain. For example, Luma uses LinkedIn; Optimus can audit websites; Ledger can work with financial data. Connect the right integrations to get the most from each agent.
## Switching agents
You can change agents at any time during a chat:
1. Locate the **agent selector** - usually near the prompt box or in the chat header.
2. Click to open the list of available agents.
3. Select the agent you want. Your conversation continues; the new agent brings its own expertise and tools.
4. Send your next message. The selected agent processes it.
Switching doesn't clear your chat history. The new agent sees the prior messages and can use that context.
If a response feels off-topic or generic, try switching to a more specialized agent. For example, use Optimus instead of Brain for SEO tasks, or Luma for social content.
## Selecting agents on Starter plan
If you're on the **Starter** plan, you can use up to 5 agents. After subscribing, you'll be taken to the **Select Your Buddies** page where you choose which 5 agents to activate. Pick the ones that match your workflow (e.g., Brain, Luma, Optimus, Atlas, Ledger). You can change your selection later from Settings or Billing. Pro and Pro+ plans include all agents by default.
## Plan limits
Your subscription determines how many agents you can use:
| Plan | Agent access |
| ----------- | ------------------------------------------- |
| **Starter** | Up to 5 pre-built agents |
| **Pro** | All pre-built agents |
| **Pro+** | All pre-built agents + create custom agents |
Custom agents are only available on Pro+. If you're on Starter or Pro and need a custom agent, upgrade your plan.
## Custom agents (Pro+ only)
**Custom agents** let you build your own AI assistant with a custom system prompt and chosen integrations. Unlike pre-built agents, you define exactly how the agent behaves, what role it plays, and which tools (integrations) it can use. Custom agents are only available on the **Pro+** plan.
### Why use custom agents
* **Brand voice** - Create an agent that always writes in your company's tone and style
* **Repeat workflows** - Standardize tasks you do often (e.g., code review, content approval, data summaries)
* **Narrow focus** - Limit the agent to specific integrations and behaviors instead of a broad pre-built agent
### What you define
| Field | Purpose | Example |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Agent Name** | Display name in the agent list | "Code Reviewer" |
| **Agent ID** | Unique identifier (alphanumeric and underscores only). Cannot be changed after creation. | `code_reviewer_1` |
| **Role** | Short role label (e.g., "Senior Engineer") | "Senior Engineer" |
| **Description** | What the agent does; helps you and the AI understand its purpose | "Reviews code for bugs, style, and best practices" |
| **System Prompt** | Instructions that define behavior, tone, constraints, and focus. This is the core of your custom agent | "You are a strict code reviewer. Always check for security issues, suggest improvements, and format feedback as a checklist." |
| **Tools & Integrations** | Which integrations this agent can use (Gmail, Drive, Calendar, GitHub, etc.). The agent only has access to the tools you select | Gmail, GitHub |
Agent ID must contain only letters, numbers, and underscores. Each agent ID must be unique for your account. Choose carefully - the ID cannot be changed after the agent is created.
### How to create a custom agent
From the dashboard, click **Agents** in the sidebar. You'll see pre-built agents and a **Create Custom Agent** card at the end.
Click the **Create Custom Agent** card (or the **+** / **Start Building** button). The create form opens in a modal. If the card is locked or grayed out, you're not on Pro+ and need to upgrade.
**Agent Name** is the display name (e.g., "Code Reviewer"). **Agent ID** is the unique identifier - use only letters, numbers, and underscores (e.g., `code_reviewer_1`). The ID cannot be changed later.
**Role** is a short label (e.g., "Senior Engineer"). **Description** explains what the agent does. Both help the AI understand the agent's purpose.
The **System Prompt** defines how the agent behaves. Include its persona, tone, constraints, and any rules. For example: "You are a code reviewer. Always check for security vulnerabilities. Format feedback as bullet points. Be concise."
Choose which integrations the agent can use (e.g., Gmail, Outlook, Google Drive, GitHub, Discord). The agent will only have access to these. Select only what it needs - fewer tools keep responses focused and reduce token usage.
Click **Save Agent**. The agent appears in your agent list. Select it from the chat interface (agent selector) to use it. It works like any other agent - just with your custom prompt and chosen tools.
### Editing and deleting custom agents
* **Edit** - From the Agents section, click the **Edit** (pencil) icon on your custom agent. Update the name, role, description, system prompt, or tools. The Agent ID cannot be changed. Save your changes.
* **Delete** - Click the **Delete** (trash) icon on your custom agent. Confirm the deletion. The agent is removed from your list. Past chats where you used this agent remain in your history; they are not deleted.
Custom agents are stored per user. Each Pro+ user can create multiple custom agents. You can switch to a custom agent mid-chat, and the agent can hand off to other agents (including pre-built ones) when appropriate.
### Tips for a good system prompt
* **Be specific** - "You are a code reviewer" is okay; "You are a senior Python developer who reviews code for security, readability, and PEP 8 compliance" is better.
* **Set constraints** - "Always respond in under 200 words" or "Use bullet points for feedback."
* **Include examples** - If you want a certain format, show it in the prompt.
* **Mention integrations** - If the agent uses Gmail, say "You have access to the user's Gmail. Use it to draft replies when asked."
## Best practices for agent selection
* **Match task to agent** - Use Luma for social, Optimus for SEO, Ledger for finance, etc.
* **Use Brain for exploration** - When you're unsure which agent fits, start with Brain.
* **Connect integrations** - Agents are more powerful when their relevant integrations are connected.
* **Custom agents for repeat workflows** - If you do the same type of task often, a custom agent can standardize it.
## What's next?
Deep dive into the main chat interface.
Connect tools so agents can act on your data.
Example prompts for each agent type.
Compare plans and agent limits.
## Need help?
Questions about agents or custom agents? Reach out at [contact@minibuddies.ai](mailto:contact@minibuddies.ai) or join our [Discord community](https://discord.com/invite/ZJDSJxwx).