
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 6 main sections:- Guidelines: Define the agent’s behavior, persona, and AI model.
- Tools: Control what data and tools the agent can use.
- Skills: Add reusable instruction sets that give the agent specific behaviors or expertise.
- Memory: Decide how the agent remembers information across conversations.
- WhatsApp: Connect the agent to WhatsApp so people can chat from their phone.
- Telegram: Connect the agent to Telegram so people can chat from anywhere.
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 usage 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 skills
Skills are reusable instruction sets you attach to an agent to give it specific behaviors, expertise, or policies. You can attach up to 10 skills per agent.
- App Skills: Skills you create for a specific app. Once created, they can be reused across all agents in that app.
- Workspace Skills: Skills shared across your workspace. Learn more about managing workspace skills.
- Go to Dashboard in your app editor.
- Click Agents.
- Click Edit Agent on the relevant agent.
- Click Skills.
- Click Add Skill under App Skills.
- Choose how to create the skill:
- Select Start from scratch to write your own instructions.
- Select a template such as refund-policy, support-escalation, pricing-and-plans, or brand-voice to start from a ready-made structure.
- Enter a Skill name, an optional Description, and your Instructions.
- Turn on the Enable for current agent toggle if you want the skill to be active right away.
- Click Create Skill.
- 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.
Connecting your agent to Telegram
Connect your agent to Telegram so people can message it directly from Telegram, without opening your app. A Telegram-connected agent has the same capabilities as your in-app agent. It can create, read, update, or delete records, trigger backend functions, and manage your app’s data.Information about using Telegram with your agent
- All web chat features work seamlessly in Telegram, including tools and data access.
- Users can send voice notes and images for natural interaction.
- Your Telegram bot is created and connected instantly with no manual configuration needed.
- To start a conversation, users open your bot in Telegram and send
/start. - You can add a Telegram button to your app so users can open the bot directly from your app.
- Go to Dashboard in your app editor.
- Click Agents.
- Click Edit Agent on the relevant agent.
- Click Telegram.
- Click Connect Telegram Bot.
- Follow the prompts in Telegram to create and connect your bot.
- Click Send to Chat under Add Telegram to Your App to add a Telegram button to your app.
- Customize the Telegram 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.
How many skills can I add to an agent?
How many skills can I add to an agent?
You can attach up to 10 skills per agent. Skills can be a mix of app skills you create yourself and workspace skills shared across your workspace.
What is the difference between app skills and workspace skills?
What is the difference between app skills and workspace skills?
App skills are created inside a specific app and can be reused across all agents in that app. Workspace skills are shared across your entire workspace and are managed in your workspace settings. You can toggle workspace skills on or off for individual agents without editing the skill itself.


