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

# Paramètres des agents

> La section Agent de l'interface d'administration permet aux administrateurs de configurer et gérer les Agents disponibles pour leur organisation.

## Vue d'ensemble

Un Agent par défaut est automatiquement créé lors de la création d'une entreprise, garantissant que les utilisateurs disposent immédiatement d'un assistant fonctionnel.

> **Historique de la nomenclature** : à partir de la version Victorious Vicuna (janvier 2026), « Chat Settings » a été renommé en « Agent Settings ». Avec la version Wise Wolf, la fonctionnalité **Multi-Agent** permet désormais de créer et gérer plusieurs Agents par organisation.

## Créer et configurer un Agent

Un administrateur (System Admin, Account Manager ou Company Admin) peut créer des Agents depuis le panneau d'administration avec les paramètres suivants :

### Paramètres généraux

* **Nom et description** : identifient l'Agent dans l'interface utilisateur et la page de découverte.
* **Instruction (prompt système)** : définit le comportement de l'Agent pour tous les utilisateurs qui y ont accès.
* **Modèle par défaut** : spécifie quel modèle IA est utilisé par cet Agent.
* **Entreprise** : l'entreprise liée à cet Agent.
* **Email de support** : adresse email à laquelle les rapports de bug seront envoyés lorsque les utilisateurs soumettent un signalement.

### Outils et capacités

* **Agent Tools** : gestion des outils disponibles pour cet Agent (ex : Search Documents, Search Visual).
* **Agent MCP Servers** : configuration des serveurs MCP disponibles pour cet Agent (ex : Web Search Linkup).

### Appartenance de l'Agent

Lors de la création d'un Agent, un administrateur doit choisir son **appartenance** (ownership), qui détermine qui peut y accéder. L'appartenance est définie à la création et **ne peut pas être modifiée** par la suite.

| Appartenance | Qui peut y accéder                      | Équipe requise ?                                |
| :----------- | :-------------------------------------- | :---------------------------------------------- |
| **Personal** | Le créateur uniquement                  | Non                                             |
| **Company**  | Tous les utilisateurs de l'organisation | Non                                             |
| **Team**     | Les membres d'une équipe spécifique     | Oui — sélectionner l'équipe cible à la création |

Les utilisateurs non-administrateurs peuvent uniquement créer des Agents **Personal**.

<Info>
  Le champ `ownership` (Personal, Company, Team) a été introduit dans **Xenial Xerus** (mars 2026) comme raccourci pour simplifier la création d'agents. Sur les versions antérieures, le même contrôle d'accès est obtenu en passant directement le `group_id` approprié : groupe personnel de l'utilisateur pour un agent Personal, groupe global de l'organisation pour un agent Company, ou groupe d'une équipe spécifique pour un agent Team.
</Info>

### Périmètre documentaire

* **Documents et Workspaces** : sélection des sources documentaires auxquelles l'Agent peut accéder pour rechercher et citer des informations.

#### Restriction des Workspaces

Par défaut, un Agent partagé (Company ou Team) peut accéder à **tous les workspaces appartenant à son équipe**. Vous pouvez optionnellement restreindre cela à un sous-ensemble de workspaces via le paramètre **Workspace Restriction**, configurable après la sauvegarde de l'Agent.

Lorsqu'une restriction de workspaces est définie, l'Agent ne recherche et ne cite que les documents de ces workspaces — indépendamment de ce que les utilisateurs passent dans leurs requêtes.

<Info>
  La restriction des Workspaces est disponible à partir de **Xenial Xerus** (mars 2026). Sur les versions antérieures, les agents accèdent toujours à l'ensemble des workspaces de leur groupe associé.
</Info>

### Contrôle d'accès

* **Équipes** : déterminée automatiquement par l'appartenance choisie à la création. Définit quels utilisateurs peuvent voir et utiliser cet Agent — un élément central de la **gouvernance des données**.

## Visualiser les Agents

La page **Agent Settings** dans l'administration affiche l'ensemble des Agents associés à l'organisation. Les administrateurs peuvent y voir et gérer tous les Agents, indépendamment des équipes auxquelles ils sont attribués.

> **Côté utilisateur** : les utilisateurs voient uniquement les Agents auxquels ils ont accès via leurs équipes, depuis l'interface de chat et la page de découverte des Agents.

## Agent par défaut vs Agents spécialisés

Chaque organisation dispose d'un **Agent par défaut** (« Mon Assistant ») qui est automatiquement sélectionné lors de la création d'une nouvelle session. Les Agents supplémentaires créés par les administrateurs sont des **Agents spécialisés** que les utilisateurs peuvent sélectionner manuellement.

## Résumé des permissions

| Action                                                            | Utilisateur | Administrateur |
| :---------------------------------------------------------------- | :---------- | :------------- |
| Créer un Agent Personal                                           | ✅           | ✅              |
| Créer un Agent Company (toute l'organisation)                     | ❌           | ✅              |
| Créer un Agent Team (groupe spécifique)                           | ❌           | ✅              |
| Configurer les outils, MCP, documents, restriction des workspaces | ❌           | ✅              |
| Utiliser un Agent (si accès via appartenance/groupe)              | ✅           | ✅              |
| Gérer ses favoris                                                 | ✅           | ✅              |
| Voir les Agents auxquels on a accès (interface de chat)           | ✅           | ✅              |
| Voir tous les Agents de l'organisation (admin)                    | ❌           | ✅              |

## Bonnes pratiques

* **Nommez vos Agents clairement** : un nom et une description explicites aident les utilisateurs à choisir le bon Agent (ex : « Assistant RH — Congés et paie », « Veille réglementaire — Secteur bancaire »).
* **Limitez le périmètre documentaire** : un Agent qui accède à un ensemble ciblé de documents produira des réponses plus pertinentes qu'un Agent avec accès à tout.
* **Utilisez les équipes pour la gouvernance** : attribuez chaque Agent aux équipes concernées pour garantir que seuls les utilisateurs habilités accèdent aux documents associés.