Быстрый старт¶

Добро пожаловать в Р13.Орбита! Это руководство поможет вам сделать первые шаги и начать задавать вопросы вашим данным.

Запуск интерфейса¶

Вариант 1: Через командную строку¶

Откройте терминал и выполните:

python -m orbita_cli chat

Если установлен скрипт запуска, используйте:

./run_chat.sh

Вариант 2: Через API¶

Если у вас настроен API сервер:

python -m orbita_cli chat --mode api --api-url http://localhost:8000

Первое знакомство¶

После запуска вы увидите приветственное сообщение:

╔══════════════════════════════════════════════════╗
║         Р13.Орбита Interactive Chat v1.0             ║
║   Интеллектуальная работа с данными              ║
╚══════════════════════════════════════════════════╝

Готов к работе! Введите ваш вопрос или /help для справки.

>

Курсор мигает и ждет вашего вопроса. Давайте попробуем!

Ваш первый вопрос¶

Введите простой вопрос на русском языке:

> покажи топ-10 товаров по продажам

Нажмите Enter.

Р13.Орбита обработает ваш вопрос и выведет результат:

Анализирую ваш запрос...
Преобразую в SQL...
Выполняю запрос...

┌────────────────────────┬──────────────┐
│ Товар                  │ Продажи (₽)  │
├────────────────────────┼──────────────┤
│ Смартфон Galaxy S23    │ 15 234 500   │
│ Ноутбук MacBook Pro    │ 12 890 300   │
│ Наушники AirPods Pro   │ 8 456 200    │
│ ...                    │ ...          │
└────────────────────────┴──────────────┘

Найдено 10 товаров

Поздравляем! Вы задали свой первый вопрос 🎉

Основные команды¶

Р13.Орбита CLI предоставляет интерактивный REPL (Read-Eval-Print Loop) с набором команд.

Справочные команды¶

Управление чатами¶

Работа с датасетами¶

Системные команды¶

Горячие клавиши¶

Для удобной работы используйте горячие клавиши:

Примеры запросов¶

Попробуйте задать следующие вопросы:

Простые запросы¶

> покажи продажи за последний месяц
> сколько заказов было вчера
> средний чек по категориям

Аналитические запросы¶

> топ-10 клиентов по выручке
> сравни продажи этого и прошлого года
> покажи динамику среднего чека по неделям

С временными периодами¶

> продажи за январь 2024
> заказы с 1 по 15 марта
> выручка за последние 7 дней

Сохранение результатов¶

Если результат вам нужен для дальнейшей работы, сохраните его как датасет:

> покажи все заказы за январь и сохрани как январь_2024

Р13.Орбита выполнит запрос, покажет результат и сохранит данные под именем январь_2024.

Позже вы сможете:

Открыть датасет:

> открой датасет январь_2024

Посмотреть список всех датасетов:

> покажи список датасетов

или командой:

> /datasets

Создание графиков¶

Р13.Орбита может автоматически создавать визуализации:

> покажи продажи по месяцам за 2024 год и построй график

Система: 1. Выполнит запрос 2. Проанализирует данные 3. Выберет подходящий тип графика 4. Создаст визуализацию 5. Сохранит файл с графиком

Вы увидите сообщение:

График сохранен: ~/orbita/charts/sales_by_month_2024.png

Переключение между чатами¶

Р13.Орбита поддерживает множественные чаты для организации работы:

Создание нового чата¶

> /new анализ_логистики

Создаст чат с названием "анализ_логистики".

Просмотр списка чатов¶

> /list

Выведет:

Доступные чаты:
1. default (текущий)
2. анализ_продаж
3. анализ_логистики

Переключение¶

> /switch 2

Переключит на чат "анализ_продаж" со всей его историей.

Проверка доступных доменов¶

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

> /domains

Выведет список настроенных доменов:

Доступные домены:
- ecommerce (Электронная коммерция)
  Таблицы: orders, customers, products, order_items

- logistics (Логистика)
  Таблицы: deliveries, couriers, routes

- films (Кинотеатры)
  Таблицы: films, sessions, tickets, cinemas

Теперь вы знаете, какие данные можно запрашивать!

Пример рабочей сессии¶

Вот как может выглядеть типичная рабочая сессия:

> /new анализ_продаж_февраль

Создан новый чат: анализ_продаж_февраль

> покажи топ-10 товаров по продажам за февраль

[Результаты...]

> а теперь сравни с январем

[Сравнительная таблица...]

> построй график динамики продаж этих товаров

График сохранен: top10_products_trend.png

> сохрани эти данные как топ_февраль

Датасет сохранен: топ_февраль

> /datasets

Сохраненные датасеты:
1. топ_февраль (только что)
2. январь_2024 (5 дней назад)

> /exit

До свидания! 👋

Что делать, если что-то не работает?¶

Система не запускается¶

Убедитесь, что:

1. Вы находитесь в правильной директории
2. Все зависимости установлены
3. Система настроена администратором

Обратитесь к администратору или см. Решение проблем.

Запрос не выполняется¶

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

• Домен не найден - проверьте доступные домены командой /domains
• Таблица не существует - уточните название таблицы у администратора
• Ошибка в запросе - попробуйте переформулировать вопрос

Пример:

❌ Плохо: "покажи данные"
✅ Хорошо: "покажи топ-10 товаров по продажам"

Непонятный результат¶

Если результат не соответствует ожиданиям:

1. Уточните вопрос - добавьте больше деталей
2. Проверьте временные рамки
3. Убедитесь, что в базе есть нужные данные

Подробнее о формулировке вопросов см. Как задавать вопросы.

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

Теперь, когда вы освоили базовые возможности Р13.Орбита, рекомендуем:

1. Как задавать вопросы - научитесь формулировать точные запросы
2. Работа с датасетами - углубите знания о сохранении и переиспользовании данных
3. Создание визуализаций - создавайте профессиональные графики
4. Примеры использования - изучите готовые сценарии

Советы для эффективной работы¶

Удачи в работе с Р13.Орбита! 🚀