Google Workspace

Un solo inicio de sesión con Google conecta Drive, Sheets y Docs, 14 herramientas para leer, crear y actualizar archivos. Gmail y Calendar se conectan por separado.

Un solo inicio de sesión con Google conecta Drive, Sheets y Docs con tu agente, y al momento de conectar se ofrece un modo de solo lectura. Catorce herramientas le permiten leer tus archivos y crear o actualizar hojas de cálculo y documentos en tu nombre. Gmail y Google Calendar son conexiones separadas, ambas enlazadas más abajo.

Conectar

Abre Integraciones y elige Google (Drive · Sheets · Docs).
Inicia sesión con Google y concede el acceso. Para mantenerlo en solo lectura, activa la opción read-only, así el agente podrá leer pero nunca crear, actualizar ni mover nada.
El agente ya puede trabajar con tus Drive, Sheets y Docs.

El único obstáculo que confunde a la gente: el scope drive.file. Para proteger tu privacidad, el listado de Drive muestra siempre y solo los archivos creados por el agente más los archivos o carpetas que hayas compartido explícitamente con la cuenta de Google conectada, nunca todo tu Drive. Sheets y Docs siguen siendo accesibles en toda la cuenta mediante enlace o ID, así que la forma más rápida de que el agente trabaje sobre un documento existente es pegar su URL (o compartir el archivo). Si el agente "no encuentra" una hoja de cálculo que sabes que existe, la causa es este scope.

Qué puede hacer el agente

Herramienta	Acceso	Tipo	Qué hace
`gdrive_list_files`	Público seguro	Read	Enumera los archivos y carpetas a los que el agente puede acceder, los que creó más los que hayas compartido; filtra por nombre o enumera una carpeta.
`gdrive_read_file`	Público seguro	Read	Lee el texto de un archivo de Drive; los formatos nativos Docs, Sheets y Slides se exportan a texto plano o CSV.
`gsheets_read`	Público seguro	Read	Lee los valores de las celdas de una hoja mediante URL o ID, usando un rango en notación A1.
`gsheets_get_metadata`	Público seguro	Read	Obtiene el título y las pestañas de una hoja, nombres, ID y recuentos de filas/columnas.
`gdocs_read`	Público seguro	Read	Lee el texto completo de un Google Doc mediante URL o ID.
`gdrive_create_file`	Solo propietario	Write	Crea un archivo de texto plano (txt, csv, markdown, html) en Drive, opcionalmente dentro de una carpeta.
`gdrive_create_folder`	Solo propietario	Write	Crea una carpeta nueva, opcionalmente dentro de una carpeta superior.
`gdrive_update_file`	Solo propietario	Write	Renombra un archivo de Drive, reemplaza su contenido o lo mueve a otra carpeta.
`gsheets_append_rows`	Solo propietario	Write	Agrega filas después de la última fila de datos en una pestaña de la hoja.
`gsheets_update_cells`	Solo propietario	Write	Sobrescribe un rango de celdas específico con nuevos valores.
`gsheets_create`	Solo propietario	Write	Crea una hoja nueva con un título, pestañas opcionales y filas iniciales opcionales.
`gdocs_create`	Solo propietario	Write	Crea un Google Doc nuevo con un título y un texto inicial opcional.
`gdocs_insert_text`	Solo propietario	Write	Inserta texto en un Doc, al final de forma predeterminada, o en una posición establecida.
`gdocs_replace_text`	Solo propietario	Write	Busca y reemplaza cada aparición de una cadena en un Doc.

Public-safe vs owner-only

Las cinco herramientas de lectura son public-safe, un agente que habla con un visitante del sitio web puede usarlas para responder a partir de una hoja de cálculo o un documento compartido. Las nueve herramientas de escritura son owner-only: nunca se muestran a un visitante público y, al conectarse en modo read-only, las nueve quedan ocultas, así que el agente puede leer pero no puede cambiar nada.

Ejemplo práctico

Le dices a tu agente interno: "Lee la pestaña de leads en esta hoja [link] y empieza un documento de seguimiento que resuma los cinco principales." Llama a gsheets_read sobre el enlace compartido, luego a gdocs_create para crear el documento y a gdocs_insert_text para rellenarlo, un archivo nuevo que aparece en tu Drive, creado con tu cuenta.

Límites y honestidad

Restringido por diseño. El scope drive.file significa que el agente ve solo los archivos creados y compartidos, no todo tu Drive. Eso es una función, no un defecto.
La herramienta adecuada para los archivos nativos. gdrive_create_file crea archivos de texto plano; usa gsheets_create / gdocs_create para verdaderos Sheets y Docs.
El trabajo de la IA se mide en ABT, como toda la actividad del agente, consulta Facturación y ABT.

Gmail y Calendar (conexiones separadas)

Gmail se conecta como cuenta de correo mediante el mismo inicio de sesión con Google y le da al agente herramientas de correo owner-only. La lectura y la búsqueda de correo funcionan según el scope concedido.

Calendar es una integración propia, la disponibilidad y las reservas están en la página de Google Calendar.

Solución de problemas

"No encuentro mi archivo." No fue creado por el agente ni compartido. Pega el enlace/ID del documento, o comparte el archivo/carpeta con la cuenta de Google conectada.
Faltan las herramientas de escritura. La conexión está en modo read-only, vuelve a conectar sin él para habilitar crear/actualizar/mover.
El documento salió vacío. gdocs_create sin texto crea un documento en blanco; pide el contenido, o continúa con gdocs_insert_text.

Preguntas frecuentes

¿El agente puede ver todo mi Drive? No, solo los archivos que creó más los que compartiste explícitamente (el scope drive.file).

¿Puede enviar correo? La lectura funciona; el envío es de scope restringido, consulta la nota de arriba y Email antes de confiar en ello.

¿La solo lectura bloquea de verdad todas las escrituras? Sí, las nueve herramientas de escritura quedan ocultas mientras la conexión está en read-only.

Google Calendar, ofrece franjas libres y reserva citas
Email, inicio de sesión con Gmail, IMAP/SMTP y la familia de herramientas de correo
Habilidades del agente, cómo se conectan las herramientas a un agente
Visión general de las integraciones