Интеграция Yonote с ИИ-агентом — это подключение вашей корпоративной вики Yonote (российский аналог Notion) к ассистенту СуперИнтеллекта, после которого агент по вашему API-токену читает документы, ищет по базе знаний, создаёт и обновляет страницы прямо из чата. В этом гайде разберём по шагам: где взять токен, как настроить права и как привязать коннектор к нужному агенту.
Зачем подключать Yonote к ИИ-агенту
Yonote — это база знаний, регламенты, проектные документы и заметки команды. Обычно за нужной информацией сотрудник идёт в вики, ищет документ, читает, копирует куски в чат. Когда Yonote подключён к ИИ-агенту, эти шаги берёт на себя ассистент: он сам находит документ, читает его, отвечает на вопрос по содержимому, а при необходимости создаёт новую страницу или дописывает раздел — всё обычными фразами в едином окне СуперИнтеллекта.
- Отвечать на вопросы по регламентам и документации, ссылаясь на реальные страницы вики.
- Находить нужный документ или коллекцию по описанию, а не по точному названию.
- Создавать черновики страниц, протоколы встреч, карточки задач по шаблону.
- Дописывать разделы и обновлять существующие документы без ручного копипаста.
- Наводить порядок: перемещать документы между коллекциями и архивировать устаревшее.
Что умеет агент с Yonote
Коннектор Yonote даёт агенту 10 инструментов для работы с документами и коллекциями. Полный CRUD по документам (создание, чтение, изменение, архивирование) плюс навигация по структуре вики и чтение комментариев.
| Что делает агент | Инструменты | Права |
|---|---|---|
| Полнотекстовый поиск по документам | yonote_search_documents | Чтение |
| Чтение документа и списка документов | yonote_get_document, yonote_list_documents | Чтение |
| Список коллекций и структура коллекции-дерева | yonote_list_collections, yonote_get_collection_structure | Чтение |
| Чтение комментариев к документу | yonote_list_comments | Чтение |
| Создание и обновление документов | yonote_create_document, yonote_update_document | Запись |
| Перемещение документа между коллекциями | yonote_move_document | Запись |
| Архивирование документа | yonote_archive_document | Удаление |
Шаг 1. Где взять API-токен Yonote
Коннектор работает по вашему личному API-токену Yonote — вы приносите его сами, платформа хранит токен на своей стороне и использует только для вызовов от имени вашего агента.
- Войдите в свой аккаунт Yonote на yonote.ru.
- Откройте Настройки → API-токены.
- Нажмите «Создать токен» и задайте понятное название (например, «СуперИнтеллект-агент»).
- Скопируйте токен сразу после создания и сохраните его — обычно полное значение показывается только один раз.
Шаг 2. Подключить коннектор в разделе «Интеграции»
Дальше токен добавляется на платформе. Коннекторы живут в настройках конкретного ИИ-ассистента, поэтому сначала откройте того агента, которому нужен доступ к вики.
- Откройте нужного ассистента и перейдите в раздел «Интеграции» — это каталог коннекторов.
- Найдите в каталоге Yonote и нажмите «Подключить».
- Вставьте API-токен из Шага 1 в поле токена.
- Сохраните — токен останется на стороне платформы, повторно вводить его не нужно.
Шаг 3. Настроить права: read, write, delete
У коннектора три уровня прав, и по умолчанию включено только чтение (read). Это безопасная стартовая точка: агент отвечает на вопросы и ищет по вики, но ничего не меняет. Запись и удаление владелец включает осознанно, когда действительно нужно, чтобы агент создавал и правил документы.
| Право | Что разрешает | По умолчанию |
|---|---|---|
| read (чтение) | Поиск, чтение документов, коллекций и комментариев | Включено |
| write (запись) | Создание, обновление и перемещение документов | Выключено |
| delete (удаление) | Архивирование документов | Выключено |
Шаг 4. Привязать коннектор к агенту и включить «ИИ-агент»
Коннектор подключается к конкретному ассистенту, поэтому в диалоге, где вы хотите работать с Yonote, должна быть включена кнопка «ИИ-агент» — именно она разрешает ассистенту вызывать инструменты интеграций. Без неё модель просто отвечает текстом и в вашу вики не заходит.
- Убедитесь, что коннектор Yonote привязан к нужному ассистенту в разделе «Интеграции».
- Откройте чат с этим ассистентом и включите режим «ИИ-агент».
- Задайте задачу обычной фразой — агент сам подберёт нужные инструменты Yonote.
Примеры промптов
С агентом не нужно указывать названия инструментов — формулируйте задачу как коллеге, который умеет работать с вашей вики.
- «Найди в Yonote регламент по онбордингу новых сотрудников и перескажи ключевые шаги».
- «Что у нас в базе знаний написано про возврат товара? Дай короткий ответ и ссылку на документ».
- «Покажи, какие коллекции есть в нашей вики, и что лежит в коллекции „Продукт“».
- «Создай в коллекции „Встречи“ документ с протоколом сегодняшнего созвона по этому тексту…» (право write).
- «Допиши в документ „Политика отпусков“ раздел про удалённую работу» (право write).
- «Перенеси устаревший документ „Тарифы 2024“ в архив» (право delete).
Безопасность и хорошие практики
- Начинайте с прав только на чтение и расширяйте по мере доверия к сценарию.
- Создавайте отдельный токен под интеграцию с говорящим названием — его легко отозвать в настройках Yonote, не задев другие интеграции.
- Ограничивайте область доступа выбором учётной записи, под которой создан токен: агент видит ровно её коллекции.
- Для действий с записью и архивированием держите режим подтверждения вызовов, если нужен контроль над каждым изменением.
- Периодически проверяйте список активных API-токенов в Yonote и удаляйте неиспользуемые.
Частые вопросы
Нужны ли навыки программирования, чтобы подключить Yonote?
Нет. Всё делается через интерфейс: создать токен в Yonote, вставить его в разделе «Интеграции» у ассистента и включить нужные права. Работа с вики происходит обычными фразами в чате.
Где хранится мой API-токен?
Токен вводится один раз и хранится на стороне платформы. Он используется только для вызовов Yonote от имени вашего агента; в переписке и ответах модели он не показывается.
Сможет ли агент случайно удалить документ из вики?
Нет, пока вы не включите право на удаление. По умолчанию активно только чтение. Более того, «удаление» в Yonote — это архивирование, то есть документ можно восстановить средствами самого сервиса.
Можно ли подключить сразу несколько баз знаний?
Да. В разделе «Интеграции» одному агенту можно подключить несколько коннекторов — например, Yonote вместе с другими хранилищами и вики. Агент сам выберет нужный источник под конкретный запрос.
Чем Yonote отличается от подключения Notion?
Yonote — российский аналог Notion, и логика подключения та же: свой токен, права по умолчанию только на чтение, привязка к агенту. Отличаются наборы инструментов и место, где берётся токен: в Yonote это Настройки → API-токены.
Готовы подключить свою вики? Оформите коннектор в разделе «Интеграции» у ассистента, включите «ИИ-агент» — и агент начнёт работать с вашими документами Yonote прямо в чате.
