Connectez votre espace de travail Notion
- Accédez à la page Agent de votre Dashboard.
- Dans la section “Agent settings”, cliquez sur Install Notion app.
- Suivez les instructions pour autoriser Mintlify à accéder à votre espace de travail Notion.
- Sur l’écran d’autorisation de Notion, sélectionnez les pages et les bases de données à partager avec Mintlify.
Ce que l’agent peut faire avec Notion
- Rechercher dans Notion : Trouver des pages et des bases de données pertinentes dans votre espace de travail Notion connecté, en fonction du contexte de votre demande.
- Lire des pages Notion : Accéder au contenu des pages Notion pour l’utiliser comme matériel de référence lors de la génération de documentation.
- Consulter des bases de données : Extraire des données structurées des bases de données Notion pour alimenter les mises à jour de documentation.
Cas d’utilisation
- Synchroniser les spécifications produit avec la documentation : Consulter les documents d’exigences produit et les spécifications de conception stockés dans Notion lors de la rédaction de la documentation des fonctionnalités.
- Documenter à partir de notes de réunion : Indiquer à l’agent des notes de réunion ou des journaux de décisions dans Notion pour rédiger de la documentation à partir des discussions de l’équipe.
- S’appuyer sur les bases de connaissances internes : Utiliser les wikis internes et les bases de connaissances dans Notion comme matériel source pour la documentation destinée au public.
Bonnes pratiques
- Délimitez l’accès avec soin : N’accordez l’accès qu’aux pages et bases de données Notion contenant des informations pertinentes pour votre documentation.
- Fournissez des références spécifiques : Lorsque vous donnez des instructions à l’agent, mentionnez la page ou la base de données Notion spécifique que vous souhaitez qu’il consulte pour obtenir de meilleurs résultats.
- Relisez le contenu généré : Relisez toujours les pull requests (demandes de fusion) pour vous assurer que les informations provenant de Notion ont été correctement adaptées pour votre documentation publique.