Чтобы подключить Google Workspace к ИИ-агенту, откройте каталог интеграций /partners, выберите карточку «Google Workspace», нажмите «Подключить аккаунт», войдите в Google и подтвердите доступ — после этого на карточке появится строка «Подключён: почта аккаунта». Никаких токенов и ключей вручную вводить не нужно. Дальше остаётся включить нужные модули и права: по умолчанию у агента только чтение, запись включается вручную, а модуль удаления выключен целиком.
Что даёт коннектор Google Workspace
Коннектор — это 27 инструментов в четырёх модулях: работа с файлами на Диске, Google Документы, Google Таблицы и отдельный модуль доступа и удаления. Аккаунт подключается на уровне рабочего пространства: авторизовались один раз — коннектор доступен всем вашим агентам. Вызовы инструментов коннектора не расходуют нейроны платформы.
| Модуль | Что умеет | По умолчанию |
|---|---|---|
| Файлы Google Диска (10 инструментов) | Список файлов с фильтрами (по имени, типу, папке), метаданные файла, чтение содержимого как текста (Документы → текст, Таблицы → CSV, а также pdf, docx, xlsx, txt, csv), ссылка на файл и доступные форматы экспорта (docx, pdf, txt, html, md, xlsx, csv, pptx), создание папки, сохранение подготовленного текста файлом на Диск с конвертацией в настоящий Google Документ, перезапись текстового файла, переименование, копирование, перемещение | Чтение включено, запись — вручную |
| Google Документы (6) | Создать документ (можно сразу с текстом), прочитать текст документа, дописать текст в конец, вставить текст в нужное место, заменить все вхождения фразы, переписать документ целиком | Чтение включено, запись — вручную |
| Google Таблицы (7) | Создать таблицу, показать листы и их размеры, прочитать диапазон в формате A1, записать значения в диапазон, дописать строки после последней заполненной, очистить диапазон, добавить новый лист | Чтение включено, запись — вручную |
| Доступ и удаление (4) | Выдать доступ к файлу (конкретной почте как читателю, комментатору или редактору либо публичной ссылкой), переместить в корзину (обратимо), удалить безвозвратно, удалить лист таблицы | Выключен полностью |
Подключение: шесть шагов
- Откройте каталог интеграций — /partners.
- Найдите карточку «Google Workspace» и откройте её.
- Нажмите кнопку «Подключить аккаунт». Откроется стандартный вход Google.
- Войдите в аккаунт Google, из-под которого агент будет работать с файлами.
- Подтвердите запрошенный доступ на экране согласия Google.
- Вернитесь на карточку интеграции: под названием появится «Подключён: почта аккаунта» — значит, всё готово.
На подключённой карточке рядом с адресом почты есть две кнопки: «сменить аккаунт» — если вы вошли не под тем адресом, и «отключить» — если интеграция больше не нужна. Проверяйте почту на карточке перед первыми задачами: самая частая причина «агент ничего не видит» — вход под личным аккаунтом вместо рабочего.
Какие права включать
Права настраиваются на уровне модулей, и стартовая конфигурация намеренно консервативная. Разумный порядок — включать по мере необходимости, а не всё сразу.
- Чтение — уже включено. Этого достаточно, чтобы агент искал файлы в своём периметре, читал документы и диапазоны таблиц, показывал ссылки и форматы экспорта.
- Запись — включается вручную для нужного модуля. Нужна, если агент должен создавать документы и таблицы, дописывать текст, добавлять строки, переименовывать и перемещать файлы.
- Доступ и удаление — выключен полностью. Включайте, только если вам действительно нужно, чтобы агент раздавал доступ к файлам или удалял их. Публичная ссылка и безвозвратное удаление сопровождаются отдельными предупреждениями.
- Хороший стартовый набор для первой недели: чтение везде плюс запись в модулях «Файлы Google Диска», «Google Документы» и «Google Таблицы». Модуль удаления не трогаем.
Режим «Только чтение» и подтверждения в чате
На уровне всей интеграции есть отдельный режим «Только чтение» — удобен, когда вы даёте агента команде и хотите гарантировать, что он ничего не изменит. Действия записи и удаления агент подтверждает с вами прямо в чате: вы видите, что именно он собирается сделать, и решаете. Как это устроено в целом по платформе — в разборе безопасности доступа к файлам.
Периметр доступа: что агент видит, а что — нет
Это самая важная часть гайда, и честнее разобраться с ней до первой задачи, чем после неудачного запроса. Интеграция запрашивает у Google доступ «по файлу»: платформа не получает доступ ко всему содержимому вашего Диска, а работает только с конкретными объектами.
- Видит: файлы, папки, документы и таблицы, которые агент создал сам через этот коннектор.
- Видит: файлы, которые ему явно открыли.
- Не видит: документы и таблицы, которые вы создали руками в интерфейсе Google Диска.
- Не видит: чужие файлы, к которым у вас есть доступ по ссылке.
- Не видит: содержимое Диска в целом — списка «всех ваших файлов» у агента нет.
Первые проверочные запросы
После подключения потратьте пару минут на проверку — так вы сразу увидите границы периметра на практике. Для этих задач нужны включённые права записи в модулях «Файлы Google Диска», «Google Документы» и «Google Таблицы»: по умолчанию там только чтение. Формулировки можно копировать в чат с агентом как есть.
первые-проверки.txt
Создай на Google Диске папку «Отчёты агента»,
а внутри — Google Документ «Тестовая заметка»
с текстом «Проверка подключения».
Покажи ссылку на созданный документ
и доступные форматы экспорта.
Прочитай текст документа «Тестовая заметка»
и выведи его целиком.
Допиши в конец «Тестовой заметки» строку
«Проверка записи пройдена».проверка-таблиц.txt
Создай Google Таблицу «Заявки» с листом «Июль»
и заголовками: дата, клиент, канал, сумма, статус.
Допиши в лист «Июль» три тестовые строки —
именно дописывай после последней заполненной,
не перезаписывай диапазон.
Прочитай диапазон A1:E10 листа «Июль»
и покажи, что получилось.
Покажи список листов таблицы «Заявки» и их размеры.Что делать, если файл «не найден»
В девяти случаях из десяти дело не в ошибке, а в периметре. Проверьте по порядку.
- Кто создал файл. Если вы создали его руками в интерфейсе Google Диска — агент его не видит, и это ожидаемое поведение. Решение: попросите агента создать документ или таблицу заново через коннектор, дальше он работает с ними полноценно. Либо файл должен быть явно открыт агенту — всё остальное остаётся вне периметра.
- Тот ли аккаунт. На карточке интеграции видно почту подключённого аккаунта. Если она не та — нажмите «сменить аккаунт».
- Включён ли модуль. Для чтения содержимого файла нужен модуль «Файлы Google Диска», для текста документа — «Google Документы», для диапазонов — «Google Таблицы».
- Хватает ли прав. Если агент читает, но не может дописать — значит, запись в модуле ещё не включена.
- Размер файла. Чтение и экспорт работают до 10 МБ; более крупный файл честно не откроется.
- Точность названия. Список файлов ищется с фильтрами по имени, типу и папке — уточните формулировку: «в папке “Отчёты агента”, тип — Google Таблица».
Если ни один пункт не подошёл, самый быстрый обходной путь — попросить агента пересоздать нужный документ в его периметре и перенести туда содержимое вручную один раз. Дальше повторять это не придётся.
Почта и календарь — отдельные интеграции
Задачи почты и календаря на платформе закрываются отдельными интеграциями: Почта (SMTP/IMAP) — отправка и разбор писем, Календарь (CalDAV) — события и расписание. Подключаются они независимо и отлично работают в связке с Google Workspace: агент собирает отчёт в Google Таблице и отправляет ссылку письмом. В самом коннекторе Google Workspace Gmail и Google Календарь намеренно не реализованы — это потребовало бы расширенных прав ко всей вашей переписке и расписанию, а мы держимся подхода «доступ по файлу».
Лимиты, о которых стоит знать заранее
| Параметр | Значение |
|---|---|
| Чтение и экспорт содержимого файла | до 10 МБ |
| Сохранение подготовленного текста файлом на Диск | до 5 МБ |
| Экспорт Google Таблицы в CSV | отдаётся только первый лист |
| Форматы чтения как текста | Google Документы, Google Таблицы, pdf, docx, xlsx, txt, csv |
| Форматы экспорта | docx, pdf, txt, html, md, xlsx, csv, pptx |
| Видимость файлов | только созданные агентом через коннектор или явно открытые ему |
| Расход нейронов платформы на вызовы инструментов | нет |
Отдельно про таблицы: когда агент читает Google Таблицу как текст, он получает только первый лист. Если листов несколько, просите прочитать нужный диапазон конкретного листа — это делает модуль «Google Таблицы», и там доступны все листы.
Частые вопросы
Нужно ли вводить токен или создавать приложение в Google Cloud?
Нет. Подключение целиком проходит кнопкой «Подключить аккаунт»: вы входите в Google и подтверждаете доступ на его же экране согласия. Ручной ввод токенов не требуется, а сами токены хранятся в зашифрованном виде и в браузер не попадают.
Агент правда не увидит мои существующие документы на Диске?
Правда — и это сделано намеренно. Доступ выдаётся по файлу, поэтому в периметр попадают только объекты, созданные агентом через коннектор, и те, что ему явно открыли. На всё остальное агент честно ответит «не найдено». Взамен вы получаете гарантию, что платформа не читает ваш Диск целиком.
Может ли агент удалить документ по ошибке?
Модуль «Доступ и удаление» выключен по умолчанию — пока вы его не включите, удаление технически недоступно. Если включите, перемещение в корзину остаётся обратимым, а безвозвратное удаление и публичная ссылка сопровождаются предупреждениями. Плюс действия записи и удаления агент подтверждает с вами в чате.
Одно подключение — для всех агентов?
Да. Аккаунт подключается на уровне рабочего пространства, и коннектор становится доступен всем вашим агентам. Отдельно авторизовывать каждого не нужно; отключить или сменить аккаунт можно в любой момент на карточке интеграции.
Что выбрать — Google Workspace или Яндекс.Диск?
Зависит от того, где живут ваши документы и насколько важна работа с готовыми файлами. Оба коннектора подключаются кнопкой и настраиваются по одной логике модулей и прав; сравнение сценариев — в материале Google Workspace или Яндекс.Диск.
Подключение занимает минуту, а дальше начинается работа: разберите сценарии в гайдах Google Документы из чата и Google Таблицы из чата. Если аккаунта на платформе ещё нет — зарегистрируйтесь, подключите Google Workspace в каталоге /partners и попросите агента собрать первый отчёт в таблице. «СуперИнтеллект» работает на русском и без VPN: ИИ-агенты с интеграциями, МедиаЛаб, базы знаний, запуск кода, облачный браузер и командное пространство — всё в одном месте, создайте аккаунт и попробуйте.
