Entraîner votre agent IA sur des fichiers Google Drive

Connectez Google Drive à un agent intoCHAT, choisissez des Docs, Sheets, Slides, PDF, fichiers Word, texte et Markdown, gardez-les synchronisés : limites et configuration de l'application Google.

Si vos FAQ, vos grilles tarifaires, vos conditions ou vos fiches produit se trouvent dans Google Drive, vous pouvez choisir ces fichiers pour que votre agent en apprenne le contenu. intoCHAT ne peut ouvrir que les fichiers que vous choisissez. Il les lit et ne modifie jamais rien dans votre Drive.

Ce que vous pouvez importer

Fichier dans Drive	Comment intoCHAT le lit
Google Docs	Exporté en Markdown : les titres et les listes sont conservés (en texte brut si Google ne peut pas exporter en Markdown)
Google Sheets	Chaque feuille, sous forme d'un titre portant le nom de la feuille, suivi de ses lignes en CSV. Jusqu'à 1 000 lignes sont lues par feuille
Google Slides	Exporté en texte brut
PDF	Téléchargé et lu comme un PDF importé
Word (`.docx`)	Téléchargé et lu comme un fichier Word importé
Texte (`.txt`) et Markdown (`.md`)	Téléchargés tels quels

Les autres fichiers, comme les images, les vidéos, les Google Forms ou les dossiers, n'apparaissent pas dans le sélecteur de fichiers. Un PDF scanné sans couche de texte ne peut pas être lu : passez-le d'abord à l'OCR.

Uniquement les fichiers que vous choisissez

intoCHAT ne demande à Google que l'autorisation drive.file. Avec elle, intoCHAT peut ouvrir les fichiers que vous choisissez dans le sélecteur de fichiers de Google, et rien d'autre dans votre Drive :

Il ne peut pas lister, rechercher ni lire vos autres fichiers, dossiers ou drives partagés.
Chaque fichier que vous choisissez est partagé avec intoCHAT par Google au moment où vous le choisissez. Si cet accès a été retiré, choisir de nouveau le fichier plus tard le rétablit.
Sur l'écran d'autorisation de Google, cela apparaît sous la forme « See, edit, create, and delete only the specific Google Drive files you use with this app » (ou son équivalent dans votre langue). intoCHAT se contente de les lire.

Le sélecteur de fichiers lui-même appartient à Google : il affiche votre Drive pour que vous puissiez choisir, mais intoCHAT n'apprend l'existence que des fichiers que vous sélectionnez.

Connecter Google Drive

Ouvrez l'onglet Knowledge (connaissances) de l'agent et choisissez Drive sous Add knowledge.
Cliquez sur Connect Google Drive. L'écran d'autorisation de Google s'ouvre.
Choisissez votre compte Google et autorisez l'accès. Si Google affiche une case à cocher pour Google Drive, laissez-la cochée.
Vous revenez à l'onglet Knowledge, qui affiche « Google Drive connected » et Connected as suivi de votre compte Google.

La connexion est liée à votre compte intoCHAT : tous vos agents peuvent donc importer depuis elle. Un seul compte Google est connecté à la fois ; vous connecter de nouveau le remplace. Si vous annulez sur l'écran de Google, rien n'est connecté. Si vous y restez plus de 10 minutes, recommencez depuis l'option Drive.

Connecter et déconnecter demandent le niveau Manage pour les intégrations : le propriétaire et les admins peuvent donc le faire. Consultez Membres de l'équipe et rôles.

Importer des fichiers

Cliquez sur Add from Google Drive. Le sélecteur de fichiers de Google s'ouvre.
Sélectionnez jusqu'à 10 fichiers. Le sélecteur a un onglet pour votre propre Drive et un autre pour les drives partagés. Les dossiers s'ouvrent pour que vous puissiez choisir les fichiers qu'ils contiennent.
Cliquez sur Select. intoCHAT lit les fichiers, ce qui peut prendre quelques secondes par fichier.

Si des fichiers ont été ajoutés ou mis à jour, l'entraînement démarre de lui-même. Un message résume l'import, par exemple « 3 added, 1 updated, 0 unchanged ». Chaque fichier devient une source de type Google Drive, nommée d'après le fichier, avec un lien vers celui-ci dans Drive et l'heure de sa dernière modification.

Tout ou rien. Si un fichier ne peut pas être lu, ou si les fichiers dépassent la limite de caractères de l'agent, rien n'est importé et vos connaissances restent telles quelles. Le message nomme le fichier quand c'est possible. En cas de dépassement, intoCHAT affiche Character limit reached.
Choisir de nouveau un fichier le met à jour. La source existante reçoit le nouveau texte au lieu d'une seconde copie. Un fichier dont le texte n'a pas changé reste tel quel.
Les fichiers vides sont ignorés et apparaissent comme « skipped (no text) ».
Les grandes feuilles sont tronquées. Seules les 1 000 premières lignes de chaque feuille sont lues, et le message nomme la feuille de calcul. Répartissez une feuille plus grande sur plusieurs feuilles ou fichiers.

Les membres qui ont le niveau Edit pour les connaissances peuvent choisir et importer des fichiers. Ils les choisissent dans le Drive du compte Google connecté : ne donnez donc ce niveau qu'à des personnes à qui vous faites confiance pour cela.

Garder les fichiers à jour

Le texte importé ne change pas quand vous modifiez le fichier dans Drive. Pour prendre en compte vos modifications :

Cliquez sur Sync now dans l'option Drive. intoCHAT vérifie quand chacun des fichiers Drive de l'agent a été modifié pour la dernière fois et ne relit que ceux qui ont changé. Seuls les fichiers dont le texte a changé sont réentraînés.
Activez l'Auto-resync. Chaque jour ou chaque semaine, intoCHAT fait cette même vérification pour vous. Les fichiers Drive ne consomment pas d'exploration du site, et un passage lit jusqu'à 30 fichiers Drive. Voir Auto-resync.
Choisissez de nouveau le fichier avec Add from Google Drive.

Un fichier renommé dans Drive prend son nouveau nom à la vérification suivante.

Si un fichier a été supprimé, placé dans la corbeille, ou si intoCHAT n'a peut-être plus le droit de l'ouvrir, la vérification échoue avec un message sur la source, et le texte enregistré reste dans vos connaissances. Choisissez de nouveau le fichier, ou supprimez la source si vous n'en voulez plus.

Limites

Limite	Valeur
Fichiers par import	10
Taille de fichier (PDF, Word, texte, Markdown)	50 Mo, comme pour les fichiers importés
Texte par fichier	4 Mo, comme pour les fichiers importés
Google Docs et Slides	Ce que Google peut exporter : jusqu'à 10 Mo de texte
Google Sheets	1 000 lignes par feuille
Caractères	Comptent dans la limite de caractères de l'agent, comme toute source. Voir Offres et limites

Les fichiers Drive restent privés

Les fichiers Drive n'apparaissent jamais comme liens vers les sources sous une réponse. Seules les pages web ont des liens.
L'agent voit le nom d'un fichier, mais pas son adresse Drive : il ne peut donc pas transmettre le lien aux visiteurs.
intoCHAT enregistre son accès à votre compte Google sous forme chiffrée, et le navigateur ne reçoit jamais qu'un accès de courte durée pour le sélecteur de fichiers.

Déconnecter Google Drive

Cliquez sur Disconnect (déconnecter) dans l'option Drive. Dans la boîte de dialogue, vous choisissez ce que deviennent les fichiers importés :

Les garder (par défaut). Ils restent dans les connaissances de tous vos agents, tels qu'ils sont, mais ne sont plus synchronisés. L'Auto-resync les signale avec « Google Drive was disconnected. Connect Google Drive and pick this file again to keep it in sync. »
Also delete the … files imported from Google Drive, in all your agents. Cochez cette case pour les supprimer aussi.

intoCHAT révoque son accès chez Google et supprime l'accès enregistré. Vous pouvez aussi retirer intoCHAT dans votre compte Google, sous Security → Third-party apps & services. Si vous le faites seulement là, la vérification suivante affiche « Google Drive access was revoked or has expired. Reconnect Google Drive to keep this file in sync. »

En cas de problème

Message	Que faire
« Google Drive isn't configured on this server. »	Google Drive n'est pas configuré pour cette installation. Importez plutôt les fichiers sous Files, ou configurez l'application Google comme décrit ci-dessous.
« Google didn't grant access to the files you pick. »	Connectez-vous de nouveau et laissez la case Google Drive cochée sur l'écran de Google.
« This file was deleted in Google Drive, or intoCHAT can no longer open it. »	Choisissez de nouveau le fichier dans Google Drive, ou supprimez la source.
« This file is in the Google Drive trash. »	Restaurez-le dans Drive, ou supprimez la source.
« intoCHAT is no longer allowed to open this file. »	Demandez l'accès au propriétaire du fichier, puis choisissez-le de nouveau.
« The file's owner turned off downloading, so intoCHAT can't read it. »	Demandez au propriétaire d'autoriser le téléchargement, ou faites-en une copie qui vous appartient.
« Google can't export this file because it is too large »	Divisez le Doc ou les Slides en fichiers plus petits.
« Google Drive is limiting requests right now. »	Attendez quelques minutes, puis réessayez.
Reconnect Google Drive apparaît	L'accès d'intoCHAT a été révoqué ou a expiré. Cliquez dessus pour vous reconnecter.

Configurer l'application Google

Cette section s'adresse à la personne qui gère l'installation d'intoCHAT. Les clients d'intoCHAT n'en ont pas besoin.

Google Drive a besoin d'un client OAuth, d'une clé API et du numéro de projet, tous issus d'un même projet Google Cloud :

Dans la console Google Cloud, créez un projet ou choisissez-en un.
Sous APIs & Services → Library, activez la Google Drive API et la Google Picker API.
Sous Google Auth Platform, configurez l'écran d'autorisation : le nom de l'application, une adresse e-mail d'assistance, votre domaine et les liens vers votre politique de confidentialité et vos conditions. Choisissez External comme audience. Sous Data access, ajoutez le champ d'accès https://www.googleapis.com/auth/drive.file. C'est un champ d'accès non sensible : l'application n'a donc besoin que de la vérification de base de la marque par Google, et non de l'évaluation de sécurité exigée pour les champs d'accès restreints.
Sous Clients (ou Credentials → Create credentials → OAuth client ID), créez un client de type Web application :
- Authorized redirect URI : l'adresse de votre application suivie de /api/integrations/google-drive/callback, par exemple https://www.example.com/api/integrations/google-drive/callback. Elle doit correspondre exactement à NEXT_PUBLIC_APP_URL.
- Authorized JavaScript origin : l'adresse de votre application, par exemple https://www.example.com.
- Enregistrez l'identifiant client dans GOOGLE_DRIVE_CLIENT_ID et le secret client dans GOOGLE_DRIVE_CLIENT_SECRET.
Sous Credentials → Create credentials → API key, créez une clé pour le sélecteur de fichiers. Limitez-la à Websites avec l'adresse de votre application, et à la Google Picker API. Enregistrez-la dans NEXT_PUBLIC_GOOGLE_DRIVE_API_KEY.
Copiez le project number (et non l'ID du projet) depuis le tableau de bord du projet ou depuis IAM & Admin → Settings, et enregistrez-le dans NEXT_PUBLIC_GOOGLE_DRIVE_APP_ID. Ce doit être le projet du client OAuth : Google accorde les fichiers choisis à cette application.
Redéployez. Quand les quatre réglages sont présents, l'option Drive propose Connect Google Drive.

Les jetons sont chiffrés avec TOKEN_ENCRYPTION_KEY (ou NEXTAUTH_SECRET s'il n'est pas défini). Changer ce secret rend les connexions enregistrées illisibles, et les propriétaires doivent se reconnecter.

Tant que l'écran d'autorisation est en mode Testing, seuls les utilisateurs de test que vous ajoutez peuvent se connecter, et Google fait expirer leur accès au bout de 7 jours. Publiez l'application en mode In production pour tout le monde.