Creating a Superagent

Create and configure a Superagent to automate tasks, connect tools, and manage workflows across your workspace.

Create a Superagent to handle tasks, automate workflows, and manage your business from a single place. Describe what you want, and your Superagent takes action for you across your tools.

---

Step 1 | Create your Superagent

Start by creating your Superagent and describing what you want it to do. You can also upload files, paste images, or use voice input to give your Superagent more context.

To create a Superagent:

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

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

---

Step 2 | Work with your Superagent in chat

Your Superagent is designed to be used through chat. Describe what you want in natural language, and it handles the setup and execution.

Use chat to refine results, ask follow-up questions, and manage ongoing work. Use Reply or Copy on messages to continue or reuse results.

For example:

Create a product for my store based on this idea

Review my latest leads and suggest who to follow up with

Generate a report from my Google Sheets data

You can continue the conversation to refine results, ask follow-up questions, or trigger new actions. Your Superagent adapts based on your instructions and connected tools.

---

Step 3 | Configure your Superagent

Set up what your Superagent can access and how it behaves. Connect tools first, then expand its capabilities with skills and knowledge.

Connect tools

You can also add connectors directly from chat by describing what you want. Your Superagent will suggest the right tools and guide you through setup.

To add a connector:

1. Open Brain.
2. Click Integrations.
3. Stay in the Connectors tab.
4. Search for a tool.
5. Click Connect.
6. Select a site if prompted.
7. Review permissions and approve.

After you connect a tool, your Superagent understands it now has access and starts suggesting relevant actions, workflows, and prompts.

For example: After connecting Google Drive, it may suggest generating documents, organizing files, or automating reports.

Manage connected tools

Control how each connector behaves and what your Superagent can do with it.

To manage a connector:

1. Open Brain.
2. Click Integrations.
3. Find the connector under Connected.
4. Click the More Actions icon.
5. Choose an option:
   • Switch to read-only: Limit access to viewing data.
   • Switch to manage: Allow creating or updating data.
   • Switch account: Change the connected account.
   • Disconnect: Temporarily disable access.
   • Remove: Remove the connector.

Add skills

Skills expand what your Superagent can do by adding reusable actions and custom logic.

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 details.
6. Click Save Skill.

Add knowledge and memory

Provide context so your Superagent understands how to behave and respond.

• Knowledge: Define identity, behavior, and reference material.
• Memory: Store information your Superagent remembers across conversations.

---

Step 4 | Set up tasks and automations

Your Superagent can run tasks on a schedule or react to events across your connected tools. Describe what you want, and your Superagent sets up the logic automatically.

Scheduled tasks

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

You can also react to events in your tools, for example:

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

---

Step 5 | Configure settings and permissions

Configure how your Superagent behaves, what it can access, what it can do automatically, and how you reuse its setup.

Clone your Superagent

Create a copy of an existing Superagent when you want to reuse its setup as a starting point. Choose what to include in the cloned Superagent, such as chat history, skills, tasks, and API keys.

To clone your Superagent:

1. Click Settings.
2. Click Agent Settings.
3. Click Clone Agent.
4. Choose what to include in the cloned Superagent:
   • Chat History: Copy the builder conversation history to the new agent.
   • Skills: Copy backend functions, integrations, and tool configurations.
   • Tasks: Copy automations, including scheduled, entity-triggered, and connector-based tasks.
   • API Keys: Copy stored secrets and API keys to the new agent.
5. Click Clone Agent.

Only include chat history and API keys if the cloned Superagent should use the same context and credentials.

Secrets and 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.
2. Click Secrets & Keys.
3. Enter the Secret name and value.
4. Click Add.

Tools permissions

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 permissions:

1. Click Settings.
2. Click Tools Permission.
3. Enable or disable the permissions you want.
4. Add connector-specific rules if needed.

API access

Use the API to interact with your Superagent from external systems. You can start conversations, send messages, retrieve conversation history, and access your Superagent’s memory.

To connect via API:

1. Click Settings.
2. Click API.
3. Copy your Base URL and API key.
4. Include the API key in your request headers.
5. Start making requests to your Superagent.

Keep your API key secure. Anyone with access can interact with your Superagent.

---

Step 6 | Connect channels

Use your Superagent outside Base44 by connecting messaging channels such as WhatsApp, Telegram, LINE, and iMessage. Your Superagent can respond to messages so you can interact with it from wherever you work without opening Base44.

Scan the QR code with your phone to open or connect the conversation in your messaging app.

WhatsApp

To connect WhatsApp:

1. Click Continue on WhatsApp.
2. Click Open WhatsApp.
3. Send the activation code message.

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

Telegram

To connect Telegram:

1. Click Continue on Telegram.
2. Click Connect Telegram Bot.
3. Click Create a Bot.
4. Confirm the bot in Telegram.

To disconnect, click the Telegram tab, then click Disconnect.

LINE

To connect LINE:

1. Click Continue on LINE.
2. Use the LINE app on your phone to scan the QR code and add the bot.
3. Send the Activation Code as a message to the bot.

• LINE is available in select regions, including Japan, Thailand, Taiwan, and Indonesia.
• You can connect LINE to one app or Superagent at a time. Connecting LINE to another app or Superagent replaces the previous connection.
• To disconnect, send /disconnect in the LINE chat with your Superagent.

iMessage

To connect iMessage:

1. Click Continue on iMessage.
2. Click Connect via iMessage.
3. Send the activation code message.

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

---

FAQs

What can my Superagent do?

Your Superagent can handle tasks across your tools and workflows.

You can ask it to create content, analyze data, automate processes, respond to messages, manage products, and more. It adapts based on the tools you connect and the instructions you give it.

Do I need technical knowledge to create a Superagent?

No. You can create and manage a Superagent using natural language. Your Superagent helps guide setup, suggests actions, and handles complexity behind the scenes.

Do I need to set up everything manually?

No. You can start by simply describing what you want in chat. Your Superagent helps guide setup by suggesting actions, workflows, and configurations based on your goals and connected tools.

How does my Superagent know what it can access?

Your Superagent only has access to the tools and data you connect. After you connect a tool, it understands what actions are possible and starts suggesting relevant tasks and workflows based on that access.

Can I control what my Superagent is allowed to do?

Yes. You can control permissions for each connector and tool. You can limit access to read-only or allow full management, depending on what actions you want your Superagent to take.

Can my Superagent take actions on its own?

Yes. Your Superagent can take actions automatically based on the tasks and permissions you set. You can control when it asks for confirmation and when it acts independently.

What's the difference between Skills, Knowledge, and Memory?

• Skills are reusable scripts your Superagent can run.
• Knowledge defines how your Superagent behaves and what context it uses.
• Memory stores information across conversations so your Superagent can learn and improve over time.

Can my Superagent run tasks automatically?

Yes. Your Superagent can run scheduled tasks or react to events.

For example, it can send daily summaries, monitor activity, or trigger actions when something happens in a connected tool.

Is my data secure?

Yes. Your Superagent runs in a private environment and only accesses the data you allow. Your data is not used to train external models.

Can I use my Superagent on mobile?

Yes. You can connect messaging channels like WhatsApp, Telegram, iMessage, and LINE to interact with your Superagent from anywhere. You can also interact with your Superagent using the Base44 app on Android or iOS.