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

> Pousse les configurations d'agents IA locales vers Base44. Les agents sont des assistants IA conversationnels capables d'interagir avec les utilisateurs, d'accéder aux entités de votre application et d'appeler des fonctions backend.

<Warning>
  Cette page fait partie d'une compétence d'agent de code IA et est écrite pour les agents, pas pour les humains. Pour la documentation Base44 lisible par un humain, consultez la [documentation développeur](/developers).
</Warning>

# base44 agents push

Pousse les configurations d'agents IA locales vers Base44. Les agents sont des assistants IA conversationnels capables d'interagir avec les utilisateurs, d'accéder aux entités de votre application et d'appeler des fonctions backend.

## Syntaxe

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

## Authentification

**Requise** : oui. Si vous n'êtes pas authentifié, une invite de connexion s'affiche.

## Ce que fait la commande

1. Lit tous les fichiers d'agents du répertoire `base44/agents/`
2. Valide les configurations d'agents
3. Affiche le nombre d'agents à pousser
4. Envoie les agents vers le backend Base44
5. Rapporte les résultats : agents créés, mis à jour et supprimés

## Prérequis

* Doit être exécutée depuis un répertoire de projet Base44
* Le projet doit contenir des définitions d'agents dans le dossier `base44/agents/`

## Sortie

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

## Synchronisation des agents

L'opération de push synchronise vos agents locaux avec Base44 :

* **Created** : nouveaux agents qui n'existaient pas dans Base44
* **Updated** : agents existants avec une configuration modifiée
* **Deleted** : agents retirés de votre configuration locale

**Attention** : c'est une opération de synchronisation complète. Les agents retirés localement seront supprimés de Base44.

## Gestion des erreurs

Si aucun agent n'est trouvé dans votre projet :

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

Si un agent a un nom invalide :

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

## Schéma de configuration d'agent

Chaque fichier d'agent doit être un `.jsonc` dans `base44/agents/` avec cette structure :

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

**Règles de nommage :**

* **Les noms d'agents** doivent correspondre au motif : `/^[a-z0-9_]+$/` (alphanumérique en minuscules avec underscores uniquement, 1 à 100 caractères)
  * Valides : `support_agent`, `order_bot`, `task_helper`
  * Invalides : `Support-Agent`, `OrderBot`, `task helper`
* **Les noms de fichiers d'agents** doivent utiliser des underscores (correspondant au nom de l'agent)
  * Valides : `support_agent.jsonc`, `order_bot.jsonc`
  * Invalides : `support-agent.jsonc` (les tirets ne sont pas autorisés)
* **Les noms d'entités dans `tool_configs`** doivent être en PascalCase (correspondant au champ `name` de l'entité)
  * Valides : `"entity_name": "Task"`, `"entity_name": "TeamMember"`
  * Invalides : `"entity_name": "task"`, `"entity_name": "team_member"`

**Champs requis :**

* `name` : requis, doit suivre les règles de nommage ci-dessus
* `description` : requise, minimum 1 caractère
* `instructions` : requises, minimum 1 caractère
* `tool_configs` : facultatif, par défaut tableau vide
* `whatsapp_greeting` : facultatif

### Erreur courante : mauvais format tool\_configs

**MAUVAIS** — N'utilisez PAS `tools` avec `type` et `entity` :

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

**CORRECT** — Utilisez `tool_configs` avec `entity_name` et `allowed_operations` :

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

### Bonnes pratiques pour les instructions d'agent

Lorsque vous donnez accès à des entités à un agent, soyez explicite dans les instructions sur l'utilisation des outils :

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

Sans instructions explicites pour utiliser les outils d'entités, l'agent peut ne pas interroger proactivement les données utilisateur lorsqu'on le lui demande.

## Cas d'usage

* Après avoir défini de nouveaux agents dans votre projet
* Lors de la modification de configurations d'agents existants
* Pour synchroniser les changements d'agents avant les tests
* Dans votre workflow de développement lorsque le comportement d'un agent change

## Remarques

* Cette commande synchronise la configuration de l'agent, pas les données de conversation
* Les changements sont appliqués immédiatement à votre projet Base44
* Testez les changements d'agent dans un environnement de développement d'abord
* Les définitions d'agents se trouvent dans le répertoire `base44/agents/`
* Utilisez `base44 agents pull` pour télécharger les agents depuis Base44

<Note>Cette page a été traduite à l'aide de l'IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](/). </Note>