Платформа
Google Таблицы
Подключение общей таблицы, чтение диапазонов и контролируемые изменения.
Google Таблицы
Приложение Google Таблицы подключает к рабочему пространству только выбранные таблицы. Агент читает диапазоны и формулы, добавляет строки, создаёт листы, обновляет данные и применяет базовое форматирование.
Назначение
Google Таблицы подходят для задач, где данные должны оставаться в общем документе:
- ответить на вопрос по значениям и формулам;
- собрать отчёт на новом листе;
- добавить строку в журнал или сводную таблицу;
- сверить два листа по ключу;
- обновить выбранный диапазон;
- создать, переименовать или оформить лист.
Promto не получает доступ ко всему Google Диску. Робот видит только документы, которыми с ним поделились и которые владелец добавил в приложение.
Подключение
Подключать таблицы может владелец рабочего пространства.
- Откройте Google Таблицы → Настройки.
- Скопируйте адрес робота Promto.
- В нужной таблице нажмите Открыть доступ и добавьте этот адрес:
- роль Читатель — если агенту нужно только читать;
- роль Редактор — если агент должен записывать и форматировать данные.
- Скопируйте ссылку вида
https://docs.google.com/spreadsheets/d/.... - Вставьте её в поле приложения и нажмите Добавить.
Повторите шаги для каждой таблицы, которую должен видеть агент.
Интерфейс
На Главной доступны сценарии отчёта, ответа по цифрам, дозаписи итогов, сверки листов, безопасной перезаписи и разбора формул.
В Настройках показываются адрес робота и подключённые таблицы. У каждой записи видны название, несколько имён листов, ссылка на оригинал и кнопка удаления из рабочего пространства.
Удаление записи в Promto закрывает доступ агенту, но не удаляет робота из списка доступа Google. Чтобы отозвать доступ полностью, удалите его и в настройках самой таблицы.
Возможности агента
Основной агент использует promto_sheets.
| Задача | Действия |
|---|---|
| Список и структура | list_resources, get_metadata |
| Чтение | read_range, batch_read |
| Запись | append_rows, update_range, clear_range |
| Листы | add_sheet, rename_sheet, delete_sheet |
| Оформление | format_header, batch_update |
Диапазоны задаются в A1-нотации, например Продажи!A1:D20. Для нескольких диапазонов агент использует batch_read, чтобы не расходовать лишние запросы.
Сценарии
Собрать отчёт
Укажите исходные данные и название листа. Агент создаст лист, запишет данные диапазоном, оформит заголовок и закрепит первую строку после согласования структуры.
Сверить два листа
Назовите ключевую колонку. Агент прочитает оба диапазона, найдёт отсутствующие и отличающиеся записи и запишет результат на отдельный лист, не меняя источники.
Безопасно обновить диапазон
Агент сначала читает текущие значения и формулы, показывает, что будет заменено, и только затем записывает подтверждённые данные.
Ограничения и безопасность
append_rowsдописывает строки в конец и не затрагивает данные выше. Это безопасный вариант для журнала.update_rangeиclear_rangeперезаписывают ячейки и могут уничтожить формулы. Перед записью нужно прочитать диапазон.- Формула и вычисленное значение — разные представления одной ячейки. Для проверки формул агент запрашивает
FORMULA, для расчётов —UNFORMATTED_VALUEили отображаемый текст. - Удаление листа необратимо и требует отдельного подтверждения.
- Файл XLSX, просто загруженный в Google Диск, не поддерживает действия Google Sheets API. Сохраните его как Google Таблицу.
- Слишком большой ответ нужно сузить до конкретных листов и диапазонов.
- Роботу нельзя давать доступ к документам с секретами, если они не нужны для задачи.
Если что-то не работает
Таблица не добавляется. Проверьте ссылку и убедитесь, что адрес робота уже есть в доступе к документу.
Чтение работает, запись — нет. Измените роль робота с Читателя на Редактора.
Агент сообщает, что ресурс не найден. Откройте настройки приложения и убедитесь, что таблица добавлена именно в это рабочее пространство.
API отклоняет XLSX. Откройте файл в Google Таблицах и сохраните как нативную таблицу, затем добавьте новую ссылку.
Ответ слишком большой. Укажите конкретный лист, диапазон и нужный способ представления значений.