Google Docs, Miro и другие внешние документы

Часть знаний команды живёт не в Hivelore и переезжать не собирается: рабочий Google-док, дека для заказчика, доска Miro с архитектурой. Такой документ подключается: он остаётся у себя, но становится виден поиску, ассистенту и агенту наравне со страницами.

Три источника: Google Документы, Google Презентации и доски Miro. Таблицы Google и другие сервисы пока не подключаются.

Как подключить

• Ссылкой в тексте. Вставьте ссылку на документ в страницу — в панели ссылки появится кнопка «В базу знаний». Она же показывает состояние: «Индексирую…», «В базе знаний ✓», «Нет доступа» или «Ошибка — повторить»; повторное нажатие перечитывает документ заново.
• Слэш-командой — /gdoc, /gslides, /miro со ссылкой (по-русски тоже: /документ, /презентация, /доска).
• С экрана «Внешние документы» — пункт под деревом страниц, кнопка «+ Добавить документ».
• Из чата — командой /add <ссылка>.

Что за источник — решает сама ссылка, а не выбранный пункт меню: перепутать нельзя. Подключать может тот, у кого есть право на правку.

Карточка и предпросмотр

Одинокая ссылка на известный источник разворачивается в карточку со значком, названием и кратким описанием документа; описание считается автоматически и обновляется, только когда меняется сам текст. По клику выезжает панель предпросмотра — содержимое читается, не уходя из Hivelore.

В markdown карточка хранится обычной ссылкой, поэтому выгруженный файл остаётся рабочим и вне продукта.

Что попадает в поиск

Документ разбирается на разделы, и выдача ведёт в нужное место, а не на документ целиком:

У доски порядок чтения — сверху вниз и слева направо, айтемы вне фреймов сходятся в один безымянный раздел. Доска, размеченная фреймами по темам, разбирается заметно точнее плотной россыпи стикеров. Коннекторы, картинки и вложения с доски не читаются.

Доступ к приватным документам

Google. Документ, открытый «всем, у кого есть ссылка», индексируется без всякого подключения. Приватный читается от вашего имени: Настройки → Профиль и подключения → Google Документы → «Подключить Google», и Hivelore будет открывать документы с вашим доступом, только на чтение. Подключение личное, а не проектное. Отозвали доступ на стороне Google — появится просьба подключить заново («Переподключить Google»), уже подключённые документы при этом не ломаются.

Miro. У досок публичного экспорта по ссылке нет вовсе, поэтому доска читается общим токеном интеграции Hivelore. Персонального подключения к Miro, как у Google, пока нет: если доска недоступна этому токену, при добавлении придёт понятная ошибка.

Экран «Внешние документы»

Отдельный экран со списком подключённого — пункт под деревом страниц: поиск по содержимому, фильтр по владельцу, таблица или плитки. У каждого документа видно описание, кто подключил, когда импортирован и когда синхронизирован в последний раз.

Чем это отличается от импорта

Подключённый документ остаётся чужим: он читается там, где лежит, и обновляется перечитыванием. Импортированный файл становится вашей страницей — её правят, версионируют, она попадает в дерево, граф и корзину. Выбор простой: живой документ, который ведут в Google, — подключайте; выгрузку из старой вики — импортируйте, см. Импорт и экспорт.

Notion — особый случай: его не подключают, а переносят целиком, по токену интеграции, см. там же.

Что с этим делает агент

Подключённый документ агент читает тем же инструментом, что и страницы, — по ссылке или идентификатору. Отсюда обычный сценарий: «прочитай вот этот Google-док и заведи по нему страницу» — агент читает оригинал и предлагает страницу, которую вы подтверждаете. См. Что агент умеет.