> ## 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.
# Creating a Superagent
> Create a Superagent, start chatting, and customize how it looks and works.
Create a [Superagent](https://base44.com/superagents) to handle tasks, automate workflows, and manage your work from a single place. Describe what you want, and your Superagent takes action for you across your tools.
***
## Step 1 | Start chatting with your Superagent
Create your Superagent by starting a conversation. Describe what you want it to do, then keep chatting to refine results, ask follow-up questions, or trigger actions.
**To create your Superagent:**
1. Log in to [Base44](https://app.base44.com/).
2. Click **Superagents**.
3. Click **Create a new Superagent**.
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
```
You can use **Reply** to follow up on a message, or **Copy** to copy its response. To return to a Superagent you've already created, click **Continue with \[Superagent name]** or open the **All Agents** view.
### 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.
**To start a voice call:**
1. Make sure the chat message box is empty.
2. Click the **Use voice** button in the chat input.
3. Chat with your Superagent.
Screen sharing is available on desktop browsers only. Camera sharing works on desktop and mobile. Voice calls can last up to 10 minutes.
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 | Customize your Superagent
Customize how your Superagent looks, behaves, remembers context, uses permissions, and connects to external systems.
**To customize your Superagent:**
1. Click **Customize** in the sidebar.
2. Click **General** to set up general settings:
* **Chat model:** Choose the model used while chatting with your Superagent, including any tools it runs during the conversation.
* **Automated tasks model:** Choose the model used when your Superagent works on its own, such as scheduled runs and triggers.
* **Voice:** Choose how your Superagent sounds in voice conversations.
* **Appearance:** Choose a color mode: **Light**, **System**, or **Dark**.
3. Click **Personalization** to customize your Superagent's identity and memory:
* **Identity:** Update your Superagent's avatar, name, and description.
* **Memory:** Review what your Superagent has learned about you.
4. Click **Security** to configure permissions and secrets:
* **Update Data:** Enable this to let your Superagent edit records without asking first.
* **Delete Data:** Enable this to let your Superagent remove records without asking first.
* **Auto-detect secrets in messages:** Enable this to save API keys and tokens as secrets.
* **Secrets:** Add environment variables your Superagent's backend functions can use.
5. Click **Developer** to review developer connection options:
* **API reference:** Copy your API key and base URL, and view the API reference.
* **Webhooks:** Add webhooks to receive notifications when your Superagent receives a message or finishes a reply.
For endpoint details, request examples, webhooks, and setup files, click **Developer** and then click **View full API documentation**.
### 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. Click **Customize**.
2. Click **Developer**.
3. Click **View full API documentation**.
4. Scroll to **Your webhooks** and click **Add webhook**.
5. Enter your endpoint in the **Target URL** field.
6. (Optional) Enter a description in the **Description** field.
7. Select which **Events** to send:
* `message.created`: Sent when a message is received.
* `message.completed`: Sent when your Superagent's reply is ready.
* `conversation.created`: Sent when a new conversation is started.
8. (Optional) Select **Sign requests with an HMAC secret** if you want to verify that webhook requests came from Base44.
9. Click **Create**. If you selected **Sign requests with an HMAC secret**, copy and store the signing secret when it is shown.
10. Click **Send test payload** to test your webhook.
The signing secret is shown once after you create the webhook. Copy and store it before closing the dialog.
***
## Step 3 | Connect tools 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 prompts and workflows 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.
**To add a connector:**
1. Click **Tools** in the sidebar.
2. Browse or search for the connector you want to use.
3. Click **Connect** on the relevant connector.
4. Click **Connect** again to confirm.
5. Choose the account you want to connect.
6. Review the sign-in details and click **Continue**.
7. 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.
### Manage connected tools
Manage how a connected tool behaves and what access your Superagent has to it.
**To manage a connected tool:**
1. Click **Tools** in the sidebar.
2. Find the connector under **Apps connected**.
3. Click the **More Actions** icon.
4. 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 add reusable prompts, workflows, and specialized capabilities your Superagent can use on demand.
**To add a skill:**
1. Click **Tools** in the sidebar.
2. Click the **Skills** tab.
3. Browse or search for the skill you want to use.
4. Click the skill to review and edit its details.
5. Click **Add Skill**.
You can also click **Create skill in chat** to describe a skill you want to create, or **Upload skill file** to add an existing skill file.
***
## Step 4 | Set up tasks and automations
Create tasks your Superagent can run on a schedule or when a trigger happens. You can set them up by describing what you want in chat or by using task templates.
**To create a task from the Tasks page:**
1. Click **Tasks** in the sidebar.
2. Click **New Task**.
3. Browse the suggested tasks, or choose a category.
4. Click **Send to chat** on the task you want to set up.
5. Review the task in chat and complete the setup.
You can also describe a task in chat and let your Superagent set it up for you. All the tasks you create are saved on the **Tasks** page, where you can review and manage them later under **Scheduled Tasks** and **Automated Tasks**.
### Scheduled tasks
Scheduled tasks run at specific times, such as every morning, every Monday, or at the end of each day.
**For example:**
```text theme={null}
Every morning at 8 AM, summarize my unread Gmail emails and send me a digest.
```
### Automated tasks
Automated tasks run when a trigger happens, such as activity in a connected tool or changes to your data.
**For example:**
```text theme={null}
When I receive a new email in Gmail, check if it needs a reply and draft a response for me.
```
***
## Step 5 | 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. Click **Files** in the sidebar.
2. Click **Add New**.
3. 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.
You can also attach files directly in chat by clicking the attachment icon in the chat input.
### Review and manage memory
Memory stores what your Superagent knows about you and your conversations so it can respond with more context over time.
**To review memory:**
1. Click **Memory** in the sidebar.
2. Review the memory sections:
* **Short-term memory:** Context from the current conversation, updated automatically every few messages.
* **Saved facts:** Key facts that persist across all conversations. You can add, edit, or remove these at any time.
* **Daily sessions:** A summary of each day's conversations, shown as a calendar you can browse.
***
## Step 6 | Connect channels
Connect messaging channels so you can use your Superagent outside Base44. The setup flow depends on the channel and may require opening the app, scanning a QR code, or sending an activation message.
### WhatsApp
**To connect WhatsApp:**
1. Click **Continue on WhatsApp**.
2. Click **Open WhatsApp**.
3. Send the activation code message.
### 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.
### 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.
### iMessage
**To connect iMessage:**
1. Click **Continue on iMessage**.
2. Click **Connect via iMessage**.
3. Send the activation code message.
To disconnect, open the **iMessage** tab and click **Disconnect**. Reconnect with a fresh activation code if needed.
***
## FAQs
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 tasks and workflows based on that access.
Yes. Use **Security** in **Customize** to control whether your Superagent can update or delete data without asking first. You can also manage connector access from **Tools**.
Yes. Your Superagent can run scheduled tasks and automated tasks. You can set them up in chat or from the **Tasks** page, and what your Superagent can do depends on the tasks you create and the permissions you allow.
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.
* **Short-term memory** captures context from the current conversation and updates automatically every few messages.
* **Saved facts** are key facts that persist across all conversations. You can add, edit, or remove them at any time.
* **Daily sessions** are summaries of each day's conversations, shown as a browsable calendar.
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, 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 create a template link for your Superagent, and anyone with the link can create a copy. Choose whether to include skills, agent memory, files, and tasks. Connectors are not included, and anyone who creates a copy must reconnect their own accounts and services.
Use the **All Agents** page to organize, share, clone, move, and delete your Superagents. For more information, see [Managing your Superagents](/superagents/managing-your-superagents).