Платформа
Яндекс Вики
Поиск, чтение и обновление базы знаний рабочего пространства.
Яндекс Вики
Приложение Яндекс Вики подключает базу знаний организации к Promto. Агент ищет и читает страницы, собирает ответы со ссылками на источник, просматривает дерево разделов и вложения, а после подтверждения создаёт или обновляет страницы.
Назначение
Вики полезна для работы с внутренними знаниями:
- найти ответ в регламентах и инструкциях;
- собрать список источников и дат обновления;
- просмотреть подразделы и вложения;
- найти устаревшие или дублирующиеся страницы;
- создать страницу с итогами встречи;
- безопасно дополнить существующую инструкцию;
- подготовить карту материалов для нового сотрудника.
Подключение
Подключить и отключить Вики может владелец рабочего пространства. Для подключения нужны ID организации и её тип:
- Яндекс 360 — запросы используют
X-Org-Id; - Yandex Identity Hub — запросы используют
X-Cloud-Org-Id.
- Откройте Яндекс Вики → Настройки.
- Выберите тип организации и укажите её ID. Его можно посмотреть в Яндекс Трекере: Администрирование → Организации.
- Нажмите Получить код подтверждения.
- На странице Яндекса войдите под аккаунтом, которому доступны нужные страницы.
- Введите код и разрешите доступ.
- Дождитесь появления верхних разделов Вики.
При ручном подключении создайте приложение Яндекс OAuth с правами чтения Вики и, если нужны изменения, с правом записи. Затем укажите токен, ID и тип организации.
Интерфейс
На Главной доступны сценарии ответа по регламенту, страницы с итогами встречи, ревизии раздела, обновления инструкции, анализа вложений и карты для новичка.
В Настройках видны маска токена, ID и тип организации, верхние разделы Вики, их адреса и типы страниц. Если корневые разделы не отображаются, агент всё ещё может открыть страницу по прямому slug, если она доступна подключённому пользователю.
Возможности агента
Основной агент использует promto_wiki.
| Задача | Действия |
|---|---|
| Страницы | get_page, list_subpages |
| Поиск | search |
| Создание и изменение | create_page, update_page, delete_page |
| Вложения | list_attachments |
| Дополнительные методы API | request |
Страницы адресуются через иерархический slug, например users/team/instruction, либо через числовой ID, который вернул API. Агент сначала ищет страницу или получает дерево раздела, а не угадывает адрес.
Сценарии
Ответить по регламенту
Агент ищет релевантные страницы, составляет короткий ответ и указывает название, slug и дату обновления источника.
Создать страницу с итогами встречи
Укажите раздел, заголовок и заметки. Агент покажет структуру страницы, затем создаст её после подтверждения.
Обновить инструкцию без потери правок
Для добавления блока агент использует режим append, который не заменяет весь текст. Если требуется полная замена, он сначала перечитывает страницу и показывает точный результат.
Ограничения и безопасность
- Агент видит ровно те страницы, которые открыты подключённому пользователю.
- Полная замена
contentперезаписывает всё тело страницы и требует подтверждения. Для дополнения безопаснееmode=append. - При обычном обновлении Promto включает слияние параллельных изменений, но перед крупной правкой всё равно нужно перечитать свежую версию.
- Удаление страницы требует отдельного подтверждения. Если API вернул
recovery_token, сохраните его: он нужен для восстановления. - При записи уведомления наблюдателям страницы по умолчанию не рассылаются, чтобы массовая работа агента не создавала лишних уведомлений.
- Формат содержимого зависит от типа страницы: современные страницы используют YFM, старые могут использовать другой формат.
- Токен хранится только на сервере и не передаётся агенту.
Если что-то не работает
Вики не принимает подключение. Проверьте одновременно ID и тип организации; без правильного служебного заголовка любой запрос будет отклонён.
Верхние разделы не появились. У подключённого пользователя может не быть доступа к корневым страницам. Попробуйте найти доступную страницу по точному адресу.
Поиск не находит страницу. Уточните формулировку, проверьте права и попросите агента просмотреть дерево предполагаемого раздела.
Обновление требует подтверждения. Агент пытается заменить весь текст. Проверьте предложенный результат или попросите безопасно дописать блок через append.
OAuth недоступен для SSO-аккаунта. Используйте аккаунт организации, которому Яндекс выдаёт пользовательский OAuth-токен.