> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# base44 agents push

> Envía configuraciones de agentes de IA locales a Base44. Los agentes son asistentes de IA conversacionales que pueden interactuar con los usuarios, acceder a las entidades de tu app y llamar a funciones de backend.

<Warning>
  Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la [documentación para desarrolladores](/developers).
</Warning>

# base44 agents push

Envía configuraciones de agentes de IA locales a Base44. Los agentes son asistentes de IA conversacionales que pueden interactuar con los usuarios, acceder a las entidades de tu app y llamar a funciones de backend.

## Sintaxis

```bash theme={null}
npx base44 agents push
```

## Autenticación

**Requerida**: Sí. Si no estás autenticado, se te pedirá que inicies sesión primero.

## 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

```bash theme={null}
$ 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

La operación push sincroniza tus agentes locales con Base44:

* **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

**Advertencia**: Esta es una operación de sincronización completa. Los agentes eliminados localmente se eliminarán de Base44.

## Manejo de errores

Si no se encuentran agentes en tu proyecto:

```bash theme={null}
$ npx base44 agents push
No local agents found - this will delete all remote agents
```

Si un agente tiene un nombre inválido:

```bash theme={null}
$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores
```

## Esquema de configuración del agente

Cada archivo de agente debe ser un archivo `.jsonc` en `base44/agents/` con esta estructura:

```jsonc theme={null}
{
  "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
}
```

**Reglas de nombres:**

* **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"`

**Campos requeridos:**

* `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

**INCORRECTO** - NO uses `tools` con `type` y `entity`:

```jsonc theme={null}
{
  "name": "my_agent",
  "tools": [                                    // ❌ INCORRECTO
    { "type": "entity_query", "entity": "Task" }
  ]
}
```

**CORRECTO** - Usa `tool_configs` con `entity_name` y `allowed_operations`:

```jsonc theme={null}
{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECTO
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}
```

### Mejores prácticas para las instrucciones del agente

Al dar a los agentes acceso a entidades, sé explícito en las instrucciones sobre el uso de las herramientas:

```jsonc theme={null}
{
  "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"] }
  ]
}
```

Sin instrucciones explícitas para usar las herramientas de entidad, el agente puede no consultar de forma proactiva los datos del usuario cuando se le pregunta.

## 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

<Note>Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).</Note>