Le but : brancher un dossier Drive (et tous ses sous-dossiers) sur le kit, en 2 minutes, et savoir le vérifier.
1. Le principe
Deux comptes Google doivent pouvoir lire le dossier :
| Adresse | Pourquoi |
|---|---|
rag-kit-sa@<projet>.iam.gserviceaccount.com | Le kit liste le dossier pour savoir ce qui a été ajouté ou supprimé |
service-<numéro>@gcp-sa-vertex-rag.iam.gserviceaccount.com | RAG Engine importe les fichiers |
L'interface affiche ces deux adresses (cliquer pour copier) ; source scripts/config.sh … et
terraform output partager_drive_avec aussi.
Le partage est en lecture seule : le kit ne peut ni modifier ni supprimer vos fichiers Drive.
2. Pas à pas
- Dans Google Drive, clic droit sur le dossier → Partager → Partager.
- Collez la 1re adresse, rôle Lecteur, décochez Envoyer une notification (un compte de service ne lit pas ses mails), Partager. Recommencez avec la 2e adresse.
- Copiez l'URL du dossier (barre d'adresse :
https://drive.google.com/drive/folders/1gYDE…). - Dans l'interface, collez-la dans Dossiers Google Drive → Ajouter.
- Le kit vérifie qu'il voit le dossier ; sinon : « Le kit ne voit pas ce dossier. Partagez-le en lecture avec … ».
- Une synchro démarre aussitôt. Comptez 20 à 60 s pour quelques fichiers.
- Les fichiers apparaissent dans Documents indexés (origine « Drive »).
Partager le dossier « parent » suffit : les sous-dossiers et les fichiers ajoutés plus tard héritent du partage.
Sans l'interface : mettez l'ID dans DRIVE_FOLDERS du fichier .env avant le déploiement (liste séparée par des
espaces). Après le déploiement, la liste se gère dans l'interface (elle est rangée dans gs://<bucket>/config.json).
3. Vérifier
| Où | Ce qu'on doit voir |
|---|---|
| Interface, Synchronisation | À jour · … · N document(s) et Drive « nom » : X ajouté(s) ou modifié(s) |
| Interface, Documents indexés | Les fichiers du dossier et de ses sous-dossiers |
Rapport gs://<bucket>/sync/last.json | "statut": "ok", "non_indexes": [] |
Le piège n°1 (vérifié) : si la 2e adresse (agent RAG) manque dans le partage, RAG Engine ne peut pas lire les
fichiers. Importé « par dossier », il en importe 0 sans aucune erreur ; c'est pourquoi le kit importe fichier
par fichier : RAG Engine répond alors 404 Unable to find some Google Drive resource(s), et le kit affiche le
statut À vérifier avec le message
« Drive « … » : N fichier(s) illisible(s) pour l'agent RAG (…). Partagez le dossier (lecteur) avec service-…@gcp-sa-vertex-rag… ».
Les autres dossiers continuent d'être synchronisés normalement.
4. Ce qui est pris en compte
| Dans Drive, vous… | Dans l'index, au plus tard à la synchro suivante (10 min) |
|---|---|
| ajoutez un fichier (même dans un sous-dossier) | il est indexé |
| modifiez un fichier | il est réindexé (le kit compare la date de modification Drive à la date d'indexation) |
| supprimez un fichier (corbeille) | il est retiré |
| le déplacez hors du dossier | il est retiré |
| retirez le dossier dans l'interface | tous ses fichiers sont retirés |
| retirez le partage avec le kit | rien n'est supprimé (sécurité : une panne de partage ne vide pas l'index) et le rapport affiche « Drive … illisible » |
Types de fichiers : Google Docs, Slides, Sheets, PDF, Word, PowerPoint, texte, HTML, Markdown… (liste complète : types supportés par RAG Engine). Un fichier non supporté (image, vidéo) est simplement compté « en échec » dans le rapport.
5. Drive partagé (Shared Drive) et comptes Workspace
- Drive partagé : ajoutez les deux adresses comme membres (rôle Lecteur) du Drive partagé, ou partagez le
dossier voulu. Le kit liste avec
supportsAllDrives. - Workspace qui interdit le partage externe : les adresses
…iam.gserviceaccount.comsont externes au domaine. Un administrateur doit autoriser le partage avec ces comptes (règle de partage par OU, ou liste d'autorisation). Sinon Drive refuse le partage. Non testé ici (projet sans Workspace).