> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alyzai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Qu’est-ce qu’un agent ?

> La différence entre l’assistant et un agent, et pourquoi un agent spécialisé vaut mieux qu’un agent à tout faire.

> [!NOTE]
>
> Concept · 7 min

> [!TIP]
>
> **Exemple métier.** Les exemples achats, qualité ou industrie illustrent le parcours. Adaptez
> les données, les rôles et le vocabulaire à votre contexte.

Un **agent** est un assistant spécialisé que vous configurez pour une mission durable. Sa mission
décrit le comportement attendu, son périmètre limite les données accessibles et ses capacités
définissent les actions qu’il peut proposer.

L’Assistant général convient à des besoins variés. Un agent devient utile lorsque plusieurs
personnes doivent retrouver le même cadre, les mêmes ressources et les mêmes garde-fous.

> [!TIP]
>
> **Spécialisé plutôt que généraliste.** Un agent chargé uniquement de qualifier une demande sera
> plus prévisible qu’un agent censé analyser, rédiger, envoyer, modifier des tables et décider
> dans tous les contextes.

## Quand créer un agent

Créez un agent si les quatre conditions suivantes sont réunies :

* la mission peut être expliquée en quelques phrases stables ;
* les sources utiles sont identifiables ;
* les actions autorisées peuvent être limitées ;
* des scénarios de test permettent de décider si son comportement est acceptable.

N’en créez pas uniquement pour enregistrer une consigne ponctuelle. Un fil de l’Assistant ou un
modèle de demande peut suffire. Si le résultat doit suivre une séquence déterministe, utilisez
plutôt une automatisation.

## Où les agents sont gérés

La **galerie** liste vos agents sous forme de cartes (avec leur avatar). De là, vous créez, dupliquez ou ouvrez un agent dans son **configurateur**.

![Galerie d’agents : cartes avec avatars générés](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/agents/galerie.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=5aeeb2f49c10c3b8bdb5dfa63181cc45)

La galerie d’agents — chaque carte porte l’avatar de l’agent.

## Les cinq couches de configuration

| Couche | Question à laquelle elle répond |
| - | - |
| **Général** | Quelle est la mission et comment l’agent est-il présenté ? |
| **Capacités** | Quels outils ou types d’actions peut-il utiliser ? |
| **Périmètre** | Quelles collections, tables ou vues peut-il consulter ? |
| **Permissions** | Peut-il seulement lire, ou aussi écrire et déclencher une action ? |
| **Test** | Que fait-il sur un cas nominal, ambigu, interdit ou incomplet ? |

Ces couches se complètent. Une instruction « n’écris jamais » ne remplace pas une permission
technique en lecture seule. À l’inverse, donner un droit d’écriture ne signifie pas que la mission
explique correctement quand l’utiliser.

## Cycle de vie recommandé

```mermaid theme={null}
flowchart LR
	A["Mission"] --> B["Capacités"]
	B --> C["Périmètre"]
	C --> D["Permissions minimales"]
	D --> E["Tests"]
	E --> F["Partage limité"]
	F --> G["Observation et ajustement"]
```

Commencez avec une audience réduite et des permissions minimales. Après chaque modification de la
mission, du modèle, d’une capacité, du périmètre ou des droits, rejouez les scénarios qui pourraient
être affectés.

## Limites

* Un agent peut mal interpréter une demande ambiguë ou une donnée incomplète.
* Il ne doit pas être considéré comme propriétaire d’une décision métier.
* Son partage ne donne pas automatiquement accès aux sources utilisées.
* Une capacité activée élargit les actions possibles ; elle doit être configurée et testée.
* Les actions sensibles restent soumises aux validations prévues par l’interface et aux droits de
  l’utilisateur.

## Étapes suivantes

> [card] [Configurer le Général](https://docs.alyzai.com/fr/agents/configurer-le-general.md)
>
> Définir une mission testable et une présentation compréhensible.

> [card] [Tester dans la console](https://docs.alyzai.com/fr/agents/tester-dans-la-console.md)
>
> Comprendre dès maintenant ce qui devra être validé.


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