Building a Superagent

Build autonomous Superagents that connect to your tools, monitor activity, and take action across your workspace.

Build your own autonomous Superagent in Base44. A Superagent is a persistent AI assistant that connects to your tools, observes events, and takes action across your workspace. You can use it to monitor emails, generate reports, and automate workflows across your tools and data.

What your Superagent can do

• Monitor systems and respond to events automatically.
• Run scheduled tasks and event-driven workflows.
• Connect to external tools such as Gmail, Google Calendar, Google Drive, Slack, and GitHub.
• Use reusable skills and backend functions for custom logic.
• Communicate through messaging apps such as WhatsApp and Telegram.
• Access knowledge and stored files to reason about problems.
• Trigger actions such as sending alerts, updating data, or generating reports.
• Search the web and preview results while researching.

---

Building your Superagent

Start by describing what you want your Superagent to do. Create workflows, test ideas, and refine how it behaves. As you chat, your Superagent suggests tools, connectors, automations, and tasks based on your goals and instructions. You can also upload files or paste images from your clipboard directly into the chat to give it more context.

Use the Microphone icon to send a voice message. You can also click Reply or Copy on messages.

Superagents can interact across multiple channels including Base44 chat, WhatsApp, and Telegram.

To build a Superagent:

1. Log in to Base44.
2. Click Superagents.
3. Click Create a new Superagent.
4. Start chatting with your Superagent and describe what you want it to do.

If you already created a Superagent, click Continue with [Superagent name] to return to it.

Start with something you already do often, such as monitoring email, tracking alerts, or generating daily summaries.

For example:

Create a Superagent that monitors my Gmail inbox.

If an email looks important or requires a reply,
draft a response for me.

Send me a summary every morning at 8 AM.

---

Configuring your Superagent

Your Superagent thinks, remembers, and uses information based on your chats. Connect it to tools, define its behavior, add resources, and build skills so it can help you in the way you need.

Brain

Configure how your Superagent works, what it can access, and how it behaves. Connect tools, define behavior, and manage the information your Superagent uses.

• Integrations: Control what services and capabilities your Superagent can connect to and act on.
  • Built-in Services: Default platform capabilities such as the Base44 Backend.
  • Payments: Connect Stripe to handle payments and trigger actions.
  • Connectors: Connect external tools such as Gmail, Slack, and Google Drive.
  • Skills: Add reusable logic your Superagent can run as part of tasks or workflows.
• Knowledge: Defines your Superagent’s identity, behavior, and reference material.
• Memory: Stores information your Superagent remembers across conversations.

Your Superagent uses Knowledge, Memory, and files together to understand requests and take action.

Connecting your Superagent to tools

Connect external tools to give your Superagent access to the data and actions it needs. You can also add connectors directly from chat by describing what you want to do. Your Superagent suggests the required connector and guides you through setup.

To add a connector:

1. Open Brain.
2. Click Integrations.
3. Stay in the Connectors tab.
4. Browse or search for a tool.
5. Click Connect.
6. Approve the requested permissions.

After you connect a tool, your Superagent understands that it now has access to it and suggests actions, workflows, and example prompts based on that connector.

For example, after connecting Google Drive, your Superagent will suggest uploading files, generating documents, or automating reports.

To manage a connected connector:

1. Open Brain.
2. Click Integrations.
3. Find the connector under Connected.
4. Click the More Actions icon on the connector card.
5. Choose the action you want:
   • Switch to read-only: Limit the connector to read-only access.
   • Switch to manage: Allow your Superagent to create, update, or delete data, depending on the connector.
   • Switch account: Change the connected account.
   • Disconnect: Temporarily disable the connector.
   • Remove: Remove the connector from your Superagent.

Available actions can vary by connector.

Adding skills for your Superagent

Skills let your Superagent run reusable logic for repeatable jobs such as reports, cleanup tasks, and advanced workflows. You can add third-party skills or create custom ones directly in chat.

To add a skill:

1. Open Brain.
2. Click Integrations.
3. Click the Skills tab.
4. Click Add on a skill.
5. Review or edit the skill details.
6. Click Save Skill.

To create a custom skill:

1. Ask your Superagent in chat to create a skill for your use case.
2. Review it in Files under .agents/skills/.
3. Run it manually or trigger it from a task.

---

Knowledge

Reference information your Superagent uses to understand requests and respond accurately. Knowledge includes identity settings and supporting materials.

Information learned through conversations is stored separately in Memory.

Identity

Defines who the agent is and how it appears.

• Name
• Display name
• Avatar
• Personality
• Communication style

Soul

Defines how the agent behaves and makes decisions.

• Behavioral principles
• Communication tone
• Boundaries
• Decision-making guidelines

User

Stores information about the person the agent is assisting.

• Name and preferences
• Timezone
• Role and responsibilities
• Relevant working context

Knowledge files

Upload reference material your Superagent can use when responding. Click + New to create a file, or upload existing files. Supported formats include documents, images, CSVs, and code files.

---

Memory

Stores information your Superagent remembers between conversations:

• Short-term memory: Context from recent conversations.
• Saved facts: Information your Superagent should remember long-term.
• Daily sessions: Summaries of conversations organized by date.

---

Tasks

Your Superagent can run automated workflows on a schedule or react to events as they happen. Scheduled tasks run at set times, such as daily summaries or syncs. Connector triggers run when something happens, such as a new email or a file update. Describe what you want in chat, and your Superagent creates the task automatically in Tasks.

Scheduled tasks

To create a scheduled task, describe what you want in chat. For example:

Every morning at 8 AM, summarize my unread Gmail emails
and send me a digest.

Connector triggers

To create a connector trigger, describe the event you want to react to. For example:

When I receive a new email in Gmail, check if it needs a reply
and draft a response for me.

Supported connectors:

• Gmail: New email received.
• Google Calendar: Event created, updated, or deleted.
• Google Drive: File added or modified.

Connector triggers use integration credits. Tasks that run often may use credits faster than scheduled tasks.

---

Artifacts

Small, standalone mini apps your Superagent generates during conversations. They appear as interactive previews you can open and explore directly from the sidebar.

For full-featured apps, build a Base44 app.

---

Files

Your Superagent’s working file system. This is where it stores files it creates or uses while running tasks, such as scripts, outputs, and project folders. To add reference material your Superagent should use when responding, use Knowledge files.

Some system files may also appear here, such as the .agents folder used to store internal configuration and MCP connections.

---

Managing your Superagent settings

Manage your Superagent’s configuration and credentials in Settings.

Secrets & Keys

Securely store credentials your Superagent needs to access external services. Secrets are stored as environment variables and can be used by backend functions or integrations.

To add a secret:

1. Click Settings in the sidebar.
2. Click Secrets & Keys.
3. Enter the Secret name and value.
4. Click Add.

Tools Permission

Control which actions your Superagent can perform without asking for confirmation first. You can allow updates or deletions, and add connector-specific rules to set boundaries for connected services.

For example, for a Gmail connector you might add: Only read and summarize emails, never send or delete.

To set your Superagent’s permissions:

1. Click Settings in the sidebar.
2. Click Tools Permission.
3. Toggle the permissions you want to allow:
   • Update Data: Let the Superagent update records without asking first.
   • Delete Data: Let the Superagent delete records without asking first.
4. Under Connector Rules, add instructions for your connectors.

API

Connect external systems to your Superagent through an API endpoint to start conversations, send messages, and receive responses programmatically.

To connect via API:

1. Click Settings in the sidebar.
2. Click API.
3. Copy your Base URL and API key.
4. Include the API key in your request headers and start making calls.

You can start conversations, send messages, retrieve conversation history, and access your Superagent’s memory through the API.

---

Channels

Connect your Superagent to WhatsApp or Telegram so you can chat even when you’re outside Base44. Once connected, your Superagent responds to messages sent from those apps.

Your Superagent is also available on mobile. Download the Base44 app for Android to chat on the go, or access Base44 from your mobile browser on any device.

WhatsApp

Chat with your Superagent from your phone or computer.

To connect WhatsApp:

1. Click Continue on WhatsApp in the sidebar.
2. Click Open WhatsApp.
3. Send the activation message to your Superagent.

To disconnect WhatsApp, send /disconnect in the WhatsApp chat with your Superagent.

Telegram

Telegram works through a bot. You create a Telegram bot using BotFather, then connect the bot to your Superagent so people can interact with it via Telegram.

To connect Telegram:

1. Click Continue on Telegram in the sidebar.
2. Click Open @BotFather to launch Telegram’s bot creator.
3. In the BotFather chat, send the command /newbot.
4. Follow the prompts to:
   • Choose a display name for your bot.
   • Choose a username that ends with bot.
5. Copy the bot token that BotFather provides.
6. Return to Base44 and click I have my token.
7. Paste the token into the field.
8. Click Connect Bot.

---

Click Leave feedback at the bottom of the sidebar to share feedback about Superagents directly with the Base44 team.

---

FAQs

What is a typical workflow for building a Superagent?

Most Superagents are built in four steps:

1. Define the goal: Start by describing what you want the Superagent to help with. For example:
   • Monitor my Gmail inbox and summarize important emails.
   • Watch Slack messages in #alerts and notify me if something looks critical.
   • Generate a daily summary of GitHub activity.
2. Connect your tools: Enable connectors so your Superagent can access the services it needs.
3. Add knowledge and memory: Provide instructions, documents, and context so the Superagent understands how to behave and make decisions.
4. Automate tasks: Create scheduled tasks so the Superagent can run workflows automatically, such as sending summaries or monitoring activity.

Should I create one Superagent or multiple Superagents?

Both approaches work. How you structure your Superagents depends on how you want to organize your workflows. You can build several Superagents, each responsible for a specific task, or one Superagent that handles multiple tasks.

Multiple specialized Superagents

This approach keeps responsibilities separated and can make complex workflows easier to manage.

For example:

• One Superagent monitors Gmail.
• Another tracks Slack activity.
• A third generates reports.

One central Superagent

In this model, a single Superagent:

• Connects to multiple tools.
• Runs several workflows.
• Acts as a central assistant across your workspace.

Many builders start with multiple specialized Superagents while experimenting. As their workflows evolve, they often consolidate those tasks into one central Superagent.

Can I connect multiple Superagents together?

Superagents operate independently. There’s no built-in way to directly chain or connect multiple Superagents. To exchange information between agents, you can use backend functions and automations, or use the Superagent API as a bridge between them.

What is the difference between a Superagent and an app agent?

• A Superagent works across your workspace and helps you manage tools, workflows, and information.
• An app agent lives inside your app and interacts only within that app.

Use a Superagent when you want a persistent assistant that helps you manage systems, workflows, and information across your workspace.

What is the difference between a scheduled task and a connector trigger?

Scheduled tasks run on a fixed interval, such as every hour or every morning at 8 AM. Connector triggers fire automatically when a specific event occurs, such as a new email arriving or a file being added to Drive. Describe what you want and your Superagent creates the right task for you.

Can Superagents connect to external services?

Yes. Superagents can connect to external tools using connectors and built-in services, allowing them to interact with tools like Slack, Gmail, Google Calendar, GitHub, and more.

How do I connect my Superagent to my Base44 app?

Your Superagent has access to your Base44 app data by default. It can read from all your apps and write to its own without setup. The API tab is for external systems calling into your Superagent, not the other way around.

Can Superagents create Base44 apps?

Superagents can’t create full Base44 apps, but they can generate Artifacts: interactive mini apps built during your conversation. Artifacts are a good way to prototype ideas and explore what you want to build. When you’re ready to build a full app, use the Base44 editor.

How are credits used in Superagents?

Superagents use message credits when they process messages, and integration credits when they take actions such as calling connectors, running backend functions, generating code, or creating previews. The amount of credits used depends on the complexity of the task and the tools involved.

Scheduled tasks and automations also consume credits when they run. If an automation processes a message, it uses message credits.

Both credit types reset monthly according to your billing cycle. To check your balance, click the Base44 icon at the top right of your dashboard.

Which AI model does my Superagent use?

The AI model is automatically selected for your Superagent based on the type of message or task. You do not need to configure or choose the model manually.

Can I convert an app into a Superagent?

No. Superagents and apps are separate features in Base44. You can set up an AI agent for your app.

Can I delete my Superagent?

Yes. You can delete your Superagent. This action is permanent and cannot be undone.

To delete your Superagent:

1. Open your Superagent.
2. Click Settings.
3. Click Danger Zone.
4. Click Delete this agent.
5. Click Delete this agent again to confirm.

Deleting your Superagent permanently removes it and all its data, conversations, files, and integrations. This action cannot be undone.