Платформа
Google Документы
Подключение, чтение и редактирование документов, доступных рабочему пространству.
Google Документы
Приложение Google Документы подключает к Promto выбранные документы. Агент читает текст и структуру вкладок, извлекает решения и задачи, дописывает разделы и заполняет шаблоны.
Назначение
Google Документы помогают:
- пересказать длинный документ;
- найти решения, поручения, сроки и открытые вопросы;
- вычитать текст и подготовить список правок;
- дописать новый раздел;
- заполнить шаблон по плейсхолдерам;
- сверить утверждения документа с данными из таблицы.
Агент получает доступ только к тем документам, которые владелец явно добавил в приложение и открыл роботу Promto.
Подключение
Подключать документы может владелец рабочего пространства.
- Откройте Google Документы → Настройки.
- Скопируйте адрес робота Promto.
- В документе нажмите Открыть доступ и добавьте робота с ролью Читатель или Редактор.
- Скопируйте ссылку вида
https://docs.google.com/document/d/.... - Вставьте ссылку в Promto и нажмите Добавить.
Роль Читатель подходит для анализа. Для добавления и замены текста нужна роль Редактор.
Интерфейс
На Главной находятся сценарии пересказа, поиска задач, добавления раздела, заполнения шаблона, вычитки и сверки с таблицей.
В Настройках видны адрес робота и подключённые документы. Их можно открыть в Google или убрать из рабочего пространства. Удаление записи из Promto не отзывает выданный роботу доступ в Google — сделайте это отдельно в самом документе.
Возможности агента
Основной агент использует promto_docs.
| Задача | Действия |
|---|---|
| Список документов | list_resources |
| Чтение | get_document |
| Дополнение | append_text |
| Замена | replace_text |
| Сложные изменения | batch_update |
По умолчанию get_document возвращает обычный текст. Для документа с несколькими вкладками агент получает заголовки вида ## <вкладка> и может сослаться на конкретную вкладку.
Сценарии
Сделать краткий пересказ
Агент читает документ, выделяет основные тезисы, решения и открытые вопросы и указывает, из какой вкладки взят каждый блок.
Извлечь задачи
Попросите найти поручения, ответственных и сроки. Агент отделит явно записанные данные от предположений и соберёт список.
Заполнить шаблон
Используйте однозначные плейсхолдеры, например {{client_name}}. Агент сначала покажет все пары «что найти → чем заменить» и только после проверки выполнит замену.
Ограничения и безопасность
append_textдобавляет текст в конец документа и не заменяет существующее содержимое.replace_textменяет каждое совпадение. Короткое или распространённое слово может затронуть лишние места — используйте уникальные плейсхолдеры.- Автоматического отката нет. Перед рискованной правкой агент должен прочитать текущий текст и показать изменения.
- Сложная структура документа может вернуть большой ответ. Если нужен только анализ, запрашивайте обычный текст, а не полное дерево.
- Робот не видит другие файлы на Google Диске и не может открыть документ без выданного доступа.
- Удаление документа из Promto не удаляет сам документ и не снимает права робота в Google.
Если что-то не работает
Документ не добавляется. Проверьте формат ссылки и наличие адреса робота в списке доступа.
Агент может читать, но не дописывает. Выдайте роботу роль Редактор.
Замена затронула бы слишком много мест. Отмените действие и используйте более уникальный плейсхолдер либо сложное изменение через batch_update.
Не видно отдельную вкладку. Попросите агента сначала получить весь текст и перечислить найденные вкладки, затем работать с нужной.
Ресурс недоступен после смены владельца. Повторно откройте доступ роботу и обновите список в приложении.