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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# À propos des agents

> Définissez des agents IA à l'aide de 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](/fr/Building-your-app/AI-agents-for-apps) sont des assistants IA personnalisables. Ils agissent et se connectent à des outils pour aider les membres de l'équipe et les utilisateurs finaux. Définissez le comportement, les autorisations et les outils des agents à l'aide de 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). Exécutez ensuite [`agents push`](/fr/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": "claude-sonnet-5",
  "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?",
  "selected_skill_names": ["refund-policy", "brand-voice"],
}
```

## Référence des champs

Les configurations d'agents utilisent JSONC. Chaque agent est défini dans un fichier distinct du répertoire `base44/agents/`.

### Champs obligatoires

<ResponseField name="name" type="string" required>
  Identifiant unique de l'agent. Utilisez des lettres minuscules et des tirets bas. Le
  nom doit correspondre au nom du fichier. Un agent nommé `customer_support` se trouve
  donc 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 consignes de l'agent.
</ResponseField>

<ResponseField name="model" type="string" required>
  Le modèle d'IA utilisé par l'agent. Utilisez `automatic` pour laisser Base44 en choisir un. Vous pouvez aussi définir un ID de préréglage de la liste des [modèles pris en charge](/fr/developers/backend/resources/models), par exemple `claude-sonnet-5` ou `gpt_6_sol`.

  Les ID de préréglage retirés que Base44 reconnaît encore sont automatiquement mis à niveau vers un remplacement actuel.
</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>

<ResponseField name="selected_skill_names" type="array">
  Noms des [compétences d'agent](/fr/developers/backend/resources/agents/agent-skills)
  associées à cet agent. Jusqu'à 10 compétences par agent.
</ResponseField>

## Configuration des outils

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

### Outils d'entité

Les outils d'entité permettent à l'agent d'effectuer des opérations CRUD sur les [entités](/fr/developers/backend/resources/entities/overview) de votre application.

<ResponseField name="entity_name" type="string" required>
  Nom de l'entité. Doit correspondre à une entité existante de 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'appeler les [fonctions backend](/fr/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 de votre application.
</ResponseField>

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

## Types TypeScript

Générez des types TypeScript à partir de vos configurations d'agents. Vous bénéficiez ainsi de la sécurité de typage et de l'autocomplétion des noms d'agents dans votre code SDK. En savoir plus sur les [types dynamiques](/fr/developers/references/sdk/getting-started/dynamic-types).

## Voir aussi

* [`agents pull`](/fr/developers/references/cli/commands/agents-pull) : synchronisez les configurations d'agents de Base44 vers votre projet local
* [`agents push`](/fr/developers/references/cli/commands/agents-push) : déployez vos configurations d'agents locales sur Base44
* [Compétences d'agent](/fr/developers/backend/resources/agents/agent-skills) : définissez des ensembles d'instructions réutilisables pour vos agents
* [`agents`](/fr/developers/references/sdk/docs/interfaces/agents) : référence SDK pour utiliser les agents dans votre code
* [Configurer des agents IA](/fr/Building-your-app/AI-agents-for-apps) : guide pour créer et configurer des agents IA

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.