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.
This commit is contained in:
@@ -0,0 +1,464 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user