Навык «Диск на своём сервере (WebDAV)»

Навык подключает к Искре файловое хранилище, которое работает по протоколу WebDAV: Nextcloud, ownCloud, Synology DSM, корпоративный Apache или nginx с включённым DAV. Агент видит список папок, ищет файлы по имени, скачивает их в разговор и загружает файлы из чата обратно на сервер. Этот навык работает с вашим WebDAV-хранилищем; синхронизация папок компьютера через «Диск» Искры настраивается отдельно.

Пароль, введённый в форму подключения, хранится в защищённом хранилище и не передаётся AI-модели или коду навыка. Сервер Искры использует его для входа на указанный WebDAV-сервер по HTTPS и выполняет запросы к файлам и папкам.

Подключение

1. Узнайте адрес WebDAV у своего хранилища:
   • Nextcloud / ownCloud — https://<хост>/remote.php/dav/files/<логин>/ (адрес показан в настройках файлов, раздел «WebDAV»);
   • Synology DSM — включите пакет WebDAV Server, адрес вида https://<хост>:5006/;
   • Корпоративный сервер — адрес выдаёт администратор.
2. Создайте пароль приложения, если хранилище их поддерживает (Nextcloud: «Настройки» → «Безопасность» → «Устройства и сеансы» → «Создать новый пароль приложения»). Пароль приложения WebDAV — отдельный от паролей для почты и календаря.
3. В Искре: Витрина навыков → «Диск на своём сервере (WebDAV)» → добавить в личный профиль → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает страница навыка → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к WebDAV-серверу»:
   • Название подключения — короткое имя хранилища одним словом без /, например work или nas. Пока подключение одно, оно служит только подписью карточки; когда подключений два и больше, оно становится папкой верхнего уровня в путях (см. «Несколько хранилищ»), поэтому название обязано быть годным именем папки уже сейчас;
   • Логин — имя пользователя на сервере;
   • Адрес сервера — полный адрес с путём, обязательно https:// (http:// Искра заменит на https://, по незащищённому протоколу подключение не пойдёт);
   • Пароль приложения — поле write-only: посмотреть сохранённое значение нельзя, только заменить.
4. Попросите: «Проверь подключение к диску». Искра сообщит, удалось ли подключиться, или назовёт причину: неверный пароль, сервер не найден либо адрес заблокирован.

Организация может задать общее подключение для всех сотрудников (настройки навыка в области организации). Тогда форма перед каждой записью показывает адрес сервера, область подключения (организация) и логин. Для личного подключения форма показывает область профиль. Если эти настройки изменились, пока форма была открыта, Искра ничего не записывает и просит подтвердить операцию заново.

Пароль вводите через форму настроек навыка: там он сохраняется отдельно от переписки. Пароль, отправленный обычным сообщением, становится частью чата и доступен AI-модели.

Несколько хранилищ

Один установленный навык подключает до десяти хранилищ: например, корпоративный Nextcloud и домашний Synology. В форме настроек каждое подключение — отдельная карточка со своим названием; кнопка «Добавить подключение» доступна, пока не набрано десять. Хранилища равноправны, «текущего» или «главного» нет, и ни один инструмент не просит выбрать подключение — его называет путь:

• Одно подключение — пути пишутся от корня хранилища: «Документы/Отчёты».
• Два и больше — первая часть любого пути — название подключения: «work/Документы/Отчёты», «home/Фото». Корень хранилища («покажи, что есть на диске») показывает названия подключений как папки верхнего уровня. Регистр букв в названии не важен: Work/Документы и work/Документы — одно и то же подключение. Названия из разных алфавитов или с разными пробельными символами, выглядящие одинаково, считаются разными.
• Поиск идёт внутри одного хранилища: «найди отчёт в work». Чтобы найти файл во всех хранилищах, агент повторит поиск по каждому названию из корня.
• Копирование и перемещение работают внутри одного хранилища. Чтобы перенести файл в другое, попросите скачать его в разговор и загрузить в нужное хранилище.
• Форма перед записью называет подключение, сервер, область и логин. Если исправить путь в форме на другое подключение, Искра ничего не записывает и просит подтвердить операцию заново.
• Проверка подключения («проверь подключения к дискам») опрашивает каждое хранилище и называет, какая коллекция подключений действует — личная или организации.
• Одинаковые названия. Если два подключения названы одинаково (с учётом регистра: work и Work — одно название), оба недоступны по пути, пока одно из них не переименовано; агент называет пару и открывает форму настроек. Название с / или невидимыми символами не годится как имя папки — такое подключение показано отдельно в корне и по пути недостижимо.
• Переходы. Когда к единственному подключению добавляется второе, пути меняют вид (появляется название); когда подключений снова остаётся одно, пути пишутся без названия — старый путь вида work/Документы в этом случае читается как обычная папка work оставшегося хранилища.
• Обновление с прежней версии навыка. Единственное подключение, настроенное до появления названия, показано как ненастроенное, пока не введено название; пароль вводить заново не нужно.

Личные и организационные подключения не складываются. Если у организации настроены общие хранилища, а вы завели личное подключение, для вас действует только личная коллекция — организационные хранилища перестают использоваться, пока личная коллекция существует. Предел в десять подключений считается по действующей коллекции. Форма настроек предупреждает об этом перед созданием первого личного подключения.

Что умеет

• Список папки — «покажи, что лежит в папке Документы»: имя, размер, дата изменения; по умолчанию до 100 записей, дальше — «показать ещё».
• Поиск по имени — «найди файл со словом отчёт»: обход дерева на глубину до 3 уровней (максимум 5), не больше 500 результатов; поиска по содержимому нет.
• Скачать файл — файл сохраняется в артефакты разговора и открывается в панели артефактов; предел — 8 МБ на файл.
• Загрузить файл — источник только файлы текущего разговора (приложенные к сообщению или созданные агентом), до 3 МБ на файл; агент показывает форму с неизменяемым фактическим путём исходного файла, папкой назначения, редактируемым именем на сервере и галочкой «перезаписать». Загрузка идёт только по кнопке «Загрузить файл».
• Создать папку — по кнопке «Создать папку» в форме.
• Скопировать, переместить или переименовать — переименование это перемещение с новым именем в той же папке; перед операцией агент показывает форму с исходным и новым путём. Изменение выполняется только по кнопке формы; отмена или таймаут формы ничего не копируют и не перемещают.
• Удалить — после вашего согласия в чате агент показывает форму с путём; удаление выполняется только по кнопке «Удалить безвозвратно», отмена формы ничего не удаляет. Корзины нет: удаление безвозвратно, восстановить файл через Искру нельзя.

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

Ограничения

• Поддерживаются серверы с Basic-аутентификацией по HTTPS (пароль или пароль приложения). Если сервер принимает только Digest, Kerberos или корпоративный вход через браузер, агент ответит, что такой способ входа не поддерживается — попросите администратора включить Basic по HTTPS или пароли приложений.
• Сертификат сервера должен быть доверенным: самоподписанный сертификат даёт ошибку защищённого соединения.
• Скачиваются файлы до 8 МБ, загружаются из чата — до 3 МБ (ограничение канала файлов разговора).
• Файлы и папки адресуются путём: если сервер отдаёт версии или варианты файла через «?» в адресе, такие записи в списке не показываются.
• Файл может не появиться в списке, если сервер неоднозначно передаёт специальные знаки в его адресе. Например, + и %2B не на каждом сервере или прокси указывают на один файл. Попробуйте упростить имя в интерфейсе хранилища; администратор может проверить кодирование адреса на сервере.
• Навык не следует перенаправлениям сервера. Если сервер отвечает на запрос перенаправлением на другой адрес, агент сообщит об этом — укажите в настройках тот адрес, который сервер считает основным.
• Адрес во внутренней сети (например https://cloud.corp.local) по умолчанию заблокирован политикой безопасности. Для доступа администратор контура Искры должен разрешить внутренние WebDAV-подключения и внести сервер в список разрешённых — см. раздел «Типичные ошибки».

Типичные ошибки

Передача пароля и безопасность WebDAV

Пароль WebDAV, введённый в форму подключения, хранится в защищённом хранилище отдельно от переписки: AI-модель и код навыка не получают его из настроек. Сервер Искры использует этот пароль для входа на настроенный WebDAV-сервер по HTTPS (Basic-аутентификация). Сохранённое значение нельзя посмотреть в настройках повторно — его можно заменить. Логин и адрес сервера являются обычными параметрами и видны Искре при проверке подключения.

Пароль, отправленный обычным сообщением, становится частью чата и доступен AI-модели. Форма подключения не скрывает и не удаляет такой текст из переписки. Для подключения WebDAV используйте поле пароля в форме.

• Пароль передаётся только на тот же хост и порт, которые указаны в настройках, при обращении к файлам и папкам этого хранилища. Соседний поддомен или другой порт не подходят. HTTP-перенаправления не выполняются.
• Подключение только по HTTPS; каждый адрес проверяется по IP перед соединением. Доступ во внутреннюю сеть требует разрешения таких подключений в контуре и включения сервера в список администратора. Служебные адреса (link-local, metadata) остаются закрыты.
• В обычные служебные журналы операций WebDAV не попадают пароль из настроек, имена файлов и их содержимое.
• Режим «действовать без переспроса», который есть у некоторых навыков, для этого навыка не предлагается: запись и удаление всегда ждут вашей кнопки в форме. Так ошибка агента или инструкция, спрятанная в присланном документе, не может ничего удалить или перезаписать без вас.