# Agents

> Les agents spécialisés à l’œuvre dans un flow et les garde-fous qui les maintiennent sur la bonne voie.

Un [flow](https://pentagi.com/fr/docs/glossary/#flow) est exécuté par une équipe d’[agents](https://pentagi.com/fr/docs/glossary/#agent). Chaque [agent type](https://pentagi.com/fr/docs/glossary/#agent-type) possède son propre prompt, ses paramètres de modèle et ses [tools](https://pentagi.com/fr/docs/glossary/#tool), ce qui vous permet d’attribuer des modèles plus puissants ou moins coûteux selon le rôle.

## [Agent types](https://pentagi.com/fr/docs/concepts/agents/#agent-types)

| Agent                   | Rôle                                                                                                                                                          |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `primary_agent`         | Agent de raisonnement principal qui pilote un flow                                                                                                            |
| `assistant`             | Mode [assistant](https://pentagi.com/fr/docs/glossary/#assistant) interactif                                                                                                        |
| `generator`             | Divise chaque [task](https://pentagi.com/fr/docs/glossary/#task) en [subtasks](https://pentagi.com/fr/docs/glossary/#subtask)                                                                             |
| `refiner`               | Affine le plan à mesure que les résultats arrivent                                                                                                            |
| `adviser`               | Conseil expert ; mentor dans le suivi de l’exécution et planificateur dans la planification de task                                                           |
| `reflector`             | Corrige les agents qui cessent de produire des [tool calls](https://pentagi.com/fr/docs/glossary/#tool-call)                                                                        |
| `searcher`              | Collecte d’informations et recherche web                                                                                                                      |
| `enricher`              | Recueille du contexte supplémentaire depuis la [memory](https://pentagi.com/fr/docs/glossary/#memory) et le [sandbox](https://pentagi.com/fr/docs/glossary/#sandbox) avant que l’agent adviser ne réponde |
| `coder`                 | Écrit et analyse du code                                                                                                                                      |
| `installer`             | Installe et configure les tools dans la sandbox                                                                                                               |
| `pentester`             | [Pentest](https://pentagi.com/fr/docs/glossary/#pentest) et évaluation de la sécurité                                                                                               |
| `simple`, `simple_json` | Complétions brutes et structurées en JSON                                                                                                                     |

Deux autres agents travaillent en arrière-plan : le `memorist` répond aux questions des autres agents sur les travaux passés à partir de la memory à long terme, et le `reporter` rédige le résultat de chaque task.

## [Comment le travail est délégué](https://pentagi.com/fr/docs/concepts/agents/#how-work-is-delegated)

```mermaid
sequenceDiagram
  accTitle: How a task is split into subtasks and the primary agent delegates each step to specialist agents through shared memory
  participant G as Generator
  participant O as Primary agent
  participant M as Memorist
  participant S as Specialists
  participant V as Vector store
  G->>O: Subtasks of the task
  O->>M: Past work, when the context lacks it
  M->>V: Search memory
  O->>S: Delegate a step to the searcher, pentester, coder or installer
  S->>V: Store tool results
  S-->>O: Result
```

## [Mesures de protection](https://pentagi.com/fr/docs/concepts/agents/#safeguards)

* **Limites de tool call** (toujours activé) — `MAX_GENERAL_AGENT_TOOL_CALLS` (par défaut 100) limite les tours du modèle dans les chaînes de `primary_agent`, `assistant`, `pentester`, `coder` et `installer`, et `MAX_LIMITED_AGENT_TOOL_CALLS` (par défaut 20) les limite pour les autres agents. Un tour peut appeler plusieurs tools. Les valeurs de 1 à 5 sont ramenées à 6, et 0 ou moins signifie la valeur par défaut.
* **Détection des répétitions** (toujours activée) — à partir du troisième appel consécutif au même outil avec les mêmes arguments, l’outil n’est pas exécuté à nouveau : l’agent reçoit la réponse précédente avec une demande de changer de cap. Le septième appel de ce type met fin à la chaîne.
* **Reflector** (toujours activé) — intervient la première fois qu’un modèle répond sans tool call et guide l’agent vers un appel ; après trois tours infructueux, la chaîne s’arrête.
* **Suivi de l’exécution** (bêta, `EXECUTION_MONITOR_ENABLED`) — pour `primary_agent`, `pentester`, `coder`, `installer` et `assistant` lorsqu’il fonctionne avec des agents, l’adviser agit comme un mentor lorsque l’agent appelle le même tool `EXECUTION_MONITOR_SAME_TOOL_LIMIT` fois de suite (par défaut 5) ou effectue `EXECUTION_MONITOR_TOTAL_TOOL_LIMIT` tool calls depuis le dernier conseil (par défaut 10). Le déclencheur compte les appels plutôt que de détecter un blocage ; l’adviser examine alors la progression de l’agent et recommande s’il faut continuer, changer d’approche ou arrêter.
* **Planification intelligente de task** (bêta, `AGENT_PLANNING_STEP_ENABLED`) — l'agent adviser élabore 3 à 7 étapes concrètes avant que les spécialistes ne commencent une subtask.

> [!NOTE]
> Le suivi de l’exécution et la planification de task doublent approximativement la qualité des résultats pour les modèles de moins de 32 milliards de paramètres, au prix de 2 à 3 fois plus de tokens et de temps. Ils sont désactivés par défaut.

Dans Enterprise, le planner s’exécute toujours et la surveillance de l’exécution est activée par défaut avec des limites de 20 et 40 — voir [Agent profiles](https://pentagi.com/fr/docs/enterprise/agent-profiles/#planner-and-execution-monitor).