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

> Invia le configurazioni locali degli agenti IA a Base44. Gli agenti sono assistenti IA conversazionali che possono interagire con gli utenti, accedere alle entità della tua app e chiamare funzioni backend.

<Warning>
  Questa pagina fa parte di una skill per agenti IA di programmazione ed è scritta per gli agenti, non per gli umani. Per la documentazione Base44 leggibile dagli umani, consulta la [documentazione per sviluppatori](/developers).
</Warning>

# base44 agents push

Invia le configurazioni locali degli agenti IA a Base44. Gli agenti sono assistenti IA conversazionali che possono interagire con gli utenti, accedere alle entità della tua app e chiamare funzioni backend.

## Sintassi

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

## Autenticazione

**Richiesta**: sì. Se non autenticato, ti verrà chiesto di effettuare prima il login.

## Cosa fa

1. Legge tutti i file degli agenti dalla directory `base44/agents/`
2. Valida le configurazioni degli agenti
3. Mostra il conteggio degli agenti da inviare
4. Carica gli agenti sul backend di Base44
5. Riporta i risultati: agenti creati, aggiornati ed eliminati

## Prerequisiti

* Deve essere eseguito da una directory di progetto Base44
* Il progetto deve avere definizioni di agenti nella cartella `base44/agents/`

## Output

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

## Sincronizzazione degli agenti

L'operazione di push sincronizza i tuoi agenti locali con Base44:

* **Created**: nuovi agenti che non esistevano in Base44
* **Updated**: agenti esistenti con configurazione modificata
* **Deleted**: agenti rimossi dalla tua configurazione locale

**Attenzione**: questa è un'operazione di sincronizzazione completa. Gli agenti rimossi localmente saranno eliminati da Base44.

## Gestione degli errori

Se non ci sono agenti nel tuo progetto:

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

Se un agente ha un nome non valido:

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

## Schema di configurazione dell'agente

Ogni file di agente dovrebbe essere un file `.jsonc` in `base44/agents/` con questa struttura:

```jsonc theme={null}
{
  "name": "agent_name",              // Required: lowercase alphanumeric with underscores, 1-100 chars
  "description": "Brief description of what this agent does",  // Required: min 1 char
  "instructions": "Detailed instructions for the agent's behavior",  // Required: min 1 char
  "tool_configs": [                  // Optional: defaults to []
    // Entity tool - gives agent access to entity operations
    { "entity_name": "Task", "allowed_operations": ["read", "create", "update", "delete"] },
    // Backend function tool - gives agent access to a function
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"  // Optional
}
```

**Regole di denominazione:**

* I **nomi degli agenti** devono corrispondere al pattern: `/^[a-z0-9_]+$/` (alfanumerico minuscolo con solo underscore, 1-100 caratteri)
  * Validi: `support_agent`, `order_bot`, `task_helper`
  * Non validi: `Support-Agent`, `OrderBot`, `task helper`
* I **nomi dei file degli agenti** devono usare underscore (corrispondenti al nome dell'agente)
  * Validi: `support_agent.jsonc`, `order_bot.jsonc`
  * Non validi: `support-agent.jsonc` (trattini non consentiti)
* I **nomi delle entità in `tool_configs`** devono usare PascalCase (corrispondenti al campo `name` dell'entità)
  * Validi: `"entity_name": "Task"`, `"entity_name": "TeamMember"`
  * Non validi: `"entity_name": "task"`, `"entity_name": "team_member"`

**Campi obbligatori:**

* `name`: obbligatorio, deve seguire le regole di denominazione qui sopra
* `description`: obbligatorio, minimo 1 carattere
* `instructions`: obbligatorio, minimo 1 carattere
* `tool_configs`: facoltativo, predefinito array vuoto
* `whatsapp_greeting`: facoltativo

### Errore comune: formato tool\_configs sbagliato

**SBAGLIATO** - NON usare `tools` con `type` ed `entity`:

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

**CORRETTO** - Usa `tool_configs` con `entity_name` e `allowed_operations`:

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

### Migliori pratiche per le istruzioni degli agenti

Quando fornisci agli agenti accesso alle entità, sii esplicito nelle istruzioni sull'uso degli strumenti:

```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"] }
  ]
}
```

Senza istruzioni esplicite di usare gli strumenti delle entità, l'agente potrebbe non interrogare proattivamente i dati dell'utente quando richiesto.

## Casi d'uso

* Dopo aver definito nuovi agenti nel tuo progetto
* Quando modifichi configurazioni di agenti esistenti
* Per sincronizzare le modifiche degli agenti prima di testare
* Come parte del tuo flusso di sviluppo quando cambia il comportamento dell'agente

## Note

* Questo comando sincronizza la configurazione dell'agente, non i dati delle conversazioni
* Le modifiche vengono applicate al tuo progetto Base44 immediatamente
* Assicurati di testare le modifiche degli agenti in un ambiente di sviluppo prima
* Le definizioni degli agenti si trovano nella directory `base44/agents/`
* Usa `base44 agents pull` per scaricare gli agenti da Base44

<Note>Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>