Skip to main content
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

Referencia de campos

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

Campos obligatorios

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.
string
requerido
Descripción breve de lo que hace el agente.
string
requerido
System prompt que define el comportamiento, la personalidad y las directrices del agente.
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

array
Herramientas que el agente puede usar para interactuar con tu app. Consulta Configuración de herramientas.
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.
string
requerido
Nombre de la entidad. Debe coincidir con una entidad existente en tu app.
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.
string
requerido
Nombre de la función. Debe coincidir con una función existente en tu app.
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.