Hermes Agent умеет читать, записывать, обновлять и создавать таблицы Google Sheets по команде на русском языке: вести базу заказов, собирать данные из интернета и присылать готовые отчёты по расписанию. В статье — как подключить Google Sheets к Hermes Agent через официальный скилл Google Workspace, какие команды использовать для чтения и записи данных и как автоматизировать рутинную работу с таблицами без программирования.
Что такое Hermes Agent и Google Sheets?
Hermes Agent — это автономный ИИ-агент с открытым исходным кодом от Nous Research, который выполняет задачи на компьютере или сервере: работает с файлами, браузером, почтой, календарём и внешними сервисами через API. Агент вышел в феврале 2026 года, за семь недель набрал 95 000 звёзд на GitHub, а спустя месяц — 140 000. По данным OpenRouter, это самый используемый агент в мире. Внутри него более 60 встроенных инструментов: веб-поиск, выполнение кода, генерация изображений, работа с документами и cron-планировщик для задач по расписанию.
Google Sheets — это облачные электронные таблицы Google, часть пакета Google Workspace. Данные хранятся на серверах Google и доступны с любого устройства через браузер. У каждой таблицы есть уникальный идентификатор (SHEET_ID) из адресной строки, а ячейки адресуются диапазонами в формате A1 — например, Sheet1!A1:D10 означает лист Sheet1, ячейки от A1 до D10.
Связка Hermes + Google Sheets закрывает главную проблему ручной работы с таблицами: агент не просто хранит данные, а сам их читает, заполняет, сравнивает, анализирует и действует по результатам. Вместо «скопировал из почты → вставил в таблицу → посчитал вручную» вы один раз формулируете задачу, и дальше всё делает агент.
Что умеет Hermes Agent с таблицами Google?
Скилл google-workspace даёт агенту четыре базовые операции с таблицами:
| Операция | Команда | Что делает |
|---|---|---|
| Чтение | `$GAPI sheets get SHEET_ID «Sheet1!A1:D10″` | Возвращает значения ячеек в виде JSON-массива |
| Запись | `$GAPI sheets update SHEET_ID «Sheet1!A1:B2» —values ‘[[«Имя»,»Оценка»],[«Алиса»,»95″]]’` | Перезаписывает указанный диапазон |
| Добавление строк | `$GAPI sheets append SHEET_ID «Sheet1!A:C» —values ‘[[«новая»,»строка»,»данные»]]’` | Дописывает строки в конец таблицы |
| Создание таблицы | `$GAPI sheets create —title «Бюджет Q4″` | Создаёт новый документ в Google Drive |
Все команды возвращают JSON — агенту легко передать результат дальше: в отчёт, в письмо или в следующую операцию. Например, sheets get возвращает двумерный массив значений ячеек, который Hermes может посчитать, отсортировать или превратить в Markdown-таблицу.
Кроме того, агент комбинирует таблицы с остальными инструментами:
Как подключить Google Sheets к Hermes Agent?
Подключение делается один раз через официальный скилл Google Workspace (путь skills/productivity/google-workspace/). Он закрывает не только Sheets, но и Gmail, Calendar, Drive, Docs и Contacts через единую OAuth2-авторизацию с автоматическим обновлением токена. Весь процесс агент ведёт сам: достаточно сказать «настрой Google Workspace», и Hermes будет шаг за шагом давать инструкции.
Шаг 1. Создайте проект в Google Cloud
Зайдите в Google Cloud Console и создайте проект (или выберите существующий). В разделе API Library включите нужные API: Google Sheets API, а если планируете использовать почту и календарь — также Gmail API, Google Calendar API, Google Drive API, Google Docs API и People API.
Шаг 2. Создайте OAuth-креды
В разделе Credentials нажмите «Create Credentials» → «OAuth 2.0 Client ID». Тип приложения — Desktop app. Если проект находится в режиме Testing (по умолчанию для новых проектов), добавьте свой Google-аккаунт в Test users, иначе авторизация вернёт ошибку access_denied. Скачайте JSON-файл с кредами и передайте его агенту — он сам запустит скрипт настройки:
$GSETUP --client-secret /путь/к/client_secret.json
Шаг 3. Авторизуйтесь
Hermes сгенерирует ссылку для авторизации:
$GSETUP --auth-url --services sheets --format json
Откройте ссылку в браузере, подтвердите доступ и скопируйте URL, на который вас перекинет (адрес вида http://localhost:1/?code=...). Вставьте его агенту — обмен кода на токен произойдёт автоматически. Браузерная ошибка на localhost после подтверждения — это норма, важно скопировать именно весь адрес из строки браузера.
Шаг 4. Проверьте подключение
$GSETUP --check
Если скрипт выводит AUTHENTICATED — всё готово. Токен хранится в ~/.hermes/google_token.json и обновляется автоматически, повторная авторизация не нужна, пока вы не отзовёте доступ командой $GSETUP --revoke.
Если вам нужна только почта — проще использовать скилл himalaya: он работает через App Password Gmail и настраивается за 2 минуты без проекта в Google Cloud.
Как читать данные из таблицы?
Допустим, у вас есть таблица с продажами и вы хотите узнать, что в ней. Запрос агенту на русском языке: «Прочитай первые 10 строк листа Sheet1 в таблице [ссылка]». Агент выполнит:
$GAPI sheets get 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "Sheet1!A1:D10"
Ответ придёт как JSON-массив строк. Агент переведёт его в человекочитаемый вид: покажет таблицу, посчитает суммы, найдёт максимумы — что вы попросите. Важно понимать: sheets get возвращает сырые значения, поэтому Hermes сам может выполнить любую аналитику по этим данным, не трогая формулы в самой таблице.
Как записать данные в таблицу?
Запись перезаписывает указанный диапазон. Например, чтобы заполнить заголовки и первые строки отчёта:
$GAPI sheets update 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "Sheet1!A1:B2" \
--values '[["Имя","Оценка"],["Алиса","95"],["Борис","87"]]'
Агент понимает команду на естественном языке: «Запиши в таблицу результаты опроса: Алиса — 95, Борис — 87». Он сам превратит её в корректный вызов API.
Как добавить строки в таблицу?
Операция append дописывает данные в конец таблицы — это главный инструмент для журналов, логов и баз, которые постоянно растут:
$GAPI sheets append 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms "Sheet1!A:C" \
--values '[["2026-08-19","Иван","заказ #1042 оплачен"]]'
В отличие от update, append не перезаписывает существующие данные, а находит первую пустую строку и пишет в неё. Именно поэтому добавление строк — стандартный способ вести базу заявок, сделок или событий.
Как создать новую таблицу?
$GAPI sheets create --title "Бюджет Q4"
Команда создаст таблицу в Google Drive и вернёт JSON с полями spreadsheetId, title и spreadsheetUrl — ссылку можно сразу отправить коллегам или использовать в следующих операциях.
Практические сценарии: что реально автоматизировать?
База заказов интернет-магазина
Hermes принимает заказы из Telegram или почты и дописывает их в таблицу командой append. Каждый новый заказ — новая строка с датой, именем клиента и статусом. Оператору не нужно ничего копировать вручную, а таблица всегда актуальна. Подробнее про автоматизацию заказов — в статье «Hermes Agent для интернет-магазина: обработка заказов и поддержка клиентов».
Автоматический отчёт по расписанию
Cron-задача каждый день в 18:00 читает таблицу продаж, считает итоги и отправляет сводку в Telegram или на почту. Настройка — одна фраза: «Каждый день в 18:00 читай таблицу [ссылка], считай сумму столбца B и отправляй мне отчёт». Как работают расписания в Hermes, описано в статье «Cron-задачи в Hermes: автоматизация по расписанию без кода», а отправка писем — в статье «Hermes Agent и электронная почта: автоматизация email-переписки».
Сбор данных из интернета в таблицу
Агент может ходить по сайтам, собирать цены конкурентов или характеристики товаров и складывать результат в Google Sheets. Например: «Собери цены на [товар] из пяти магазинов и запиши в таблицу столбцами: магазин, цена, наличие». Веб-поиск, браузер и sheets append работают в одной цепочке без участия человека.
Анализ и сводки
Hermes читает таблицу, считает метрики и формулирует выводы на естественном языке. Например, по журналу обращений он определит, в какие дни нагрузка на поддержку выше, и предложит сдвинуть смены. Агент помнит результаты прошлых запусков и может сравнивать периоды — динамику, а не только текущие цифры.
Альтернатива: подключение Google Sheets через Composio MCP
Если нужны продвинутые операции — создание диаграмм, форматирование ячеек, массовые обновления с фильтрами — можно подключить Google Sheets через Composio Connect. Это сторонний сервис, который даёт агенту 42 готовых инструмента и 16 триггеров для работы с таблицами, беря на себя OAuth, хранение токенов и их обновление.
Подключение через CLI: установите Composio CLI (curl -fsSL https://composio.dev/install | bash), попросите Hermes авторизоваться в Composio, затем попросите подключить Google Sheets. Либо через MCP: добавьте в config.yaml секцию mcp_servers с URL и API-ключом Composio Connect и перезапустите агента.
Composio умеет то, чего нет в базовом скилле: создание графиков внутри таблицы, форматирование ячеек, поиск и замена, массовые операции с фильтрами по данным. Для большинства задач хватает официального скилла, но для сложных дашбордов MCP-подключение — рабочий вариант. Общий принцип подключения внешних инструментов описан в статье «MCP-протокол в Hermes: подключение внешних инструментов и сервисов».
Частые ошибки и их решение
| Ошибка | Причина | Решение |
|---|---|---|
| `NOT_AUTHENTICATED` | Скилл не настроен | Выполните шаги настройки 1–4 |
| `REFRESH_FAILED` | Токен отозван или истёк | Повторите авторизацию |
| `HttpError 403: Insufficient Permission` | Не хватает области доступа (scope) | `$GSETUP —revoke`, затем авторизуйтесь заново с нужными сервисами |
| `HttpError 403: Access Not Configured` | API не включён в Google Cloud Console | Включите Google Sheets API в API Library |
| `ModuleNotFoundError` | Не установлены зависимости | Запустите скрипт настройки с флагом `—install-deps` |
Большинство ошибок лечится переавторизацией: команда $GSETUP --revoke отзывает токен, после чего нужно заново пройти шаги 3–4. Токены Google живут ограниченное время, и автоматическое обновление срабатывает только пока доступ не отозван и области доступа не изменились.
FAQ
Может ли Hermes Agent работать с Google Sheets бесплатно?
Да. Google Sheets API входит в бесплатный тариф Google Cloud, а сам Hermes Agent — проект с открытым исходным кодом. Платить нужно только за доступ к языковой модели, если вы используете платных провайдеров.
Нужно ли уметь программировать, чтобы подключить таблицы?
Нет. Вся настройка проходит через диалог с агентом: он выдаёт ссылки, принимает JSON-файл кредов и сам выполняет команды. Формулировать задачи можно на русском языке.
Чем `update` отличается от `append` в Google Sheets?
update перезаписывает указанный диапазон ячеек, append дописывает новые строки в конец таблицы. Для растущих данных — заявок, заказов, логов — используется append, чтобы не затирать существующие записи.
Безопасно ли давать агенту доступ к таблицам?
Токен хранится локально в ~/.hermes/google_token.json и никуда не передаётся. Вы сами решаете, какие области доступа разрешить при авторизации. Подробнее о том, как Hermes защищает данные, — в статье «Безопасность AI-агента: как Hermes защищает данные и ограничивает доступ».
Какие ещё сервисы Google умеет Hermes кроме Sheets?
Скилл Google Workspace покрывает Gmail, Google Calendar, Google Drive, Google Docs и Google Contacts через единую авторизацию. Все они работают по одному принципу: команда на русском языке — агент выполняет действие через API.
Ссылки и документация
Другие материалы hermeswiki: как установить Hermes Agent на VPS, плагины и расширения агента, работа агента с внешними API.