Плагин Р7-Офис: установка¶

Плагин Р13.Орбита для Р7-Офис Таблицы встраивает AI-чат прямо в интерфейс таблиц. Задавайте вопросы на русском языке, получайте данные и переносите таблицы на лист перетаскиванием мышью — без SQL и формул.

Возможности¶

• Запросы к корпоративным данным из боковой панели Р7-Офис Таблицы
• Перенос результатов на лист перетаскиванием (drag & drop)
• Построение графиков и визуализаций
• Работа с историей чатов и сохранёнными датасетами
• Аутентификация через Keycloak (SSO) — если настроена администратором

Требования¶

• Р7-Офис с поддержкой плагинов (sdkjs-plugins)
• Доступ к API Р13.Орбита (http://your-server:8000) с компьютера пользователя
• Запущенный сервер Р13.Орбита — см. Установка
• Файл плагина (.plugin) — собирается из исходников или поставляется администратором

Получение файла плагина¶

Администратор предоставляет файл с именем вида:

orbita_r7_plugin-vX.X.X.plugin

Сохраните его на компьютер перед установкой.

Установка¶

Плагин устанавливается через встроенный менеджер плагинов Р7-Офис.

1. Откройте любой файл Таблицы (или создайте новый)
2. В верхнем меню выберите Плагины → Менеджер плагинов
3. Нажмите кнопку Добавить (или Установить из файла)
4. В диалоге выбора файла найдите и выберите файл orbita_r7_plugin-vX.X.X.plugin
5. Нажмите Открыть — плагин появится в списке установленных
6. Закройте менеджер плагинов

Проверка установки¶

После установки плагин должен появиться в меню Плагины под именем Р13.Орбита.

Если пункт меню не появился — полностью закройте Р7-Офис и откройте заново.

Первый запуск¶

1. Полностью закройте Р7-Офис (если был открыт) и запустите заново
2. Откройте любой файл Таблицы или создайте новый
3. В верхнем меню выберите Плагины → Р13.Орбита
4. В правой части экрана откроется боковая панель чата

Настройка подключения¶

При первом запуске плагин покажет экран настройки API:

1. В поле URL сервера введите адрес Р13.Орбита:

   http://your-server:8000
   

2. Нажмите Подключить

Чтобы проверить доступность сервера заранее:

curl http://your-server:8000/health
# Ожидаемый ответ: {"status": "healthy", ...}

Если адрес сервера неизвестен — обратитесь к администратору системы.

Аутентификация через Keycloak¶

Если в организации настроен SSO через Keycloak, плагин использует OAuth2 Device Flow — безопасный способ входа без передачи пароля в плагин.

1. После ввода URL сервера нажмите Войти
2. Плагин покажет короткий код, например GGJW-HQZN, и кнопку Открыть браузер
3. Нажмите Открыть браузер — откроется страница Keycloak
4. Введите корпоративные логин и пароль, подтвердите код
5. Плагин автоматически получит токен и откроет интерфейс чата — возвращаться в Р7-Офис вручную не нужно

Следующие шаги¶

После успешной установки см. руководство по работе с плагином.