Files
flowdeck/docs/Guide_Complet_Notion_Agent_2026.md
T
bruno b0d222b81a
FlowDeck CI / test (push) Failing after 5s
FlowDeck CI / docker (push) Has been skipped
Add Notion Agent and FlowDeck integration docs
Document Notion Agent (2026) concepts and a FlowDeck Agent design
that orchestrates tool calls through existing FastAPI routers, plus
a chat UI screenshot.
2026-07-20 14:38:42 -04:00

465 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Guide complet — Notion Agent (2026)
## Introduction
Notion Agent est l'évolution la plus avancée de Notion AI. Contrairement à un assistant conversationnel classique qui répond uniquement à des questions, Notion Agent est conçu pour **agir directement dans votre espace de travail**.
L'objectif est de transformer l'IA d'un simple outil de rédaction en un véritable collaborateur numérique capable d'exécuter des tâches complètes à travers les pages, bases de données et outils connectés.
---
# 1. Qu'est-ce que Notion Agent ?
Notion Agent est un agent IA intégré nativement dans Notion.
Il possède :
- Un accès au contexte de votre espace de travail
- La capacité de lire des pages et bases de données
- La capacité de créer et modifier du contenu
- La possibilité d'effectuer des tâches multi‑étapes
- L'accès à certaines sources externes et outils connectés
Conceptuellement :
Assistant IA traditionnel :
Utilisateur → Prompt → Réponse
Notion Agent :
Utilisateur → Objectif → Planification → Recherche → Actions → Résultat
L'agent agit davantage comme un employé numérique que comme un chatbot.
---
# 2. Où apparaît-il dans l'interface ?
## Emplacement principal
Notion affiche l'agent sous la forme d'une icône circulaire représentant un visage.
Position habituelle :
- Coin inférieur droit de l'écran
Ou :
- Section AI dans la barre latérale gauche
---
## Interface de conversation
Lorsque l'utilisateur ouvre l'agent :
┌──────────────────────────┐
│ Conversation Agent │
├──────────────────────────┤
│ Historique │
│ │
│ Réponses │
│ │
├──────────────────────────┤
│ @Sources │
│ 📎 Fichier │
│ Modèle IA │
│ Zone de saisie │
└──────────────────────────┘
L'interface ressemble à ChatGPT mais avec davantage de contrôles contextuels.
---
# 3. Comment fonctionne l'agent ?
## Étape 1 : Compréhension
L'utilisateur formule un objectif.
Exemples :
- Construis un CRM.
- Résume les notes de réunion du trimestre.
- Crée les OKR du prochain trimestre.
L'agent interprète l'intention.
---
## Étape 2 : Collecte du contexte
Il récupère automatiquement :
- La page actuelle
- Les blocs sélectionnés
- Les bases de données liées
- Les documents référencés
- Les permissions utilisateur
Il fonctionne avec les mêmes permissions que l'utilisateur.
---
## Étape 3 : Raisonnement
L'agent décompose la demande.
Exemple :
Créer un CRM
→ déterminer les propriétés
→ créer la base
→ créer les vues
→ créer les relations
→ générer des exemples
---
## Étape 4 : Action
L'agent modifie directement Notion.
Contrairement à un chatbot traditionnel, il peut :
- créer
- modifier
- organiser
- restructurer
le contenu.
---
# 4. Sources de connaissances
## Sources Notion
L'agent peut consulter :
- Pages
- Sous-pages
- Bases de données
- Wikis
- Documents internes
---
## Sources connectées
Selon la configuration du workspace :
- Jira
- Slack
- Google Drive
- GitHub
- Figma
- Outils connectés compatibles
---
## Fichiers
L'utilisateur peut joindre :
- PDF
- Documents
- Présentations
- Fichiers importés
---
## Mention manuelle
L'utilisateur peut préciser :
@Projet Alpha
ou
@Équipe Marketing
pour forcer l'utilisation d'un contexte particulier.
---
# 5. Ce que Notion Agent peut faire
## Création de contenu
- Pages
- Sous-pages
- Documentation
- SOP
- Guides
- Rapports
- Comptes-rendus
---
## Modification de contenu
- Réécriture
- Résumé
- Traduction
- Simplification
- Restructuration
---
## Bases de données
L'agent peut :
- créer une base
- ajouter des propriétés
- ajouter des relations
- créer des vues
- remplir les données
---
## Recherche documentaire
Il peut analyser :
- des centaines de pages
- plusieurs bases de données
- des documents attachés
pour produire un résultat consolidé.
---
## Analyse
Exemples :
- Identifier les tendances
- Comparer des projets
- Détecter les risques
- Produire des synthèses exécutives
---
## Travail multi‑étapes
Exemple :
« Analyse les incidents des 6 derniers mois et crée un plan d'amélioration. »
L'agent :
1. collecte les incidents
2. les analyse
3. identifie les causes
4. produit un rapport
5. crée les tâches
---
# 6. Fonctionnalités avancées
## Changement de modèle IA
Le sélecteur de modèle permet selon la disponibilité :
- GPT
- Claude
- Gemini
- autres modèles partenaires
Certains modèles peuvent n'utiliser que le Web alors que d'autres exploitent le contexte Notion.
---
## Historique
L'agent conserve l'historique des conversations.
Permet :
- reprendre un travail
- relancer une tâche
- réutiliser un contexte
---
## Instructions personnalisées
L'utilisateur peut définir :
- ton
- style
- format
- règles métier
Exemple :
« Toujours écrire les procédures en format SOP. »
---
## Skills
Notion introduit des compétences réutilisables.
Une skill agit comme un mini‑prompt réutilisable.
Exemples :
- Génération de compte-rendu
- Analyse SWOT
- Préparation de sprint
---
# 7. Ce que l'agent ne peut pas faire
À ce jour, certaines limitations existent.
Il ne peut généralement pas :
- modifier les permissions des pages
- partager des pages
- gérer la facturation
- modifier les paramètres du workspace
- créer certaines propriétés avancées complexes
- créer des rappels système
---
# 8. Différence entre Notion AI et Notion Agent
## Notion AI (ancienne approche)
- Répond
- Résume
- Réécrit
## Notion Agent
- Planifie
- Recherche
- Agit
- Modifie le workspace
- Réalise des tâches complètes
---
# 9. Custom Agents (2026)
Notion a également lancé les Custom Agents.
Différence :
Notion Agent :
- Agent personnel généraliste
Custom Agent :
- Agent spécialisé
Exemples :
- Agent RH
- Agent Support
- Agent Produit
- Agent Marketing
- Agent GitHub
- Agent Reporting
Ces agents peuvent fonctionner automatiquement selon des déclencheurs et horaires.
---
# 10. Cas d'usage réels
## Gestion de produit
- Générer des PRD
- Créer des roadmaps
- Analyser Jira
## Développement logiciel
- Synthèse GitHub
- Documentation technique
- Suivi des bugs
## Marketing
- Rapports de campagne
- Veille concurrentielle
- Création de contenu
## Direction
- OKR
- KPI
- Rapports exécutifs
---
# 11. Architecture conceptuelle
Utilisateur
↓
Notion Agent
↓
Contexte Workspace
↓
Sources Connectées
↓
Moteur IA
↓
Planification
↓
Actions Notion
↓
Résultat
---
# 12. Vision produit
Notion cherche à transformer son produit en système d'exploitation du travail.
L'évolution observée :
2018 → Notes
2020 → Bases de données
2023 → Notion AI
2025 → Notion Agent
2026 → Custom Agents
Direction probable :
- équipes d'agents spécialisés
- automatisation continue
- orchestration inter‑outils
- assistants autonomes de projet
---
# Résumé
Notion Agent est un agent IA intégré profondément dans Notion.
Ses caractéristiques majeures :
- Compréhension du contexte
- Accès aux connaissances du workspace
- Raisonnement multi‑étapes
- Création et modification de contenu
- Gestion des bases de données
- Analyse documentaire
- Personnalisation via instructions et skills
- Intégration avec outils externes
- Possibilité d'évoluer vers des agents spécialisés
Il représente le passage de « l'IA qui répond » à « l'IA qui réalise le travail » directement dans l'environnement Notion.