Skip to main content

​
Overview

Agents in EnConvo are AI assistants with specialized capabilities, custom instructions, and access to tools. While standard chat provides general-purpose AI conversation, agents are purpose-built for specific tasks — they have defined personalities, access to particular tools, and follow structured workflows to deliver consistent, high-quality results. EnConvo comes with powerful built-in agents and lets you create your own custom agents (bots) tailored to your exact needs.

​
Agent Mode vs Chat Mode

Understanding the difference between these two modes is key to getting the most out of EnConvo:
You can switch between Chat Mode and Agent Mode at any time using the mode toggle in the chat interface. Use Chat Mode for quick questions and Agent Mode when you need the AI to take action.

​
Built-in Agents

EnConvo ships with several pre-configured agents for common tasks:

​
Mavis — Your AI Assistant

Mavis is EnConvo’s default general-purpose agent. It has access to a broad set of tools and can handle most everyday tasks:
  • Answer questions using web search
  • Read and analyze files on your Mac
  • Generate and edit images
  • Manage your knowledge base
  • Execute MCP server tools
  • Run workflows

​
Deep Research Agent

The Deep Research Agent is designed for in-depth investigation of complex topics:
1

Define Your Research Question

Provide a clear research question or topic
2

Agent Plans Research

The agent creates a research plan, identifying key areas to investigate
3

Multi-Source Search

Searches across multiple web sources, academic databases, and your knowledge base
4

Analysis & Synthesis

Analyzes findings, identifies patterns, compares perspectives
5

Comprehensive Report

Delivers a structured report with citations and key takeaways
Best for: Market research, competitive analysis, literature reviews, technical deep-dives, fact-checking complex claims.

​
Other Built-in Agents

​
Creating Custom Agents (Bots)

Custom agents let you build specialized AI assistants with exactly the capabilities you need.

​
Using the Bot Builder

1

Open Bot Builder

Go to Settings and navigate to the Bots section, or use the command /create-bot in SmartBar
2

Define Identity

Give your bot a name, icon, and description that clearly convey its purpose
3

Write System Prompt

Define the bot’s personality, expertise, and behavior rules in the system prompt. This is the most important step — it shapes every response.
4

Select Tools

Choose which tools your bot can access: MCP servers, web search, file system, knowledge base, and more
5

Configure Model

Select the AI model and parameters (temperature, max tokens) for this bot
6

Test & Refine

Test your bot with sample queries and refine its behavior

​
System Prompt Best Practices

The system prompt defines your agent’s behavior. A well-written prompt makes the difference between a useful agent and a frustrating one.
Instead of “You are a helpful assistant”, write “You are a senior marketing strategist specializing in B2B SaaS content”. Specificity leads to better, more focused responses.
Clearly state what the agent should and should not do. Include explicit constraints like “Do not provide medical advice” or “Always cite sources”.
If you want structured output, include examples: “Format your response as: Summary (2-3 sentences), Key Points (bullet list), Action Items (numbered list)”.
Include relevant terminology, frameworks, or standards your agent should know. This helps it respond with appropriate expertise.

​
Selecting Agent Tools

Tools give your agent the ability to take action beyond generating text. Choose tools based on what your agent needs to accomplish:
Be selective with tools. An agent with too many tools may take longer to respond and may choose suboptimal tools. Give each agent only the tools it genuinely needs.

​
Using Agents

​
From SmartBar

Invoke any agent from SmartBar using the @ prefix:

​
From the Chat Interface

  1. Open the chat interface
  2. Click the agent/bot selector at the top
  3. Choose your desired agent
  4. Start your conversation

​
From Workflows

Agents can be used as nodes in workflows, allowing you to chain agent tasks together:
  1. Add an Agent Node to your workflow
  2. Select which agent to use
  3. Define the input from the previous node
  4. The agent’s output feeds into the next step

​
Agent Memory

Agents can maintain memory across conversations:
  • Conversation Memory: The agent remembers the current conversation context
  • Persistent Memory: Key facts and preferences are stored and recalled in future conversations
  • Knowledge Base Integration: The agent can reference your stored documents
See Memory for more details on how memory works.

​
Example Custom Agents

​
Email Composer

​
Meeting Summarizer

​
Technical Documentation Writer

​
Sharing Agents

You can share your custom agents with others:

​
Export

  1. Go to Settings -> Bots
  2. Select the bot you want to share
  3. Click Export to save the configuration

​
Import

  1. Go to Settings -> Bots
  2. Click Import
  3. Select the exported bot configuration file

​
Tips for Effective Agents

Begin with a minimal system prompt and a few tools. Test thoroughly, then add complexity as needed. Over-engineering from the start leads to unpredictable behavior.
Try unusual inputs, ambiguous requests, and tasks outside the agent’s scope. A good agent handles these gracefully.
Use powerful models (GPT-4o, Claude Sonnet) for complex reasoning tasks. Use faster models (GPT-4o mini) for simple, high-frequency tasks.
Low temperature (0-0.3) for factual tasks, code review, data analysis. Higher temperature (0.7-1.0) for creative writing, brainstorming, marketing copy.
Pay attention to where your agent falls short. Update the system prompt and tool selection based on real usage patterns.

MCP Servers

Connect agents to external tools and data

Memory

How agents remember across conversations

Skills

Extend agent capabilities with skills

Workflows

Chain agents together in automated workflows