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 los agentes de IA en el editor de apps, consulta Configurar un agente de IA.
Los agentes de IA son asistentes de IA personalizables. Realizan 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 con archivos de configuración JSONC locales.

Crear agentes

Crea archivos de configuración JSONC en tu directorio base44/agents/ (un archivo por agente). 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 nombre del archivo. Por ejemplo, un agente llamado customer_support estaría en customer_support.jsonc.
string
requerido
Breve descripción de lo que hace el agente.
string
requerido
Prompt del sistema que define el comportamiento, la personalidad y las pautas del agente.
string
requerido
El modelo de IA con el que funciona el agente. Usa automatic para que Base44 elija uno. También puedes indicar un ID predefinido de la lista de modelos compatibles, por ejemplo claude-sonnet-5 o gpt_6_sol.Los ID predefinidos retirados que Base44 aún reconoce se actualizan automáticamente a un reemplazo actual.

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.
array
Nombres de las habilidades de agente asociadas a este agente. Hasta 10 habilidades por agente.

Configuración de herramientas

El array tool_configs define las capacidades de 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 en 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 en 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 las configuraciones de tus agentes. Así obtienes seguridad de tipos y autocompletado para los nombres de agentes en tu código del SDK. Obtén más información sobre los tipos dinámicos.

Ver también

  • agents pull: Sincroniza las configuraciones de agentes de Base44 con tu proyecto local
  • agents push: Despliega las configuraciones locales de tus agentes en Base44
  • Habilidades de agente: Define conjuntos de instrucciones reutilizables para tus agentes
  • 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 fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.