Отвечайте по регламентам из базы знаний Яндекс Вики
Подключите Яндекс Вики к ИИ-агенту: страницы, разделы, динамические таблицы и вложения. Агент найдёт ответ в регламенте и заведёт страницу с итогами.
Как агент работает с Яндекс Вики
Агент работает с базой знаний через API на api.wiki.yandex.net: обходит дерево разделов и страниц, читает тексты, вложения и динамические таблицы. На этом он отвечает по внутренним регламентам и всегда называет страницу-источник, а при ревизии раздела показывает, что давно не обновлялось, и собирает список дублей — вопрос, на который в интерфейсе Вики отвечают перелистыванием дерева вручную.
Страница в Вики адресуется своим путём: агент запрашивает её по slug и явно перечисляет нужные поля, потому что API не отдаёт всё содержимое по умолчанию. Отсюда практическое следствие: если страницу перенесли в другой раздел, её адрес меняется, и агент ищет заново по дереву и заголовку, а не считает, что документа больше нет. Ссылку в ответе он даёт на ту страницу, откуда взял факт.
На запись агент заводит страницу в нужном разделе, раскладывает по пунктам итоги и решения, прикладывает файлы обсуждения, обновляет строки динамической таблицы по расписанию и дописывает сводку в конец. Правка страницы — это замена содержимого, поэтому перед сохранением агент перечитывает текущую версию и складывает новое поверх неё, а не поверх устаревшей копии. Удаление подстраниц он подтверждает у вас отдельно.
Видит агент ровно то, что видит подключённый аккаунт, и правит только те страницы, где у аккаунта есть право на запись. Дерево разделов он обходит порциями, а не выкачивает базу знаний целиком: сначала оглавление, потом содержимое нужных страниц и вложений, поэтому большой раздел не превращается в сотни запросов подряд. Частоту он выдерживает сам, а закрытую страницу называет закрытой, вместо того чтобы ответить будто её не существует.
Сценарии интеграции
Ответ по регламенту
Агент найдёт нужное в страницах базы знаний, соберёт ответ и укажет, на какой именно странице это записано.
Страница с итогами встречи
Агент заведёт страницу в нужном разделе, разложит итоги и решения по пунктам и приложит к ней файлы обсуждения.
Динамическая таблица статусов
Агент обновит строки динамической таблицы по расписанию и допишет короткую сводку в конец страницы.
Ревизия раздела базы знаний
Агент пройдёт по дереву страниц раздела, покажет, что давно не обновлялось, и соберёт список страниц-дублей.
Обновить устаревшую инструкцию
Агент перечитает текущую версию страницы, впишет изменения в нужные пункты и сохранит поверх свежего текста — чужие правки при этом не затрутся.
Что лежит во вложениях
Агент пройдёт по вложениям страниц раздела, скажет, какие файлы к ним приложены, и вытащит нужные цифры со ссылкой на страницу-источник.
Примеры: Яндекс Вики
Заявка за 5 рабочих дней, согласует руководитель и финдиректор — если поездка дороже 80 тыс ₽.
Это со страницы «Регламенты / Командировки», обновлялась 14 мая. Суточные по России — 1 200 ₽, авансовый отчёт сдаётся в течение трёх дней после возвращения.
Ассистент может ошибаться — проверяйте его работу
В разделе «Процессы» 96 страниц, 41 не обновлялась больше года.
- От года до двух лет без правок — 23 страницы
- Больше двух лет — 18 страниц
- Дубли по заголовку — 7 пар
Дубли ловил по заголовкам и первому экрану текста: полнотекстовый поиск вики ранжирует, а не сравнивает построчно. На две страницы раздела мне не выданы права — в ревизию они не вошли.
Ассистент может ошибаться — проверяйте его работу
Как подключить
Перед подключением
- Организация в Яндекс 360 для бизнеса с подключённой Вики.
- Понимание, что нужно агенту: только чтение или ещё правки страниц.
- 1
Войдите в Вики рабочим аккаунтом
Вики живёт в организации Яндекс 360 для бизнеса. Откройте wiki.yandex.ru, при нескольких организациях — «Продолжить».
- 2
Возьмите обычный, а не сервисный аккаунт
Сервисным аккаунтам API Вики закрыт, а федеративным нужен IAM-токен Яндекс Облака. Подойдёт обычный рабочий аккаунт.
- 3
Откройте нужные страницы своему аккаунту
Права в API те же, что у аккаунта в Вики. Нажмите сверху кнопку доступа («Всем сотрудникам») — откроется «Доступ к странице».
- 4
Выдайте роль под задачу агента
В поле «Добавить сотрудника или группу» укажите себя и выберите роль: «Читатель» — чтение, «Редактор» — правки страниц.
Частые вопросы
По коду подтверждения Яндекс ID: нажмите «Подключить», введите код на странице Яндекса и подтвердите доступ обычным рабочим аккаунтом организации. Сервисным аккаунтам API Вики закрыт, а федеративным нужен IAM-токен Яндекс Облака.
Ровно те страницы, разделы, вложения и динамические таблицы, что видны подключённому аккаунту: чего он не видит в Вики, того не будет и у агента.
Да, если аккаунту выдана роль «Редактор» и выше: «Редактор» правит страницу, «Редактор +» ещё создаёт подстраницы и удаляет их. Роль «Читатель» даёт только чтение.
На странице сверху нажмите кнопку текущего доступа («Всем сотрудникам» или «Некоторым сотрудникам»), в окне «Доступ к странице» добавьте подключённый аккаунт и выберите роль.