Intégration Document360
Connectez Document360 pour accéder aux articlés et catégories de votre base de connaissances directement dans vos conversations IA. GPT Workbench s'intègre à Document360 pour injecter le contenu documentaire dans vos fils sous forme de blocs de contexte et via des outils de recherche, permettant des réponses IA fondées sur votre documentation officielle.
Présentation
Document360 est une plateforme de base de connaissances utilisée par les équipes support, produit et documentation pour maintenir une documentation structurée. L'intégration GPT Workbench offre deux fonctionnalités :
- Blocs de contexte -- Attachez des articlés spécifiques ou des catégories entières de votre base de connaissances Document360 à un fil. L'IA reçoit le contenu complet des articlés et peut le référencer tout au long de la conversation.
- Outils -- Activez les outils Document360 pour permettre à l'IA de rechercher et récupérer des articlés à la demande pendant une conversation.
Cette intégration est particulièrement précieuse pour les équipes de support client qui souhaitent des réponses IA fondées sur la documentation officielle, et pour les équipes produit qui veulent référencer des spécifications sans quitter la conversation.
Configuration
Prérequis
- L'administrateur de votre organisation à activé l'intégration Document360
- Vous disposez d'un compte Document360 avec accès API
- Votre projet Document360 contient des articlés publiés
Connecter votre compte
- Allez dans Paramètres > Intégrations
- Localisez la section Document360 et cliquez sur Connecter
- Authentifiez-vous avec vos identifiants Document360
- Sélectionnez le projet à connecter (si vous avez plusieurs projets)
- Une coche verte confirme la connexion
Configuration par clé API
Certaines organisations connectent Document360 via une clé API plutôt que par OAuth. Dans ce cas, l'administrateur de votre organisation fournit la clé API via le panneau d'administration. Les utilisateurs individuels n'ont aucune configuration à effectuer.
Déconnexion
Pour déconnecter :
- Allez dans Paramètres > Intégrations
- Cliquez sur Déconnecter à côté de Document360
- Confirmez la déconnexion
Les blocs de contexte existants référençant le compte déconnecté afficheront une erreur de connexion.
Blocs de contexte
Les blocs de contexte Document360 injectent le contenu de la base de connaissances dans le contexte de votre fil. L'IA reçoit le texte complet des articlés et peut le référencer dans chaque réponse.
Ajouter un contexte Document360
- Ouvrez Gérer le contexte dans votre fil
- Allez dans l'onglet Ajouter nouveau
- Cliquez sur Document360
- Parcourez l'arborescence des catégories ou recherchez des articlés par titre ou mot-clé
- Sélectionnez des articlés ou des catégories à inclure
- Cliquez sur Ajouter le contexte
Articlés et catégories
Le contenu Document360 est organisé en catégories (dossiers) contenant des articlés. Lors de l'ajout de contexte, vous pouvez sélectionner l'un ou l'autre :
Articlés -- Articlés individuels de la base de connaissances. Chaque article apparaît avec un badge bleu dans la liste de contexte. L'IA reçoit le contenu complet de l'article, y compris les sections structurées, tableaux et blocs de code.
Catégories -- Sections documentaires entières. Chaque catégorie apparaît avec un badge ambre dans la liste de contexte. Lorsqu'une catégorie est sélectionnée, tous les articlés qu'elle contient (et ses sous-catégories) sont inclus. Ceci est utile lorsque l'IA à besoin d'une couverture complète d'un domaine.
| Type de sélection | Couleur du badge | Contenu inclus |
|---|---|---|
| Article | Bleu | Contenu d'un seul article |
| Catégorie | Ambre | Tous les articlés de la catégorie et sous-catégories |
Durée du cache
Le contenu Document360 est mis en cache après la récupération initiale. Configurez la durée du cache selon la fréquence de mise à jour de votre documentation :
| Durée | Cas d'usage |
|---|---|
| 1 heure | Documentation activement maintenue avec des mises à jour fréquentes |
| 24 heures | Documentation stable (par défaut) |
| 7 jours | Documentation de référence rarement modifiée |
Pour ajuster, éditez le bloc de contexte et modifiez le paramètre Durée du cache.
Formatage du contenu
Le contenu des articlés est transmis à l'IA au format Markdown propre. Les éléments de contenu enrichi de Document360 sont préservés :
- Titres et structure des sections
- Listes ordonnées et non ordonnées
- Tableaux
- Blocs de code avec coloration syntaxique
- Encadrés et avertissements
- Liens internes (résolus en titres d'articlés)
Les images et médias intégrés sont exclus de la représentation textuelle, car ils ne peuvent pas être traités comme contexte textuel.
Outils disponibles
Les outils Document360 permettent à l'IA de rechercher et récupérer du contenu de la base de connaissances dynamiquement pendant une conversation.
Activer les outils Document360
- Ouvrez votre fil
- Cliquez sur le bouton Outils dans la barre d'outils
- Recherchez "Document360" dans la grille des outils disponibles
- Activez les outils Document360
Fonctionnalités des outils
| Outil | Description |
|---|---|
| Recherche d'articlés | Rechercher des articlés par mot-clé, titre ou contenu dans toute la base de connaissances |
| Parcourir les catégories | Lister les catégories et leurs articlés pour une navigation structurée |
| Lire un article | Récupérer le contenu complet d'un article spécifique par ID ou slug |
Différences entre outils et blocs de contexte
- Les blocs de contexte fournissent à l'IA un accès persistant à des articlés spécifiques tout au long de la conversation. Le contenu est toujours présent dans le prompt.
- Les outils permettent à l'IA de rechercher et récupérer des articlés à la demande. C'est plus efficient en tokens lorsque vous ne savez pas à l'avancé quels articlés seront pertinents.
Pour une couverture large d'un sujet, utilisez un bloc de contexte de catégorie. Pour des recherches ciblées à la demande, utilisez les outils.
Cas d'usage
Automatisation du support
Fondez les réponses IA sur votre documentation officielle. Attachez les catégories de documentation produit pertinentes en contexte et demandez à l'IA de répondre aux questions des clients en utilisant uniquement le contenu de la base de connaissances fourni.
Exemple de prompt : "En utilisant la documentation produit attachée, rédige une réponse à cette question client : Comment configurer le SSO avec SAML ?"
Recherche documentaire
Activez les outils Document360 pour permettre à l'IA de rechercher dans votre base de connaissances pendant une conversation. Ceci est utile pour gérer des questions diverses couvrant plusieurs domaines documentaires.
Exemple de prompt : "Recherche dans notre base de connaissances les articlés sur les limités de débit API et résume les politiques actuelles."
Réponses fondées sur la documentation
Combinez le contexte Document360 avec d'autres sources de données. Attachez la documentation produit en parallèle d'un ticket de support client pour générer des réponses référençant des articlés spécifiques et fournissant des conseils techniques précis.
Exemple de prompt : "Examine ce ticket de support et rédige une réponse. Référence des articlés spécifiques de notre base de connaissances le cas échéant."
Contenu d'intégration
Chargez la documentation d'intégration dans un fil pour créer un assistant de formation interactif. Les nouveaux membres de l'équipe peuvent poser des questions et recevoir des réponses fondées sur vos procédures et directives officielles.
Analyse des lacunes documentaires
Attachez une catégorie de documentation et demandez à l'IA d'identifier les sujets manquants, les incohérences ou le contenu obsolète par rapport à une liste de couverture attendue.
Exemple de prompt : "Examine la catégorie documentation API. Compare avec cette liste d'endpoints et identifié ceux qui ne sont pas documentés."
Bonnes pratiques
- Utilisez les catégories pour la largeur, les articlés pour la profondeur -- Lorsque la conversation couvre un sujet large, attachez la catégorie. Lorsqu'elle se concentre sur une procédure spécifique, attachez des articlés individuels.
- Combinez avec les prompts système -- Définissez un prompt système demandant à l'IA de citer ses sources documentaires et de n'utiliser que les informations de la base de connaissances fournie.
- Définissez des durées de cache appropriées -- Adaptez le cache à la fréquence de mise à jour de votre documentation. Une documentation activement maintenue bénéficie de caches plus courts.
- Surveillez la consommation de tokens -- Les catégories contenant de nombreux articlés peuvent consommer beaucoup de tokens. Vérifiez l'indicateur d'utilisation du contexte lors de l'ajout de catégories volumineuses.
- Utilisez les outils pour les requêtes imprévisibles -- Lorsque vous ne pouvez pas anticiper quels articlés seront pertinents, activez les outils Document360 au lieu de pré-charger du contexte.
Dépannage
| Problème | Solution |
|---|---|
| Erreur "Connexion expirée" | Réautorisez Document360 dans Paramètres > Intégrations |
| Articlés absents des résultats | Vérifiez que les articlés sont publiés (les brouillons ne sont pas indexés) |
| Contenu d'article vide | Vérifiez que l'article à du contenu dans la version connectée du projet |
| Catégorie sans articlés | Vérifiez que la catégorie contient des articlés publiés dans Document360 |
Documentation associée
- Blocs de contexte -- Documentation complète des blocs de contexte
- Vue d'ensemble des outils -- Fonctionnement des outils dans GPT Workbench
- Outils MCP -- Outils Model Context Protocol
- Équipes -- Gestion des équipes et collaboration