Saltar al contenido principal
Estás viendo la documentación para desarrolladores
Esta documentación es para desarrolladores que trabajan con la plataforma para desarrolladores de Base44. Para información sobre agentes de IA en el editor de apps, consulta Configurar un agente de IA.
Los agentes de IA son asistentes de IA personalizables que ejecutan acciones y se conectan a herramientas para ayudar a los miembros del equipo y a los usuarios finales. Define el comportamiento, los permisos y las herramientas del agente usando archivos de configuración JSONC locales.

Crear agentes

Crea archivos de configuración JSONC en tu directorio base44/agents/ (un archivo por agente) y luego ejecuta agents push para sincronizarlos con Base44.

Ejemplo

{
  "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?",
}

Referencia de campos

Las configuraciones de agentes usan JSONC. Cada agente se define en un archivo separado en el directorio base44/agents/.

Campos obligatorios

name
string
requerido
Identificador único del agente. Usa letras minúsculas y guiones bajos. El nombre debe coincidir con el del archivo, por lo que un agente llamado customer_support estaría en customer_support.jsonc.
description
string
requerido
Descripción breve de lo que hace el agente.
instructions
string
requerido
System prompt que define el comportamiento, la personalidad y las directrices del agente.
model
string
requerido
El modelo de IA a usar, en el formato provider/model-name.Modelos compatibles:
  • anthropic/claude-sonnet-4-20250514
  • anthropic/claude-3-5-sonnet-20241022
  • openai/gpt-4o
  • openai/gpt-4o-mini

Campos opcionales

tool_configs
array
Herramientas que el agente puede usar para interactuar con tu app. Consulta Configuración de herramientas.
whatsapp_greeting
string
Mensaje de bienvenida para las conversaciones de WhatsApp con este agente.

Configuración de herramientas

El array tool_configs define qué capacidades tiene tu agente. Hay dos tipos: herramientas de entidad y herramientas de función.

Herramientas de entidad

Las herramientas de entidad permiten al agente realizar operaciones CRUD sobre las entidades de tu app.
entity_name
string
requerido
Nombre de la entidad. Debe coincidir con una entidad existente en tu app.
allowed_operations
array
requerido
Operaciones que el agente puede realizar sobre esta entidad. Los valores válidos son "read", "create", "update" y "delete".

Herramientas de función

Las herramientas de función permiten al agente invocar las funciones de backend de tu app.
function_name
string
requerido
Nombre de la función. Debe coincidir con una función existente en tu app.
description
string
requerido
Descripción de lo que hace la función. El agente la usa para decidir cuándo llamarla.

Tipos de TypeScript

Genera tipos de TypeScript a partir de tus configuraciones de agentes para obtener seguridad de tipos y autocompletado para los nombres de agentes en el código de tu SDK. Aprende más sobre los tipos dinámicos.

Ver también

  • agents pull: Sincroniza las configuraciones de agentes desde Base44 a tu proyecto local
  • agents push: Despliega tus configuraciones de agentes locales en Base44
  • agents: Referencia del SDK para trabajar con agentes en tu código
  • Configurar agentes de IA: Guía para crear y configurar agentes de IA
Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.