> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.
# Creating a Superagent
> Create a Superagent and start chatting. Connect tools and add skills, upload files and review memory, add messaging channels and webhooks, and set up workflows.
Create a [Superagent](https://base44.com/superagents) to handle work, set up workflows, and manage everything from a single place. Describe what you want, and your Superagent takes action for you across your tools.
***
## Step 1 | Start a conversation
Your Superagent works through conversation. Start one from scratch, or from a task Base44 suggests.
### Create your Superagent
Describe what you want your Superagent to do, then keep chatting to refine results, ask follow-up questions, or trigger actions. You can reply to messages from your Superagent, and copy its response. You can upload files, paste images, and attach videos and GIFs in chat.
**To create your Superagent:**
1. Log in to [Base44](https://app.base44.com/).
2. Click **Agent** at the top of the sidebar.
3. If this is your first Superagent, choose the type of assistant you want to create, or click **Skip without choosing**. You can then connect your Google or Microsoft account, review the routines your Superagent suggests, and skip any step you want to set up later.
4. Describe what you want your Superagent to do.
**For example:**
```text theme={null}
Create a product for my store based on this idea
```
```text theme={null}
Review my latest leads and suggest who to follow up with
```
```text theme={null}
Generate a report from my Google Sheets data
```
Base44 opens the Superagent you used last. To switch to another Superagent or create a new one, click the dropdown next to your Superagent's name at the top of the editor. The dropdown appears when your workspace has more than one agent.
### Use chat shortcuts
Use chat shortcuts to choose the skill, connector, app, or note you want your Superagent to work with. Type `/` at the start of a message to browse the options, or keep typing to search.
**To use a shortcut:**
1. Open your Superagent.
2. Type `/` at the start of your message and select an option:
* [**Goal**](/superagents/creating-a-superagent#set-a-goal): Start a longer-term task as a goal. You can also type `/goal` followed by a space to switch to goal mode without opening the menu.
* [**Skills**](/superagents/creating-a-superagent#add-skills): Choose from a selection of activated skills, or select **Manage skills** at the bottom to browse the catalog.
* [**Connectors**](/superagents/creating-a-superagent#connect-tools): Choose a tool such as Gmail or Google Calendar, or select **Manage connectors** at the bottom to browse all connectors.
* [**Apps**](/superagents/customizing-your-superagent#working-on-your-apps-from-chat): Choose a Base44 app to work with. This option appears when your workspace has apps.
* [**Notes**](/superagents/taking-notes): Choose a note to use as context for your request. You can attach up to 5 notes per message. This option is not available in the Base44 mobile app.
3. Add your instructions. If you chose a skill or connector, edit or replace the starting message.
4. Send your message.
### View and save artifacts
When your Superagent creates a chart or other visual as an artifact, it appears directly in your chat.
Hover over the artifact and open its three-dot menu. Choose **Download to computer** to keep a copy on your device, or **Save in files** to add it to the `artifacts` folder in **Files**. After saving, you can use **View file** in the confirmation to open the saved artifact.
### Start from an app suggestion
Base44 can suggest a first task for your agent, based on one of your own apps. Suggestions are drawn from that app's own data and activity, so they differ from app to app. Your agent asks you first before it sends anything or publishes. It also asks before writing to your live data unless you, the owner, explicitly ask it in chat to create, update, or delete specific records. It makes those requested record changes in the same turn without a second approval prompt.
**Availability**
* Suggestions appear when you are on a paid plan and have at least one published app.
* This feature is not available to everyone yet.
**To start from a suggestion:**
1. Log in to [Base44](https://app.base44.com/).
2. On the home page, find **Or create an agent to handle your routine work**.
3. Choose an app from the drop-down next to **Start with the first task your agent can do for**.
4. Click a suggestion to hand it to your agent.
### Work in separate conversations
Give each piece of work its own conversation so unrelated topics stay apart. Your Superagent keeps each thread separately, so a question about your leads does not pick up context from a report you were writing earlier. Your conversations are listed under **Conversations** in the sidebar, where you can switch between the **Active** and **Archived** filters and see which conversation your agent is working in.
**To start a new conversation:**
1. Open your Superagent.
2. Under **Conversations** in the sidebar, click **New conversation**.
**To rename or archive a conversation:**
1. Next to the conversation in the sidebar, click the **More actions** icon .
2. Select **Rename** or **Archive**. Archiving removes the conversation from the sidebar without stopping a response that is still running, and **Unarchive** brings it back.
Finish what your agent is currently doing before you switch conversations. The conversations list is available in your browser, not in the Base44 mobile app.
### Set a goal
Give your Superagent a goal when a job is too big for a single reply, such as something long-running or something it needs to go and gather information for first. You describe what counts as finished, and it breaks the goal into tasks and works through them.
While a goal runs, you can follow it and step in:
* **Watch it run:** A **Goal running** banner appears while it works, with **Pause** and **Resume**, and a **Sub-agents** list showing what is working on the goal.
* **Follow the tasks:** The chat shows how many tasks are done, and **Open goal** opens the full list.
* **Check where it stands:** A goal reads Active, Blocked, In review, Completed, Failed, Cancelled, or Paused. Each task reads Pending, In progress, Blocked, Done, Failed, Cancelled, or Skipped.
* **Find it later:** Your Superagent's memory page shows the current goal, or that there is no active goal.
**To set a goal:**
1. Open your Superagent.
2. Type `/goal` in the chat, then select **Goal**.
3. Describe what finishing looks like, then send it.
You can also set a goal from a channel your Superagent is connected to, such as WhatsApp, Telegram, LINE, iMessage, or Slack. Message your agent there the way you normally would and ask it for what you want. Setting a goal by voice is not supported yet.
### Use voice mode
Use voice mode to talk to your Superagent in real time instead of typing. You can turn your camera on or off, switch between your front and rear camera, and share your screen. Voice sessions pick up context from your last 10 text messages, so your Superagent knows what you have already discussed. Long voice calls reconnect automatically so you can keep talking without restarting the session.
**To start a voice call:**
1. Open your Superagent.
2. Make sure the chat message box is empty.
3. Click the **Use voice** button in the chat input.
4. Chat with your Superagent.
**Before you start a voice call:**
* Screen sharing is available on desktop browsers only. Camera sharing works on desktop and mobile.
* Be mindful about what you say or show during a call. Base44 does not store recordings of your voice, screen, or camera.
* Voice transcripts are saved as messages in your chat history and persist across page refreshes, alongside your text messages.
***
## Step 2 | Connect plugins and add skills
Connect tools your Superagent can use, and add skills that extend what it can do. Connectors let your Superagent work with apps like Gmail, Google Drive, Notion, GitHub, and Slack. Skills add reusable instructions your Superagent can use on demand.
### Connect tools
You can connect tools directly, or describe what you want to do in chat and let your Superagent suggest the right connector. You can also connect your own MCP server: click **Add Connector**, then click the **MCP** tab and click **Add a MCP server**.
**To add a connector:**
1. Open your Superagent.
2. Click **Plugins** in the sidebar.
3. Browse or search for the connector you want to use.
4. Click **Connect** on the relevant connector.
5. Turn on **Read only** if you want to limit your Superagent to viewing data only.
6. Click **Connect** again to confirm.
7. Choose the account you want to connect.
8. Review the sign-in details and click **Continue**.
9. Review the requested permissions and click **Allow**.
After you connect a tool, your Superagent can use it in chat and suggest relevant actions based on that connection. For example, once Gmail is connected, you can ask it to summarize today's unread emails.
### Manage connected tools
Manage how a connected tool behaves and what access your Superagent has to it.
**To manage a connected tool:**
1. Open your Superagent.
2. Click **Plugins** in the sidebar.
3. Find the connector under **Apps connected**.
4. Click the **More actions** icon.
5. Choose what you want to do:
* **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 are reusable sets of instructions that help your Superagent complete specific types of work more consistently. Use them to guide your Superagent's work, help it use connected tools better, and avoid repeating the same instructions in chat.
You can activate recommended skills for your Superagent, browse the skills catalog, create your own skill in chat, or upload a skill file.
**To add a skill:**
1. Open your Superagent.
2. Click **Plugins** in the sidebar.
3. Click the **Skills** tab.
4. Choose how you want to add a skill:
* **Recommended skills:** Click **Activate skill** on a recommended skill.
* **Skills catalog:** Click **View all**, select a skill, and click **Activate skill**.
* **Create your own skill:** Click **+ Add Skill** and select **Create skill in chat**.
* **Upload a skill file:** Click **+ Add Skill** and select **Upload skill file**.
**To manage an activated skill:**
1. Open your Superagent.
2. Click **Plugins** in the sidebar.
3. Click the **Skills** tab.
4. Click a skill under **Activated skills**.
5. Choose what you want to do:
* **Edit the skill:** Update the skill instructions and click **Save Skill**.
* **Download the skill:** Click **Download** to save the skill file.
* **Remove the skill:** Click **Delete**.
**How removing skills works:**
* Removing a skill only affects this Superagent. Other Superagents in your workspace are not affected.
* You can add skills from the catalog again at any time.
* Skills you created or uploaded yourself are permanently deleted and cannot be recovered.
***
## Step 3 | Add files and review memory
Add files your Superagent can use as reference, and review the memory it keeps from your conversations.
### Upload files
Upload documents, spreadsheets, PDFs, and other files your Superagent can read and reference during conversations. You can upload files directly in chat or from **Files**.
**To upload a file from Files:**
1. Open your Superagent.
2. Click **More** in the sidebar, then click **Files**.
3. Click **Add New**.
4. Choose what you want to do:
* **Upload file:** Upload a single file.
* **Upload folder:** Upload a folder of files.
* **New folder:** Create a folder to organize your files.
**More ways to work with files:**
* Attach files directly in chat by clicking the attachment icon in the chat input.
* Download an entire folder as a zip file by clicking the **More actions** icon next to the folder and selecting **Download**.
### Review memory
Memory stores what your Superagent knows about you and your conversations so it can respond with more context over time. The Memory page shows what your agent remembers and where each memory came from.
**To review memory:**
1. Open your Superagent.
2. Click **More** in the sidebar, then click **Memory**.
3. Do one of the following:
Knowledge holds the durable facts, preferences, instructions, and decisions your Superagent saves.
1. Click the **Knowledge** tab.
2. Search or filter the saved memories, or click **Add memory** to save one yourself.
1. Click the **Working context** tab.
2. Choose a conversation to see the goal, next steps, decisions, and blockers your Superagent tracks for it.
1. Click the **Memory log** tab.
2. Choose a day on the calendar to review each conversation's summary and transcript. Conversation logs are history, not saved memories.
The **Memory access** banner at the top shows how your Superagent uses memories across conversations.
1. Click **Change access**.
2. Choose how your Superagent saves and uses memory.
1. Click the **More actions** icon at the top of the Memory page.
2. Select **Delete all knowledge**.
### View and manage data
Each table in your Superagent holds a type of record you can open, edit, export, and manage without leaving your workspace. For example, a Superagent that tracks your tasks keeps them in a Task table you can open and edit at any time.
**To view and manage your data:**
1. Open your Superagent.
2. Click **More** in the sidebar, then click **Data**.
3. Do one of the following:
1) Click a table to open it.
2) Use the search bar, **Filters**, and **Columns** to find the records you need.
3) Click **Add Item** to add a record, then fill in the fields and click **Submit**. To edit a record, click it and update its fields.
1. Click the **More actions** icon on the table.
2. Select **Export** to download the table's records as a CSV file.
1. Click the **More actions** icon on the table.
2. Select **Schema** to view the table's fields and structure.
1. Click the **More actions** icon on the table.
2. Select **Recently Deleted** to review and restore records moved to the trash.
1. Click the **More actions** icon on the table.
2. Select **Delete All** to move all records in the table to the trash. You can restore them from **Recently Deleted**.
***
## Step 4 | Customize your Superagent
Customize how your Superagent behaves, remembers context, uses permissions, and connects to external systems. For the full list of settings, see [Customizing your Superagent](/superagents/customizing-your-superagent).
**To customize your Superagent:**
1. Open your Superagent.
2. Click **Agent Settings** in the sidebar.
3. Set up your Superagent using these panels:
* **General:** Choose your chat and automations models, control which workspace apps your Superagent can access, and pick its voice.
* **Credit usage:** See your plan and how many credits you have used.
* **Sharing & access:** Invite collaborators, create a public template link, and choose how memory works.
* **Personalization:** Update your Superagent's identity and review what it knows about you.
* **Channels:** Connect supported messaging channels like WhatsApp, Telegram, iMessage, Slack, and LINE.
* **Security:** Configure permissions, secrets, and connector rules.
* **Developer:** View API details and manage webhooks.
### Connect messaging channels
Connect your Superagent to a channel to chat with it on WhatsApp, Telegram, iMessage, Slack, and LINE.
To set up channels for your Superagent, see [Customizing your Superagent](/superagents/customizing-your-superagent#connecting-channels).
### Add webhooks
Use webhooks to receive real-time notifications when your Superagent receives a message or finishes a reply. Use them when you want your backend to react to Superagent activity without repeatedly checking the API.
**To add a webhook:**
1. Open your Superagent.
2. Click **Agent Settings** in the sidebar.
3. Click **Developer**.
4. Click **View full API documentation**.
5. Scroll to **Your webhooks** and click **Add webhook**.
6. Enter your endpoint in the **Target URL** field.
7. (Optional) Enter a description in the **Description** field.
8. Select which **Events** to send:
* `message.created`: Sent when a message is received.
* `message.completed`: Sent when your Superagent's reply is ready.
9. Select **Sign requests with an HMAC secret (optional)** if you want to verify that webhook requests came from Base44.
10. Click **Create**.
11. Click **Send test payload** to test your webhook.
The signing secret is displayed once after you create the webhook. Copy and store it before closing the dialog.
***
## Step 5 | Set up workflows
Create workflows your Superagent can run on a schedule or when a trigger happens, such as a morning brief or a reminder about unread emails. You can set them up by describing what you want in chat, or by sending a suggested workflow to chat from the **Workflows** page. To learn how to create, manage, and monitor workflows, see [Setting up workflows](/superagents/setting-up-workflows).
**For example:**
```text theme={null}
Every morning at 8 AM, summarize my unread Gmail emails and send me a digest.
```
***
## FAQs
Click a question below to learn more about creating a Superagent.
At the bottom of your Superagent's sidebar, you'll see a checklist of steps that help it do more for you. Click a step to go straight to it:
* [Connect your email and calendar](#connect-tools)
* [Add your Superagent to your meetings](/superagents/meeting-notes)
* [Connect a messaging channel](#connect-messaging-channels)
* [Create or review your workflows](/superagents/setting-up-workflows)
* [Connect the tools you already use](#connect-tools)
You can minimize the checklist at any time. It disappears once you've completed every step.
Your Superagent can 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.
No. You can create and manage a Superagent using natural language. Your Superagent helps guide setup, suggests actions, and handles complexity behind the scenes.
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 workflows based on that access.
Yes. Open **Agent Settings** and click **Security** to control whether your Superagent can update or delete data without asking first. You can also manage connector access from **Plugins**.
Yes. You can upload files directly in chat or from **Files**. Your Superagent can then use those files as reference while you work with it.
Yes. Your Superagent runs in a private environment and only accesses the data you allow. Your data is not used to train external models.
Yes. You can connect messaging channels like WhatsApp, Telegram, iMessage, Slack, and LINE to interact with your Superagent from anywhere. You can also interact with your Superagent using the Base44 app on [Android](https://play.google.com/store/apps/details?id=com.base44.android) or [iOS](https://apps.apple.com/us/app/base44-build-with-ai/id6757432427).
Yes. You can add collaborators to work with the same Superagent, or share your Superagent as a template so others can create their own copy.
When you share a Superagent as a template, you can choose whether to include skills, agent memory, files, and workflows. Connectors are not included, and anyone who creates a copy must reconnect their own accounts and services.
Click the agent name at the top of the editor and select **View all agents** to find, favorite, rename, or delete your Superagents. For more information, see [Managing your Superagents](/superagents/managing-your-superagents).
Only workspace Owners and Admins can add, edit, or remove skills. If you do not see these options, contact your workspace admin.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.