# 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.

> L'option **Drive** sous **Add knowledge** affiche « Google Drive isn't configured on this server. » quand Google Drive n'a pas été configuré pour cette installation d'intoCHAT. Vous pouvez toujours télécharger les fichiers depuis Google Drive en PDF, en Word ou en texte et les importer comme [fichiers](/fr/docs/files). Si vous gérez vous-même l'installation, consultez [Configurer l'application Google](#configurer-l-application-google).

## 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

1. Ouvrez l'onglet **Knowledge** (connaissances) de l'agent et choisissez **Drive** sous **Add knowledge**.
2. Cliquez sur **Connect Google Drive**. L'écran d'autorisation de Google s'ouvre.
3. Choisissez votre compte Google et autorisez l'accès. Si Google affiche une case à cocher pour Google Drive, laissez-la cochée.
4. 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](/fr/docs/team).

## Importer des fichiers

1. Cliquez sur **Add from Google Drive**. Le sélecteur de fichiers de Google s'ouvre.
2. 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.
3. 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](/fr/docs/managing-sources#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](/fr/docs/plans-and-limits) |

## 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.

> Tout ce qui se trouve dans les connaissances de l'agent peut se retrouver dans une réponse. N'importez que des fichiers dont vous partageriez le texte avec vos visiteurs.

## 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 :

1. Dans la [console Google Cloud](https://console.cloud.google.com/), créez un projet ou choisissez-en un.
2. Sous **APIs & Services → Library**, activez la **Google Drive API** et la **Google Picker API**.
3. 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.
4. 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`.
5. 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`.
6. 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.
7. 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.