Microsoft Excel — таблицы. Блок читает и пишет ячейки выбранного листа в книге.
С Microsoft Excel в Pailot вы можете:
- Читать диапазон или всю использованную область листа
- Записывать двумерный массив или массив объектов в указанный диапазон
- Получать ID и URL книги в ответе
Нужен вход по OAuth (вход по разрешению сервиса) Microsoft 365.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Подключение — через учётные данные блока.
Инструменты
microsoft_excel_read
Прочитать данные с указанного листа книги Excel.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
spreadsheetId | string | Да | ID книги |
sheetName | string | Да | Имя листа |
cellRange | string | Нет | Диапазон ячеек (например A1:D10). Если не задан — вся использованная область |
Выход
| Параметр | Тип | Описание |
|---|---|---|
sheetName | string | Имя прочитанного листа |
range | string | Прочитанный диапазон |
values | array | Строки со значениями ячеек |
metadata | json | Служебные данные книги: ID и URL |
↳ spreadsheetId | string | ID книги Excel |
↳ spreadsheetUrl | string | URL книги |
microsoft_excel_write
Записать данные на указанный лист книги Excel.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
spreadsheetId | string | Да | ID книги |
sheetName | string | Да | Имя листа |
cellRange | string | Нет | Диапазон записи (например A1:D10 или A1). По умолчанию A1 |
values | array | Да | Данные: двумерный массив (например [["Name", "Age"], ["Alice", 30]]) или массив объектов |
valueInputOption | string | Нет | Формат записываемых значений |
includeValuesInResponse | boolean | Нет | Вернуть записанные значения в ответе |
Выход
| Параметр | Тип | Описание |
|---|---|---|
updatedRange | string | Обновлённый диапазон |
updatedRows | number | Сколько строк обновлено |
updatedColumns | number | Сколько столбцов обновлено |
updatedCells | number | Сколько ячеек обновлено |
metadata | json | Служебные данные книги: ID и URL |
↳ spreadsheetId | string | ID книги Excel |
↳ spreadsheetUrl | string | URL книги |