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

# À propos des agents

> Définissez des agents IA en utilisant des fichiers de configuration locaux

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      Vous consultez la documentation pour développeurs
    </div>

    <div className="dev-docs-banner-text">
      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 <a href="/Building-your-app/AI-agents-for-apps">Configurer un agent IA</a>.
    </div>
  </div>
</div>

Les [agents IA](/Building-your-app/AI-agents-for-apps) 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`](/developers/references/cli/commands/agents-push) pour les synchroniser avec Base44.

## Exemple

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

<ResponseField name="name" type="string" required>
  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`.
</ResponseField>

<ResponseField name="description" type="string" required>
  Brève description de ce que fait l'agent.
</ResponseField>

<ResponseField name="instructions" type="string" required>
  Prompt système qui définit le comportement, la personnalité et les lignes directrices de l'agent.
</ResponseField>

<ResponseField name="model" type="string" required>
  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`
</ResponseField>

### Champs facultatifs

<ResponseField name="tool_configs" type="array">
  Outils que l'agent peut utiliser pour interagir avec votre application.
  Consultez [Configuration des outils](#tool-configuration).
</ResponseField>

<ResponseField name="whatsapp_greeting" type="string">
  Message de bienvenue pour les conversations WhatsApp avec cet agent.
</ResponseField>

## 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](/developers/backend/resources/entities/overview) de votre application.

<ResponseField name="entity_name" type="string" required>
  Nom de l'entité. Doit correspondre à une entité existante dans votre application.
</ResponseField>

<ResponseField name="allowed_operations" type="array" required>
  Opérations que l'agent peut effectuer sur cette entité. Les valeurs valides sont `"read"`,
  `"create"`, `"update"` et `"delete"`.
</ResponseField>

### Outils de fonction

Les outils de fonction permettent à l'agent d'invoquer les [fonctions backend](/developers/backend/resources/backend-functions/overview) de votre application.

<ResponseField name="function_name" type="string" required>
  Nom de la fonction. Doit correspondre à une fonction existante dans votre application.
</ResponseField>

<ResponseField name="description" type="string" required>
  Description de ce que fait la fonction. L'agent l'utilise pour décider quand
  l'appeler.
</ResponseField>

## 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](/developers/references/sdk/getting-started/dynamic-types).

## Voir aussi

* [`agents pull`](/developers/references/cli/commands/agents-pull) : synchronisez les configurations d'agents depuis Base44 vers votre projet local
* [`agents push`](/developers/references/cli/commands/agents-push) : déployez vos configurations d'agents locales vers Base44
* [`agents`](/developers/references/sdk/docs/interfaces/agents) : référence SDK pour travailler avec les agents dans votre code
* [Configurer des agents IA](/Building-your-app/AI-agents-for-apps) : guide pour créer et configurer des agents IA

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