
Setting up an AI agent
Before you can start working with AI agents, you need to enable them in your app dashboard. Then you can start creating them using the AI chat. You can enable agents for all new apps by default in your account settings in your workspace.When you chat with an AI agent, Base44 uses integration credits. Pricing starts at around 3 integration credits per message with the default model and then varies based on the model you select and the length of the response.
- Go to Dashboard in your app editor.
- Click Agents.
- Turn on the AI Agents toggle.
- Use the AI chat to create an agent and define its role and tasks.

Customizing your AI agent
Each agent has its own configuration panel with 4 main sections:- Guidelines: Define the agent’s behavior, persona, and AI model.
- Tools: Control what data and tools the agent can use.
- Memory: Decide how the agent remembers information across conversations.
- WhatsApp: Connect the agent to WhatsApp so people can chat from their phone.
Guidelines and AI model
Use the Guidelines tab to set how your agent behaves and which AI model it uses.
- Go to Dashboard in your app editor.
- Click Agents.
- Click Edit Agent on the relevant agent.
- Click Guidelines.
- Update the Description to define the agent’s role and high-level behavior.
- Update Instructions with detailed rules your agent should follow.
- Under AI Model, choose how the agent is powered. Keep Automatic selected to use a fast, cost-effective model (based on Gemini 2.5 Flash), or select a different model from Google Gemini, OpenAI GPT, or Anthropic Claude if you need more advanced reasoning or specific provider behavior.
- Click Save.
Choosing an AI model
For most agents you can use the Automatic option. It is optimized for general-purpose tasks and interactive workflows and typically costs about 3 integration credits per message.If you need more control, you can pick a different model. Below is an estimation of credit usafe with different models:
Credits are approximate and vary based on response length. Lighter models use fewer credits, while more powerful models use more. You can switch models at any time if your needs change.
| Model | Best for | Approx. credits / message |
|---|---|---|
| Automatic (Gemini 2.5 Flash) | General-purpose, fast responses | ~3 |
| Gemini 3 Flash | Stronger reasoning at moderate cost | ~5 |
| GPT-5 | Complex analysis and accuracy-critical tasks | ~15 |
Tools and data access
Use the Tools tab to decide what your agent can do and which data it can access.
- Go to Dashboard in your app editor.
- Click Agents.
- Click Edit Agent on the relevant agent.
- Click Tools.
- Choose which tools the agent can use. For example:
- Entity tools to create, read, update, or delete records.
- Backend functions to send notifications, trigger automations, or call external APIs.
- Adjust any tool-specific permissions so the agent only accesses the data it needs.
- Click Save.
Agent memory
Agent memory lets your agent remember important information across conversations, such as preferences, key facts, or shared knowledge. You control whether memories are shared across everyone or kept specific to each person.
- Go to Dashboard in your app editor.
- Click Agents.
- Click Edit Agent on the relevant agent.
- Click Memory.
- Click the Enable Memory toggle to turn memory on.
- Under Memory Scope, choose how this agent saves memories:
- Global & Per User: The agent can create shared memories for everyone and personal memories for each person.
- Global Only: The agent creates memories that are shared across everyone who chats with it.
- Per User Only: The agent creates memories that are specific to each person.
- In Memory Instructions, enter guidance that explains when to save memories and what to include.
- After your agent has a few conversations, review Saved Memories to see what the agent has stored. Click Refresh to load new memories.
- Click Save.
Connecting your agent to WhatsApp
Connect your agent to WhatsApp so people can message your app’s agent directly from their phone, without even opening the app.

Information about using WhatsApp with your agent
- This feature is available for free on all plans.
- A total of 3 agents can be connected to WhatsApp across all your apps. If you try to connect more than 3, you’ll be prompted to disconnect one before continuing.
- Each agent is assigned its own WhatsApp number.
- Every message sent or received with your WhatsApp agent uses 1 integration credit. Credits are also used for agent actions like calling LLMs, querying your database, generating images, or sending emails.
- Your app visitors don’t need to install anything to use WhatsApp agents. They simply tap the WhatsApp button in your app to start a chat. People must send the first message, to help prevent spam and keep them safe. Once the conversation begins, the agent can reply just like it does inside your app.
- WhatsApp conversation supports both images and voice messages.
- If your app is public, people need to log in to your app before they can use the WhatsApp agent. This makes sure the agent can identify who it is chatting with and respond based on their data.
- Go to Dashboard in your app editor.
- Click Agents.
- Click Edit Agent on the relevant agent.
- Click WhatsApp.
- Click Send to Chat under Add WhatsApp to Your App to add a WhatsApp button to your app.
- Customize the WhatsApp welcome message.
- Click Save.
FAQs
Click a question below to learn more about AI agents.Why do I see a “Failed to send message” or 404 error when messaging an agent?
Why do I see a “Failed to send message” or 404 error when messaging an agent?
This can happen if there’s an empty entity in the agent’s Tools and Capabilities settings.To resolve this:
- Open your agent’s settings.
- Click the Tools and Capabilities tab.
- Either update or remove the empty entity.
-
Click Save.

Can I use agents on the free plan?
Can I use agents on the free plan?
Yes. Agents are available on all plans, including the Free plan.
Can I enable agents for all apps in my account?
Can I enable agents for all apps in my account?
You can turn agents on by default for every new app you create.When the Enable agents for new apps by default toggle is on in your Account settings, each new app automatically has the AI Agents toggle enabled in its dashboard so you can start adding and configuring agents right away.This setting does not change existing apps. To enable or disable agents for an existing app, open that app’s Dashboard, click Agents, and adjust the AI Agents toggle there.To turn on agents by default for new apps:
- Click your profile icon at the top right of your workspace.
- Click Settings.
- Click Account settings.
- Turn on the Enable agents for new apps by default toggle in the Default Agents section.

What are the benefits of using agents?
What are the benefits of using agents?
Agents are flexible powerful tools that help you:
- Automate repetitive tasks.
- Get informed, real-time answers.
- Keep your workflow inside one app.
- Pick the right tools automatically.
Where can I find my conversation history with an agent?
Where can I find my conversation history with an agent?
To view conversation history:
- Go to Dashboard in your app editor.
- Click the Agents tab.
- Click the Conversation tab.
-
Click on a past conversation you want to review or reenter.

How does the AI model I choose affect credits and behavior?
How does the AI model I choose affect credits and behavior?
The AI model you choose affects both how your agent behaves and how many integration credits it uses.
- The default Automatic option (based on Gemini 2.5 Flash) gives you fast, general-purpose responses at around 3 credits per message.
- Models such as Gemini 3 Flash provide stronger reasoning at a moderate increase in credits.
- Higher-end models such as GPT-5 are designed for complex analysis and accuracy-critical decisions and generally use more credits per message.


