Знания Эрмия через MCP

ИИ клиента — например, Codex или Claude — может читать источники Эрмия, готовить дополнения и публиковать их после вашего подтверждения. Эти инструменты не доступны встроенному чату.

Сначала определите проект и помощника

Создание и включение: ermiy_prepare_agent_changeset готовит точное изменение, ermiy_apply_agent_changeset применяет его после явного подтверждения владельца. Новый помощник остаётся черновиком; включается только выбранное подключение. Для старых помощников без проекта владелец использует ermiy_list_unassigned_agents и подтверждает проект по всем связанным сайтам. Имена сайтов не заменяют проверенные связи в Пространствах.

Подключите /mcp/v3, выберите provider lidfly и вызовите ermiy_list_agents с точным workspace_project_id. Затем используйте возвращённый agent_id. Если помощник не привязан к проекту Пространств, сначала нужно задать эту привязку; ИИ не создаёт проект молча.

ermiy_list_bindings, ermiy_list_knowledge_collections и ermiy_get_binding_knowledge_policy показывают, какие коллекции разрешены конкретному каналу. По умолчанию сайт не получает знания другого сайта.

Подготовьте и подтвердите изменения

В кабинете выберите помощника и вкладку «Знания». Ручные материалы редактируются обычным текстом. В секции «Разделы знаний и доступ на сайтах» можно создать раздел, изменить название и выбрать сайты, где он используется. Остальные разделы сайтов сохраняются. Перед применением покажем изменения для подтверждения.

1. Прочитайте текущие источники через ermiy_list_knowledge_sources и ermiy_get_knowledge_source.
2. Вызовите ermiy_prepare_knowledge_changeset. Операции: collection, source, archive, policy.
3. Проверьте preview. Политика заменяет весь список коллекций: сохраните в нём все нужные существующие IDs.
4. После вашего явного подтверждения ИИ вызывает ermiy_publish_knowledge_changeset с точными changeset_id, digest и confirmed:true.

Для одного действия есть сокращённые инструменты ermiy_create_knowledge_collection, ermiy_add_knowledge_text, ermiy_update_knowledge_source, ermiy_archive_knowledge_source и ermiy_update_binding_knowledge_policy. Они тоже только готовят изменение: публикация отдельная.

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

Дождитесь готовности нового снимка

ermiy_get_knowledge_readiness показывает активный снимок и состояние индексации. Новый снимок включается только после полной обработки. При ошибке продолжает работать предыдущая версия. Отзыв доступа к коллекции ограничивает выдачу сразу.

В ответ попадают только выбранные фрагменты разрешённых источников, а не все документы. Цены и наличие Эрмий получает из структурированных данных каталога, не из старой копии текста.

Переписки и документы

ermiy_list_conversations и ermiy_get_conversation_messages дают ограниченные страницы переписки с очисткой поддерживаемых персональных данных. Выводы ИИ не становятся знаниями автоматически: сначала preview и ваше подтверждение.

В знания можно добавить текст, выбранный документ того же проекта или загрузить PDF/DOCX до 5 МБ. В PDF допускается до 30 страниц; для страниц без текстового слоя выполняется распознавание русского и английского текста. Картинки внутри DOCX не распознаются. Проверьте весь текст, особенно артикулы и числа, исправьте ошибки и подтвердите применение — загрузка сама не меняет ответы помощника.

Подключите Эрмия из карточки проекта или сайта. Проект можно создать прямо при подключении. После подготовки проверьте приватный ответ, выберите оформление помощника и включите чат. В разделе подключения доступны кнопки слева или справа и поле по центру внизу страницы. Можно выбрать цвет акцента, тему и вид кнопки. Кнопка открывает правую панель на всю высоту окна; вопрос из центрального поля отправляется в эту же панель. Панель можно развернуть на всю ширину и закрыть, сохранив разговор. Документ проекта сохраняется как подтверждённая версия: после изменения оригинала выберите «Обновить из проекта» и подтвердите новый текст. Страницы сайта обновляются в знаниях после публикации.

При ручной установке на сайт со строгой Content Security Policy добавьте к скрипту Эрмия атрибут nonce со случайным значением для текущего ответа сервера. Разрешите это значение в script-src и style-src (или style-src-elem, если он задан): загрузчик передаст nonce своим стилям. Также разрешите домен LidFly в connect-src и frame-src. Без разрешения стилей оформление виджета будет заблокировано.

Неопубликованные оригиналы занимают до 50 МБ на аккаунт. После публикации или ошибки обработки оригинал удаляется, освобождая место; текст и история импорта сохраняются. Если распознавание не укладывается в отведённое время, разделите документ на файлы с меньшим числом страниц.

Через MCP используйте ermiy_request_document_upload, передайте файл отдельным PUT по полученному адресу и прочитайте результат через ermiy_get_document_import. Для восстановления списка есть ermiy_list_document_imports. При публикации источника укажите import_id, чтобы сохранить связь с оригиналом. Не включайте временный токен загрузки в переписку или документы.

ermiy_list_knowledge_findings пока показывает технические ошибки сборки, а не автоматический анализ смысловых противоречий. Приватный тестовый диалог до включения помощника также пока не реализован.