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

# Cadrer le périmètre de données

> Les collections et vues auxquelles l’agent accède — la borne de son comportement.

> [!NOTE]
>
> Tutoriel · 8 min

## Résultat attendu

Vous allez sélectionner les collections, tables ou vues strictement nécessaires à la mission. À la
fin, l’agent doit répondre à partir d’une source autorisée et refuser ou demander une autre source
lorsqu’une demande sort de ce périmètre.

## Avant de commencer

* Listez les informations réellement nécessaires à chaque capacité.
* Repérez une source autorisée et une source volontairement hors périmètre pour les tests.
* Vérifiez la qualité des titres et descriptions des ressources afin de ne pas sélectionner un
  homonyme.
* Commencez avec le périmètre le plus étroit qui permet le scénario nominal.

**1. Ouvrez l’onglet Périmètre**

Ouvrez le configurateur de l’agent puis **Périmètre de données**. Cet onglet détermine ce que
l’agent peut consulter ; il ne remplace pas les permissions d’action.

![Onglet Périmètre de données du configurateur](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/agents/perimetre-ouvrir.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=69c4a63773eb667259c3c391e8b42f65)

L’onglet Périmètre de données centralise les ressources consultables par l’agent.

**2. Ajoutez une première source**

Sélectionnez la collection, la table ou la vue qui couvre le scénario principal. Contrôlez
son nom, son contenu et son espace d’origine. Si une collection contient plusieurs documents,
décidez si l’ensemble est réellement nécessaire.

![Sélection des collections autorisées dans le périmètre d’un agent](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/agents/perimetre.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=165925215c46661616b4c18b507f5797)

La sélection rend explicites les collections et vues autorisées pour la mission.

**3. Retirez les ressources inutiles**

Pour chaque source, formulez une demande qui prouve son utilité. Si aucun scénario n’en
dépend, retirez-la. Un périmètre étroit réduit les réponses issues de la mauvaise ressource et
facilite la revue des accès.

![Périmètre limité au strict nécessaire](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/agents/perimetre-minimal.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=db36192b5338a4790a291e2d9523a65f)

Le périmètre final conserve uniquement les ressources nécessaires aux scénarios validés.

**4. Enregistrez puis testez les bornes**

Enregistrez, ouvrez l’onglet **Test** et demandez une information présente dans la source
autorisée. Posez ensuite une question similaire sur la source hors périmètre. L’agent ne doit
pas inventer une réponse ni utiliser silencieusement une autre ressource.

> [!NOTE]
>
> Le périmètre répond à **quoi l’agent peut consulter**. Les permissions répondent à **ce qu’il
> peut faire**. Une table sélectionnée pour la lecture ne doit pas être considérée comme une
> destination d’écriture sans capacité et permission explicites.

## Vérification finale

* Une demande nominale utilise la bonne source et permet d’en retrouver l’origine.
* Une demande hors périmètre déclenche un refus ou une demande de précision.
* Aucune ressource n’est présente sans scénario associé.
* Le partage futur de l’agent n’élargira pas automatiquement les droits sur les sources.

## En cas de problème

| Symptôme | Contrôle recommandé |
| - | - |
| Une collection ou table est introuvable | Vérifiez le workspace, votre accès et l’état de la ressource. |
| L’agent cite une source inattendue | Retirez les ressources inutiles et rendez la mission plus explicite. |
| La source est sélectionnée mais illisible | Contrôlez ses permissions et celles du compte utilisé pour le test. |
| L’agent répond malgré une source absente | Ajoutez un test négatif et exigez un refus lorsque la preuve n’est pas disponible. |
| Le périmètre devient difficile à relire | Scindez la mission entre plusieurs agents spécialisés. |

## Étape suivante

> [card] [Régler les permissions](https://docs.alyzai.com/fr/agents/regler-les-permissions.md)
>
> Définir comment l’agent peut utiliser ce périmètre.


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