Skip to main content
AI agents are customizable AI assistants that take action and connect to tools to help team members and end users. Define agent behavior, permissions, and tools using local JSONC configuration files.

​
Create agents

Create JSONC configuration files in your base44/agents/ directory (one file per agent), then run agents push to sync them to Base44.

​
Example

{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "anthropic/claude-sonnet-4-20250514",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"]
    },
    {
      "entity_name": "customers", 
      "allowed_operations": ["read"]
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer"
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent"
    }
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?"
}

​
Field reference

Agent configurations use JSONC. Each agent is defined in a separate file in the base44/agents/ directory.

​
Required fields

​
name
string
required
Unique identifier for the agent. Use lowercase letters and underscores. The name should match the filename, so an agent named customer_support would be in customer_support.jsonc.
​
description
string
required
Brief description of what the agent does.
​
instructions
string
required
System prompt that defines the agent’s behavior, personality, and guidelines.
​
model
string
required
The AI model to use, in the format provider/model-name. Supported models:
  • anthropic/claude-sonnet-4-20250514
  • anthropic/claude-3-5-sonnet-20241022
  • openai/gpt-4o
  • openai/gpt-4o-mini

​
Optional fields

​
tool_configs
array
Tools the agent can use to interact with your app. See Tool configuration.
​
whatsapp_greeting
string
Welcome message for WhatsApp conversations with this agent.

​
Tool configuration

The tool_configs array defines what capabilities your agent has. There are two types: entity tools and function tools.

​
Entity tools

Entity tools allow the agent to perform CRUD operations on your app’s entities.
​
entity_name
string
required
Name of the entity. Must match an existing entity in your app.
​
allowed_operations
array
required
Operations the agent can perform on this entity. Valid values are "read", "create", "update", and "delete".

​
Function tools

Function tools allow the agent to invoke your app’s backend functions.
​
function_name
string
required
Name of the function. Must match an existing function in your app.
​
description
string
required
Description of what the function does. The agent uses this to decide when to call it.

​
See also