# Notion

> Donnez à un agent l'accès à des pages et bases de données Notion précises, pour les lire, les interroger et écrire de nouvelles pages.

Le connecteur Notion permet à un agent de faire des recherches dans votre espace de travail, de lire des pages en texte brut, d'interroger des bases de données, et de créer des pages ou de les compléter.

## Quand l'utiliser

Notion, c'est là que les équipes conservent le contexte qu'il faudrait sinon expliquer à un agent : spécifications, comptes rendus de réunion, suivis de projet. Un agent qui peut le lire cesse de vous demander le contexte, et peut ranger son travail là où le reste de l'équipe regarde déjà.

## Connecter Notion

<Steps>

1. **Ouvrez Connecteurs** dans [Agent Builder](/fr/docs/build/agent-builder/) et choisissez Notion.

2. **Connectez-vous et choisissez ce que vous partagez.** L'écran de consentement de Notion demande à quelles pages l'intégration peut accéder : c'est lui qui contrôle l'accès, et il se trouve du côté de Notion.

3. **Associez la connexion à l'agent.**

</Steps>

<Aside type="caution" title="Des résultats vides signifient généralement qu'une page n'a pas été partagée">
  Une recherche qui ne trouve rien vient plus souvent d'un problème de partage que d'une
  faute d'orthographe. Si une page n'a pas été incluse lors de l'autorisation, ou a été
  créée ensuite, partagez-la avec l'intégration depuis le menu de la page dans Notion.
</Aside>

## Ce qu'un agent peut faire

| Opération | Soumise à approbation |
| --- | --- |
| Rechercher des pages et des bases de données par titre | Non |
| Lire une page en texte brut, listes imbriquées et blocs dépliables compris | Non |
| Interroger une base de données en filtrant sur une propriété | Non |
| Créer une page sous une page ou dans une base de données | Non |
| Ajouter du contenu à une page existante | Non |

Rien n'est soumis à approbation par défaut dans Notion, car aucune de ces opérations n'envoie quoi que ce soit vers l'extérieur ni ne supprime de données. La création et l'ajout modifient bien votre espace de travail : l'agent a pour consigne de confirmer d'abord avec vous l'emplacement et le titre, mais le garde-fou d'[approbation](/fr/docs/work/approvals/) ne l'arrête pas.

## Bien l'utiliser

- **Commencez par une recherche.** Un agent a besoin de l'identifiant d'une page avant de pouvoir la lire ou la compléter : une consigne vague comme *« mets à jour la page de la feuille de route »* coûte donc une étape de recherche. Coller le lien de la page est plus rapide.
- **Les pages très longues sont tronquées.** La lecture d'une page renvoie tout ce qui tient, et signale que le reste a été coupé. Pour un long document, indiquez la section à l'agent.
- **Les requêtes de base de données filtrent sur une seule propriété.** Mieux vaut construire les vues complexes à conditions multiples dans Notion, et laisser l'agent lire le résultat.

## Limites

- L'agent ne voit que ce que vous avez partagé avec l'intégration dans Notion.
- La lecture renvoie du texte brut. Les structures propres à Notion (bases de données intégrées aux pages, blocs synchronisés, mises en page complexes) sont aplaties, et la mise en forme ne survit pas exactement à un aller-retour.
- Il n'existe pas d'opération de suppression.
- Les pages créées par l'agent appartiennent à l'intégration Notion, et apparaissent comme telles dans l'historique de la page.

## Voir aussi

<CardGrid>
  <LinkCard
    title="Présentation des connecteurs"
    href="/fr/docs/connect/overview/"
    description="Connexion et association, et révocation de l'accès."
  />
  <LinkCard
    title="Projets"
    href="/fr/docs/capabilities/projects/"
    description="Garder le contexte dans endue au lieu d'aller le chercher à chaque fois."
  />
  <LinkCard
    title="Connecteurs disponibles"
    href="/fr/docs/connect/available-connectors/"
    description="Linear, GitLab et le reste du catalogue."
  />
</CardGrid>