Notion

Notion — рабочие пространства: страницы и базы данных. Блок читает и пишет страницы, создаёт базы, ищет по workspace и добавляет строки.

С Notion в Pailot вы можете:

Читать страницу (markdown) и схему базы
Дописывать текст на страницу и создавать дочернюю страницу
Запрашивать строки базы с фильтром и сортировкой (JSON)
Искать по всем страницам и базам workspace
Создавать базу с произвольными свойствами и добавлять строку

Нужен вход по OAuth (вход по разрешению сервиса) или интеграционный токен Notion. Страницу или базу нужно открыть для интеграции в Notion.

Блок ставят на холст как отдельный шаг или прикрепляют к агенту.

Инструменты

`notion_read`

Прочитать содержимое страницы Notion.

Вход

Параметр	Тип	Обязательный	Описание
`pageId`	string	Да	ID страницы Notion

Выход

Параметр	Тип	Описание
`content`	string	Содержимое страницы в markdown
`title`	string	Заголовок страницы
`url`	string	URL страницы
`created_time`	string	Время создания
`last_edited_time`	string	Время последнего изменения

`notion_read_database`

Прочитать сведения и схему базы Notion.

Вход

Параметр	Тип	Обязательный	Описание
`databaseId`	string	Да	ID базы Notion

Выход

Параметр	Тип	Описание
`id`	string	ID базы
`title`	string	Название базы
`url`	string	URL базы
`created_time`	string	Время создания
`last_edited_time`	string	Время последнего изменения
`properties`	object	Схема свойств базы

`notion_write`

Дописать содержимое на страницу Notion.

Вход

Параметр	Тип	Обязательный	Описание
`pageId`	string	Да	ID страницы
`content`	string	Да	Текст, который дописать

Выход

Параметр	Тип	Описание
`appended`	boolean	Удалось ли дописать содержимое

`notion_create_page`

Создать страницу Notion.

Вход

Параметр	Тип	Обязательный	Описание
`parentId`	string	Да	ID родительской страницы
`title`	string	Нет	Заголовок новой страницы
`content`	string	Нет	Необязательный текст при создании

Выход

Параметр	Тип	Описание
`id`	string	ID страницы
`title`	string	Заголовок
`url`	string	URL страницы
`created_time`	string	Время создания
`last_edited_time`	string	Время последнего изменения

`notion_query_database`

Запросить и отфильтровать строки базы Notion.

Вход

Параметр	Тип	Обязательный	Описание
`databaseId`	string	Да	ID базы
`filter`	string	Нет	Условия фильтра — JSON
`sorts`	string	Нет	Сортировка — JSON-массив
`pageSize`	number	Нет	Число результатов (по умолчанию 100, макс. 100)

Выход

Параметр	Тип	Описание
`results`	array	Страницы (строки) из базы
↳ `id`	string	ID страницы
↳ `created_time`	string	Время создания
↳ `last_edited_time`	string	Время последнего изменения
↳ `url`	string	URL страницы
`has_more`	boolean	Есть ли ещё результаты
`next_cursor`	string	Курсор следующей страницы
`total_results`	number	Сколько результатов в ответе

`notion_search`

Поиск по всем страницам и базам workspace Notion.

Вход

Параметр	Тип	Обязательный	Описание
`query`	string	Нет	Поисковая строка (пусто — все страницы)
`filterType`	string	Нет	Тип объекта: page, database или пусто — все
`pageSize`	number	Нет	Число результатов (по умолчанию 100, макс. 100)

Выход

Параметр	Тип	Описание
`results`	array	Результаты поиска (страницы и базы)
↳ `id`	string	ID объекта
↳ `object`	string	Тип объекта (page или database)
↳ `url`	string	URL объекта
↳ `created_time`	string	Время создания
↳ `last_edited_time`	string	Время последнего изменения
`has_more`	boolean	Есть ли ещё результаты
`next_cursor`	string	Курсор следующей страницы
`total_results`	number	Сколько результатов в ответе

`notion_create_database`

Создать базу Notion с произвольными свойствами.

Вход

Параметр	Тип	Обязательный	Описание
`parentId`	string	Да	ID родительской страницы
`title`	string	Да	Название базы
`properties`	json	Нет	Свойства базы — JSON. Если пусто, создаётся свойство Name

Выход

Параметр	Тип	Описание
`id`	string	ID базы
`title`	string	Название базы
`url`	string	URL базы
`created_time`	string	Время создания
`properties`	object	Схема свойств базы

`notion_add_database_row`

Добавить строку в базу Notion.

Вход

Параметр	Тип	Обязательный	Описание
`databaseId`	string	Да	ID базы
`properties`	json	Да	Свойства строки — JSON по схеме базы (например {"Name": {"title": [{"text": {"content": "Task 1"}}]}, "Status": {"select": {"name": "Done"}}})

Выход

Параметр	Тип	Описание
`id`	string	ID страницы/строки
`url`	string	URL строки
`title`	string	Заголовок строки
`created_time`	string	Время создания
`last_edited_time`	string	Время последнего изменения

Notion

На этой странице