Skip to main content
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.

​
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

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

$ 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 : 
$ npx base44 agents push
No local agents found - this will delete all remote agents
Si un agent a un nom invalide : 
$ 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 : 
{
  "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 : 
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
CORRECT — Utilisez tool_configs avec entity_name et allowed_operations : 
{
  "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 : 
{
  "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
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.