Как задавать вопросы¶

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

Основные принципы¶

1. Будьте конкретны¶

❌ Плохо:

покажи данные

✅ Хорошо:

покажи топ-10 товаров по продажам за последний месяц

Чем точнее вопрос, тем точнее результат.

2. Указывайте период времени¶

❌ Плохо:

сколько заказов

✅ Хорошо:

сколько заказов было за январь 2024

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

3. Уточняйте метрики и группировки¶

❌ Плохо:

покажи продажи

✅ Хорошо:

покажи сумму продаж по категориям за последний квартал

Явно указывайте, что именно вы хотите видеть: сумму, количество, среднее значение.

4. Используйте термины из предметной области¶

❌ Плохо:

покажи самые покупаемые штуки

✅ Хорошо:

покажи топ-10 товаров по количеству заказов

Используйте правильные термины: товары, заказы, клиенты, категории.

Типы вопросов¶

1. Простые запросы (Выборка данных)¶

Самый базовый тип - получение списка записей.

Шаблон:

покажи [объект] [условие]

Примеры:

покажи все заказы за вчера
покажи клиентов из Москвы
покажи товары категории Электроника
покажи заказы со статусом Доставлен

Совет

Если не указать условие, система вернет все записи (с лимитом 1000 строк по умолчанию).

2. Агрегация данных (COUNT, SUM, AVG)¶

Вопросы для получения статистики.

Шаблоны:

сколько [объектов] [условие]           → COUNT
какая сумма [метрика] [условие]         → SUM
какой средний [метрика] [условие]       → AVG

Примеры:

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

3. Топ-N запросы (Рейтинги)¶

Получение лучших или худших значений.

Шаблон:

топ-[N] [объектов] по [метрике] [период]

Примеры:

топ-10 товаров по продажам
топ-5 категорий по выручке за месяц
топ-20 клиентов по количеству заказов
топ-3 города по числу покупателей

Обратный порядок

Для получения худших результатов добавьте "с конца" или "наименьших":

топ-10 товаров с наименьшими продажами

4. Группировка (GROUP BY)¶

Разбивка данных по категориям.

Шаблон:

покажи [метрику] по [группировке] [период]

Примеры:

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

5. Фильтрация (WHERE)¶

Отбор данных по условиям.

Шаблон:

покажи [объект] где [условие]

Примеры:

покажи заказы где сумма больше 5000 рублей
покажи товары где остаток меньше 10 штук
покажи клиентов где город Москва и регистрация после 2023 года
покажи отзывы где рейтинг меньше 3

Условия:

Сравнение: больше, меньше, равно, не равно
Диапазон: от ... до ..., между ... и ...
Вхождение: в списке, один из
Логика: и, или, не

6. Сортировка (ORDER BY)¶

Упорядочивание результатов.

Шаблон:

покажи [объект] отсортированные по [поле] [порядок]

Примеры:

покажи товары отсортированные по цене по убыванию
покажи заказы отсортированные по дате
покажи клиентов отсортированные по имени по алфавиту

7. Сравнение периодов¶

Сравнение данных за разные периоды.

Шаблон:

сравни [метрику] [период 1] и [период 2]

Примеры:

сравни продажи этого и прошлого месяца
сравни количество заказов в январе и феврале
сравни выручку 2023 и 2024 годов по месяцам
сравни средний чек этой и прошлой недели

8. Динамика (Изменение во времени)¶

Анализ трендов и изменений.

Шаблон:

покажи динамику [метрики] по [период] за [диапазон]

Примеры:

покажи динамику продаж по месяцам за 2024 год
покажи динамику среднего чека по неделям
покажи динамику количества заказов по дням за последний месяц
покажи рост числа клиентов по кварталам

Работа с временными периодами¶

Р13.Орбита понимает различные способы указания времени.

Абсолютные даты¶

за январь 2024
за 15 марта 2024
с 1 по 31 декабря 2023
в феврале
в 2024 году

Относительные периоды¶

за вчера
за сегодня
за последний месяц
за последние 7 дней
за последнюю неделю
за последний квартал
за этот год
за прошлый год

Агрегация по времени¶

по дням
по неделям
по месяцам
по кварталам
по годам

Примеры:

покажи продажи по месяцам за 2024 год
покажи заказы по дням за последнюю неделю
покажи выручку по кварталам за последние 2 года

Примеры хороших и плохих вопросов¶

Пример 1: Анализ продаж¶

Плохо ❌	Хорошо ✅
покажи продажи	покажи общую сумму продаж за последний месяц
какие товары продаются	топ-20 товаров по количеству продаж за квартал
данные по категориям	покажи выручку по категориям товаров за 2024 год

Пример 2: Анализ клиентов¶

Плохо ❌	Хорошо ✅
покажи клиентов	покажи клиентов зарегистрировавшихся за последний месяц
кто покупает	топ-10 клиентов по сумме заказов за год
где покупатели	покажи количество клиентов по городам

Пример 3: Анализ заказов¶

Плохо ❌	Хорошо ✅
сколько заказов	сколько заказов было за февраль 2024
статус заказов	покажи количество заказов по статусам за последнюю неделю
проблемные заказы	покажи заказы со статусом Отменен за последний месяц

Сложные запросы¶

Множественные условия¶

Комбинируйте условия для точных запросов:

покажи заказы где сумма больше 10000 рублей и статус Доставлен за январь
покажи товары категории Электроника где остаток меньше 5 и цена больше 50000
покажи клиентов из Москвы или Санкт-Петербурга зарегистрировавшихся после 2023 года

Вложенная логика¶

покажи товары где категория Электроника или (категория Одежда и бренд Nike)
покажи заказы где (статус Новый или статус В обработке) и дата после 1 марта

Расчетные метрики¶

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

Частые ошибки¶

Ошибка 1: Неоднозначность¶

❌ Проблема:

покажи данные за месяц

Какой месяц? Текущий, прошлый, конкретный?

✅ Решение:

покажи продажи за февраль 2024
покажи продажи за прошлый месяц

Ошибка 2: Слишком общие термины¶

❌ Проблема:

покажи информацию о товарах

Какую именно информацию?

✅ Решение:

покажи название, цену и остаток для товаров категории Электроника

Ошибка 3: Отсутствие метрики¶

❌ Проблема:

покажи продажи по месяцам

Что именно показать? Сумму? Количество?

✅ Решение:

покажи сумму продаж по месяцам за 2024 год
покажи количество заказов по месяцам

Ошибка 4: Неверные названия полей¶

❌ Проблема:

покажи заказы где amount > 5000

Используется техническое название поля вместо естественного языка.

✅ Решение:

покажи заказы где сумма больше 5000 рублей

Советы по улучшению запросов¶

1. Начните с простого¶

Если не уверены в формулировке, начните с простого вопроса и уточняйте:

> покажи товары
> покажи товары категории Электроника
> покажи товары категории Электроника где цена больше 10000
> топ-10 товаров категории Электроника по продажам за месяц

2. Используйте примеры¶

Посмотрите на результат и уточните:

> покажи заказы за вчера
[Видите результат - 150 заказов]

> покажи заказы за вчера со статусом Доставлен
[Уточненный результат - 120 заказов]

3. Сохраняйте полезные запросы¶

Если формулировка дала хороший результат, сохраните датасет:

> покажи топ-20 товаров по продажам за февраль и сохрани как топ_февраль

Потом можно использовать:

> открой датасет топ_февраль

4. Экспериментируйте с формулировками¶

Попробуйте разные варианты:

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

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

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

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

> /domains

Вы увидите список таблиц и их описания:

Домен: ecommerce
- customers (покупатели)
- products (товары)
- orders (заказы)
- order_items (позиции заказов)
- reviews (отзывы)

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

Шпаргалка по формулировкам¶

Количество¶

сколько [объектов]
количество [объектов]
число [объектов]

Сумма¶

общая сумма [метрики]
суммарная [метрика]
итого по [метрике]

Среднее¶

средний [метрика]
среднее [метрика]
в среднем [метрика]

Топ/Рейтинг¶

топ-N [объектов]
лучшие N [объектов]
самые [характеристика] N [объектов]

Фильтры¶

где [условие]
с [условием]
у которых [условие]
для которых [условие]

Сортировка¶

отсортированные по [поле]
по [поле] по возрастанию
по [поле] по убыванию
от большего к меньшему

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

Теперь, когда вы знаете, как формулировать вопросы:

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

Практикуйтесь, и вы быстро освоите искусство задавать правильные вопросы! 🎯