Entrena a tu agente de IA con archivos de Google Drive

Conecta Google Drive a un agente de intoCHAT, elige documentos, hojas de cálculo, presentaciones, PDF, Word, archivos de texto y Markdown, mantenlos sincronizados, los límites y cómo configurar la app de Google.

Si tus preguntas frecuentes, listas de precios, políticas o fichas de producto están en Google Drive, puedes elegir esos archivos y tu agente aprende de ellos. intoCHAT solo puede abrir los archivos que eliges. Los lee y nunca cambia nada en tu Drive.

Qué puedes importar

Archivo en Drive	Cómo lo lee intoCHAT
Google Docs	Se exporta como Markdown, así que se conservan los encabezados y las listas (texto plano si Google no puede exportar Markdown)
Google Sheets	Cada hoja, como un encabezado con el nombre de la hoja y sus filas en CSV. Se leen hasta 1.000 filas por hoja
Google Slides	Se exporta como texto plano
PDF	Se descarga y se lee como un PDF subido
Word (`.docx`)	Se descarga y se lee como un archivo de Word subido
Texto (`.txt`) y Markdown (`.md`)	Se descargan tal cual

Otros archivos, como imágenes, vídeos, formularios de Google o carpetas, no aparecen en el selector de archivos. Un PDF escaneado sin capa de texto no se puede leer; pásalo antes por un programa de OCR.

Solo los archivos que eliges

intoCHAT solo pide a Google el permiso drive.file. Con él, intoCHAT puede abrir los archivos que eliges en el selector de archivos de Google, y nada más de tu Drive:

No puede listar, buscar ni leer tus otros archivos, carpetas ni unidades compartidas.
Google comparte con intoCHAT cada archivo que eliges en el momento en que lo eliges. Si el acceso se retiró, vuelves a darlo eligiendo el archivo de nuevo.
En la pantalla de consentimiento de Google aparece como «See, edit, create, and delete only the specific Google Drive files you use with this app». intoCHAT solo los lee.

El selector de archivos en sí es de Google: muestra tu Drive para que puedas elegir, pero intoCHAT solo se entera de los archivos que seleccionas.

Conectar Google Drive

Abre la pestaña Knowledge (conocimiento) del agente y elige Drive en Add knowledge.
Haz clic en Connect Google Drive. Se abre la pantalla de consentimiento de Google.
Elige tu cuenta de Google y permite el acceso. Si Google muestra una casilla para Google Drive, déjala marcada.
Vuelves a la pestaña Knowledge, que muestra «Google Drive connected» y Connected as con tu cuenta de Google.

La conexión pertenece a tu cuenta de intoCHAT, así que todos tus agentes pueden importar desde ella. Solo hay una cuenta de Google conectada a la vez; conectar de nuevo la sustituye. Si cancelas en la pantalla de Google, no se conecta nada. Si tardas más de 10 minutos en ella, empieza de nuevo desde la opción Drive.

Conectar y desconectar requiere el nivel Manage en integraciones, así que pueden hacerlo el propietario y los admins. Consulta Miembros del equipo y roles.

Importar archivos

Haz clic en Add from Google Drive. Se abre el selector de archivos de Google.
Selecciona hasta 10 archivos. El selector tiene una pestaña para tu propio Drive y otra para las unidades compartidas. Las carpetas se abren para que elijas archivos dentro de ellas.
Haz clic en Select. intoCHAT lee los archivos, lo que puede tardar unos segundos por archivo.

Si se añadieron o actualizaron archivos, el entrenamiento empieza solo. Un mensaje resume la importación, por ejemplo «3 added, 1 updated, 0 unchanged». Cada archivo se convierte en una fuente de tipo Google Drive, con el nombre del archivo, un enlace a él en Drive y la hora de su última modificación.

Todo o nada. Si un archivo no se puede leer, o si los archivos superan el límite de caracteres del agente, no se importa nada y tu conocimiento queda como estaba. El mensaje nombra el archivo cuando puede. Si se supera el límite, intoCHAT muestra Character limit reached.
Volver a elegir un archivo lo actualiza. La fuente existente recibe el texto nuevo en lugar de una segunda copia. Un archivo cuyo texto no cambió se deja como está.
Los archivos vacíos se omiten y aparecen como «skipped (no text)».
Las hojas grandes se recortan. Solo se leen las primeras 1.000 filas de cada hoja, y el mensaje nombra la hoja de cálculo. Divide una hoja mayor en varias hojas o archivos.

Los miembros con el nivel Edit en conocimiento pueden elegir e importar archivos. Eligen del Drive de la cuenta de Google conectada, así que da ese nivel solo a personas de confianza.

Mantener los archivos al día

El texto importado no cambia cuando editas el archivo en Drive. Para recoger tus cambios:

Haz clic en Sync now en la opción Drive. intoCHAT comprueba cuándo se modificó por última vez cada archivo de Drive del agente y solo vuelve a leer los que cambiaron. Solo se reentrenan los archivos cuyo texto cambió.
Activa el Auto-resync. A diario o cada semana, intoCHAT hace esa misma comprobación por ti. Los archivos de Drive no consumen rastreos de la web, y una pasada lee hasta 30 archivos de Drive. Consulta Auto-resync.
Vuelve a elegir el archivo con Add from Google Drive.

Un archivo renombrado en Drive toma su nuevo nombre en la siguiente comprobación.

Si un archivo se eliminó, se movió a la papelera o intoCHAT ya no puede abrirlo, la comprobación falla con un mensaje en la fuente y el texto guardado sigue en tu conocimiento. Vuelve a elegir el archivo, o elimina la fuente si ya no la quieres.

Límites

Límite	Valor
Archivos por importación	10
Tamaño de archivo (PDF, Word, texto, Markdown)	50 MB, como en las subidas
Texto por archivo	4 MB, como en las subidas
Google Docs y Slides	Lo que Google puede exportar: hasta 10 MB de texto
Google Sheets	1.000 filas por hoja
Caracteres	Cuentan para el límite de caracteres del agente, como cualquier fuente. Consulta Planes y límites

Los archivos de Drive siguen siendo privados

Los archivos de Drive nunca aparecen como enlaces a fuentes bajo una respuesta. Solo las páginas web tienen enlace.
El agente ve el nombre de un archivo, pero no su dirección de Drive, así que no puede pasar el enlace a los visitantes.
intoCHAT guarda cifrado su acceso a tu cuenta de Google, y el navegador solo recibe un acceso de corta duración para el selector de archivos.

Desconectar Google Drive

Haz clic en Disconnect (desconectar) en la opción Drive. En el diálogo eliges qué pasa con los archivos que importaste:

Conservarlos (por defecto). Siguen en el conocimiento de todos tus agentes tal como están ahora, pero ya no se mantienen sincronizados. El Auto-resync los marca con «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. Marca esta casilla para quitarlos también.

intoCHAT revoca su acceso en Google y elimina el acceso guardado. También puedes quitar intoCHAT en tu cuenta de Google, en Security → Third-party apps & services. Si solo lo haces allí, la siguiente comprobación muestra «Google Drive access was revoked or has expired. Reconnect Google Drive to keep this file in sync.»

Si algo falla

Mensaje	Qué hacer
«Google Drive isn't configured on this server.»	Google Drive no está configurado para esta instalación. Sube los archivos en Files en su lugar, o configura la app de Google como se explica más abajo.
«Google didn't grant access to the files you pick.»	Conecta de nuevo y deja marcada la casilla de Google Drive en la pantalla de Google.
«This file was deleted in Google Drive, or intoCHAT can no longer open it.»	Vuelve a elegir el archivo en Google Drive, o elimina la fuente.
«This file is in the Google Drive trash.»	Restáuralo en Drive, o elimina la fuente.
«intoCHAT is no longer allowed to open this file.»	Pide acceso al propietario del archivo y luego vuelve a elegirlo.
«The file's owner turned off downloading, so intoCHAT can't read it.»	Pide al propietario que permita la descarga, o haz una copia propia.
«Google can't export this file because it is too large»	Divide el documento o la presentación en archivos más pequeños.
«Google Drive is limiting requests right now.»	Espera unos minutos y vuelve a intentarlo.
Aparece Reconnect Google Drive	El acceso de intoCHAT se revocó o caducó. Haz clic para conectar de nuevo.

Configurar la app de Google

Esta sección es para quien gestiona la instalación de intoCHAT. Los clientes de intoCHAT no la necesitan.

Google Drive necesita un cliente OAuth, una clave de API y el número de proyecto de un mismo proyecto de Google Cloud:

En la consola de Google Cloud, crea un proyecto o elige uno.
En APIs & Services → Library, habilita la Google Drive API y la Google Picker API.
En Google Auth Platform, configura la pantalla de consentimiento: el nombre de la app, un correo de soporte, tu dominio y los enlaces a tu política de privacidad y tus condiciones. Elige External como público. En Data access, añade el scope https://www.googleapis.com/auth/drive.file. Es un scope no sensible, así que la app solo necesita la verificación básica de marca de Google, no la evaluación de seguridad de los scopes restringidos.
En Clients (o Credentials → Create credentials → OAuth client ID), crea un cliente Web application:
- Authorized redirect URI: la dirección de tu app seguida de /api/integrations/google-drive/callback, por ejemplo https://www.example.com/api/integrations/google-drive/callback. Debe coincidir exactamente con NEXT_PUBLIC_APP_URL.
- Authorized JavaScript origin: la dirección de tu app, por ejemplo https://www.example.com.
- Guarda el ID de cliente como GOOGLE_DRIVE_CLIENT_ID y el secreto de cliente como GOOGLE_DRIVE_CLIENT_SECRET.
En Credentials → Create credentials → API key, crea una clave para el selector de archivos. Restríngela a Websites con la dirección de tu app, y a la Google Picker API. Guárdala como NEXT_PUBLIC_GOOGLE_DRIVE_API_KEY.
Copia el project number (número de proyecto, no el ID del proyecto) desde el panel del proyecto o desde IAM & Admin → Settings, y guárdalo como NEXT_PUBLIC_GOOGLE_DRIVE_APP_ID. Debe ser el proyecto del cliente OAuth: Google concede los archivos elegidos a esa app.
Vuelve a desplegar. Con los cuatro ajustes presentes, la opción Drive ofrece Connect Google Drive.

Los tokens se cifran con TOKEN_ENCRYPTION_KEY (o con NEXTAUTH_SECRET si no está definido). Si cambias ese secreto, las conexiones guardadas dejan de poder leerse y los propietarios tienen que conectar de nuevo.

Mientras la pantalla de consentimiento está en Testing, solo pueden conectar los usuarios de prueba que añadas, y Google hace caducar su acceso a los 7 días. Publica la app en In production para que pueda usarla todo el mundo.