Перейти к содержанию

Часто задаваемые вопросы (FAQ)

Ответы на частые вопросы пользователей и администраторов Р13.Орбита.

Общие вопросы

Что такое Р13.Орбита?

Р13.Орбита - это интеллектуальная система для работы с корпоративными данными через естественный язык. Вы задаете вопросы на русском языке, система преобразует их в SQL, выполняет и возвращает результаты.

Нужно ли знать SQL для работы с Р13.Орбита?

Нет. Р13.Орбита предназначена для пользователей без технических навыков. Просто задавайте вопросы на русском языке.

Какие языки поддерживает Р13.Орбита?

Сейчас полностью поддерживается русский язык. Английский поддерживается частично.

Нужен ли интернет для работы?

Зависит от конфигурации:

  • С облачным LLM (OpenAI, GigaChat) - да, нужен интернет
  • С локальным LLM (Ollama) - нет, работает оффлайн

Работа с данными

Откуда Р13.Орбита берет данные?

Данные хранятся в ClickHouse - аналитической OLAP базе данных. Администратор настраивает подключение к вашим данным.

Можно ли подключить свои данные?

Да. Администратор создает конфигурацию домена в domains/*.yaml, описывающую структуру ваших таблиц.

Какие базы данных поддерживаются?

Для аналитических данных: ClickHouse. Для метаданных: PostgreSQL или SQLite.

Сколько данных можно запросить за раз?

По умолчанию максимум 1000 строк. Это настраивается в конфигурации.

Как запросить больше данных?

Используйте агрегацию вместо детализации или попросите администратора увеличить лимит в конфигурации.

Датасеты

Что такое датасет?

Датасет - это сохраненный результат запроса, который можно быстро открыть повторно без нового выполнения запроса.

Где хранятся датасеты?

В базе данных метаданных (PostgreSQL или SQLite).

Датасеты видны другим пользователям?

В локальном режиме - нет. В API режиме с аутентификацией - зависит от настроек.

Датасеты обновляются автоматически?

Нет. Датасет - это снимок данных на момент создания. Для свежих данных создайте новый датасет.

Сколько датасетов можно создать?

Ограничения нет, но рекомендуется удалять устаревшие датасеты.

Визуализация

Какие типы графиков поддерживаются?

Столбчатые, линейные, круговые диаграммы и точечные графики.

Где сохраняются графики?

В директории ~/orbita/charts/ в формате PNG (по умолчанию).

Можно ли экспортировать в другие форматы?

Да: PNG, PDF, SVG, JPEG. Укажите формат при создании графика.

Как настроить внешний вид графиков?

Графики используют профессиональные стили по умолчанию. Детальная настройка пока не поддерживается через интерфейс.

CLI

Как запустить CLI? 
docker run -it --rm \
  --network host \
  your-registry.company.com/orbita:latest \
  orbita-cli chat --mode api --api-url http://localhost:8000
Как выйти из CLI?

Команда /exit или Ctrl+D

Где хранится история команд?

В ~/.orbita/history

Можно ли использовать CLI без API?

Да, это называется local mode. CLI подключается напрямую к базам данных.

Производительность

Почему запрос выполняется медленно?

Возможные причины:

  • Большой объем данных без фильтров
  • Сложные агрегации
  • Медленный LLM провайдер
  • Проблемы с сетью

Решение: ограничьте временной период, используйте агрегацию, проверьте подключение.

Сколько времени занимает запрос?

Обычно 3-10 секунд. Зависит от сложности вопроса и объема данных.

Можно ли ускорить работу?

Да:

  • Используйте датасеты для повторных запросов
  • Указывайте конкретные временные периоды
  • Используйте агрегацию вместо детализации
  • Выберите более быстрый LLM (GPT-3.5 вместо GPT-4)

Безопасность

Безопасно ли использовать Р13.Орбита?

Да. Р13.Орбита имеет многоуровневую защиту от SQL injection и выполняет только SELECT запросы.

Может ли Р13.Орбита изменить или удалить данные?

Нет. По умолчанию разрешены только операции чтения (SELECT, WITH).

Видит ли LLM провайдер мои данные?

LLM получает только вопрос и схему таблиц. Реальные данные НЕ отправляются в LLM (кроме результатов для форматирования ответа).

Как защитить доступ к Р13.Орбита?

Используйте Keycloak для SSO аутентификации. Настройте в конфигурации.

Установка и настройка

Какие требования для установки?

Docker, ClickHouse, LLM API (OpenAI/Ollama/GigaChat).

Можно ли установить на Windows?

Да, но рекомендуется использовать WSL2 для лучшей совместимости.

Нужен ли GPU?

Нет, кроме случая использования локального Ollama для ускорения.

Сколько стоит использование?

Р13.Орбита бесплатна. Стоимость - только LLM API (если используете облачный). OpenAI GPT-4: ~$0.03 за запрос.

Проблемы

Р13.Орбита не понимает мой вопрос

Попробуйте:

  • Уточнить вопрос (добавить период, метрики)
  • Указать таблицы явно
  • Проверить доступные домены (/domains)
  • См. Как задавать вопросы
Ошибка: Table doesn't exist

Таблица не существует в БД. Проверьте:

  • Конфигурацию домена
  • Что таблица создана в ClickHouse
  • Правильность CLICKHOUSE_DATABASE в .env
Ошибка: ModuleNotFoundError

Виртуальное окружение не активировано или зависимости не установлены. См. Решение проблем.

API возвращает 502

API сервер не запущен или недоступен. Проверьте: 

docker ps | grep orbita
docker logs orbita

Где найти логи?
  • Docker контейнер: docker logs orbita
  • Файлы логов (если volume подключен): ~/orbita/logs/
  • Docker Compose: docker-compose logs orbita

Дополнительно

Есть ли Web UI?

Пока в разработке. Сейчас доступны CLI и API.

Можно ли интегрировать Р13.Орбита в свое приложение?

Да, через REST API или Python SDK (в разработке).

Поддерживаются ли другие LLM?

Да: OpenAI, Ollama, GigaChat, Nebius AI Studio, Azure OpenAI, Anthropic Claude и любые OpenAI-compatible API.

Где получить помощь?
  • Эта документация
  • Служба поддержки вашей организации
  • Администратор системы Р13.Орбита

Дополнительные ресурсы