​

base44 agents push

​

Sintaxis

npx base44 agents push

​

Autenticación

​

Lo que hace

1. Lee todos los archivos de agente del directorio base44/agents/
2. Valida las configuraciones de agente
3. Muestra el recuento de agentes a enviar
4. Sube los agentes al backend de Base44
5. Reporta los resultados: agentes creados, actualizados y eliminados

​

Requisitos previos

• Debe ejecutarse desde un directorio de proyecto de Base44
• El proyecto debe tener definiciones de agente en la carpeta base44/agents/

​

Salida

$ npx base44 agents push

Found 2 agents to push
Pushing agents to Base44...

Created: support_agent
Updated: order_bot
Deleted: old_agent

✓ Agents pushed to Base44

​

Sincronización de agentes

• Created: Nuevos agentes que no existían en Base44
• Updated: Agentes existentes con configuración modificada
• Deleted: Agentes que se eliminaron de tu configuración local

​

Manejo de errores

$ npx base44 agents push
No local agents found - this will delete all remote agents

$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores

​

Esquema de configuración del agente

{
  "name": "agent_name",              // Requerido: alfanumérico en minúsculas con guiones bajos, 1-100 caracteres
  "description": "Brief description of what this agent does",  // Requerido: mín. 1 caracter
  "instructions": "Detailed instructions for the agent's behavior",  // Requerido: mín. 1 caracter
  "tool_configs": [                  // Opcional: por defecto []
    // Herramienta de entidad - da al agente acceso a operaciones de entidad
    { "entity_name": "Task", "allowed_operations": ["read", "create", "update", "delete"] },
    // Herramienta de función de backend - da al agente acceso a una función
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"  // Opcional
}

• Los nombres de agente deben coincidir con el patrón: /^[a-z0-9_]+$/ (alfanumérico en minúsculas solo con guiones bajos, 1-100 caracteres)
  • Válido: support_agent, order_bot, task_helper
  • Inválido: Support-Agent, OrderBot, task helper
• Los nombres de archivo de agente deben usar guiones bajos (coincidiendo con el nombre del agente)
  • Válido: support_agent.jsonc, order_bot.jsonc
  • Inválido: support-agent.jsonc (guiones no permitidos)
• Los nombres de entidad en tool_configs deben usar PascalCase (coincidiendo con el campo name de la entidad)
  • Válido: "entity_name": "Task", "entity_name": "TeamMember"
  • Inválido: "entity_name": "task", "entity_name": "team_member"

• name: Requerido, debe seguir las reglas de nombres anteriores
• description: Requerido, mínimo 1 caracter
• instructions: Requerido, mínimo 1 caracter
• tool_configs: Opcional, por defecto array vacío
• whatsapp_greeting: Opcional

​

Error común: formato incorrecto de tool_configs

{
  "name": "my_agent",
  "tools": [                                    // ❌ INCORRECTO
    { "type": "entity_query", "entity": "Task" }
  ]
}

{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECTO
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}

​

Mejores prácticas para las instrucciones del agente

{
  "name": "support_agent",
  "instructions": "You are a helpful support agent.\n\nIMPORTANT: You have access to customer data through entity tools. When users ask about their orders or account:\n1. ALWAYS use the Order entity tool to query their order history\n2. Use the Customer entity tool to look up account details\n3. Analyze the data and provide personalized responses\n\nAlways query the relevant entities first before answering questions about user data.",
  "tool_configs": [
    { "entity_name": "Order", "allowed_operations": ["read"] },
    { "entity_name": "Customer", "allowed_operations": ["read"] }
  ]
}

​

Casos de uso

• Después de definir nuevos agentes en tu proyecto
• Al modificar configuraciones de agentes existentes
• Para sincronizar cambios de agentes antes de probar
• Como parte de tu flujo de desarrollo cuando cambia el comportamiento del agente

​

Notas

• Este comando sincroniza la configuración del agente, no los datos de conversación
• Los cambios se aplican a tu proyecto de Base44 inmediatamente
• Asegúrate de probar los cambios de agente en un entorno de desarrollo primero
• Las definiciones de agente están ubicadas en el directorio base44/agents/
• Usa base44 agents pull para descargar agentes de Base44