Passer au contenu principal
Vous consultez la documentation pour développeurs
Cette documentation est destinée aux développeurs travaillant avec la plateforme développeur Base44. Pour des informations sur les agents IA dans l’éditeur d’applications, consultez Configurer un agent IA.
Les agents IA sont des assistants IA personnalisables qui agissent et se connectent à des outils pour aider les membres de l’équipe et les utilisateurs finaux. Définissez le comportement, les permissions et les outils des agents en utilisant des fichiers de configuration JSONC locaux.

​
Créer des agents

Créez des fichiers de configuration JSONC dans votre répertoire base44/agents/ (un fichier par agent), puis exécutez agents push pour les synchroniser avec Base44.

​
Exemple

{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "anthropic/claude-sonnet-4-20250514",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"],
    },
    {
      "entity_name": "customers",
      "allowed_operations": ["read"],
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer",
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent",
    },
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?",
}

​
Référence des champs

Les configurations d’agent utilisent JSONC. Chaque agent est défini dans un fichier séparé dans le répertoire base44/agents/.

​
Champs requis

​
name
string
requis
Identifiant unique pour l’agent. Utilisez des lettres minuscules et des underscores. Le nom doit correspondre au nom de fichier, donc un agent nommé customer_support serait dans customer_support.jsonc.
​
description
string
requis
Brève description de ce que fait l’agent.
​
instructions
string
requis
Prompt système qui définit le comportement, la personnalité et les lignes directrices de l’agent.
​
model
string
requis
Le modèle IA à utiliser, au format provider/model-name.Modèles pris en charge :
  • anthropic/claude-sonnet-4-20250514
  • anthropic/claude-3-5-sonnet-20241022
  • openai/gpt-4o
  • openai/gpt-4o-mini

​
Champs facultatifs

​
tool_configs
array
Outils que l’agent peut utiliser pour interagir avec votre application. Consultez Configuration des outils.
​
whatsapp_greeting
string
Message de bienvenue pour les conversations WhatsApp avec cet agent.

​
Configuration des outils

Le tableau tool_configs définit les capacités de votre agent. Il existe deux types : outils d’entité et outils de fonction.

​
Outils d’entité

Les outils d’entité permettent à l’agent d’effectuer des opérations CRUD sur les entités de votre application.
​
entity_name
string
requis
Nom de l’entité. Doit correspondre à une entité existante dans votre application.
​
allowed_operations
array
requis
Opérations que l’agent peut effectuer sur cette entité. Les valeurs valides sont "read", "create", "update" et "delete".

​
Outils de fonction

Les outils de fonction permettent à l’agent d’invoquer les fonctions backend de votre application.
​
function_name
string
requis
Nom de la fonction. Doit correspondre à une fonction existante dans votre application.
​
description
string
requis
Description de ce que fait la fonction. L’agent l’utilise pour décider quand l’appeler.

​
Types TypeScript

Générez des types TypeScript à partir de vos configurations d’agent pour obtenir la sécurité des types et l’autocomplétion des noms d’agents dans votre code SDK. Apprenez-en plus sur les types dynamiques.

​
Voir aussi

  • agents pull : synchronisez les configurations d’agents depuis Base44 vers votre projet local
  • agents push : déployez vos configurations d’agents locales vers Base44
  • agents : référence SDK pour travailler avec les agents dans votre code
  • Configurer des agents IA : guide pour créer et configurer des agents IA
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.