Как проверить доступные инструменты до первого разбора магазина

Коротко

• Сначала сформулируйте цель разбора и перечислите нужные для нее данные.
• Попросите подключенного ассистента перечислить доступные инструменты и описать, что каждый возвращает.
• Сделайте один тестовый запрос за короткий период и сверьте его с кабинетом маркетплейса.
• Составьте список пробелов: каких данных нет и откуда их взять вручную.
• Себестоимость и данные, которых нет в отчетах маркетплейса, придется добавить самостоятельно.
• Ассистент без подключения тоже подойдет, если вы работаете с выгрузками CSV.

Зачем проверять инструменты заранее

ИИ-ассистент сам по себе не видит ваш кабинет на Wildberries или Ozon. Он работает только с тем, что ему передали: с файлом, вставленной таблицей или данными через подключенные инструменты.

Набор инструментов зависит от того, какое решение подключено, к какому маркетплейсу, какие ключи доступа выданы и какой ассистент используется. Набор может меняться со временем. Поэтому полагаться на чужой список или статью не стоит. Проверять нужно у себя, в своем ассистенте.

Проверка решает три задачи:

1. Вы понимаете, на какие вопросы ассистент может ответить с опорой на данные.
2. Вы заранее видите пробелы и готовите ручные данные.
3. Вы получаете базу для сверки: знаете, откуда взялась каждая цифра в разборе.

Метод по шагам

Шаг 1. Сформулируйте цель первого разбора

Не начинайте с «проанализируй магазин». Выберите один вопрос, на который хотите получить ответ. Например:

• какие артикулы дают основную выручку за последние 30 дней;
• где остатки заканчиваются быстрее, чем через две недели;
• какие товары продаются, но после комиссий и логистики дают мало денег.

Одна цель — один разбор. Так проще проверить результат.

Шаг 2. Перечислите нужные данные

Под каждую цель выпишите, какие данные нужны. Учебный пример для вопроса про остатки:

• продажи по артикулам за 30 дней;
• текущие остатки по складам;
• товары в пути, если вы их учитываете;
• срок поставки от вас до склада маркетплейса.

Последний пункт обычно знаете только вы. Это нормально: часть данных всегда будет ручной.

Шаг 3. Попросите ассистента перечислить инструменты

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

Важно просить описание, а не догадки. Если ассистент не уверен, что именно возвращает инструмент, пусть так и скажет.

Шаг 4. Отметьте, что инструменты делают

Для каждого инструмента зафиксируйте:

• маркетплейс: Wildberries или Ozon;
• тип данных: продажи, заказы, остатки, отчеты и так далее;
• доступный период и детализацию;
• только ли он читает данные.

Первый разбор лучше проводить в режиме чтения. Если по ответу ассистента нельзя однозначно понять, что инструмент ничего не меняет, не используйте его в первом разборе. Все решения по магазину принимайте сами, после своей проверки.

Шаг 5. Сделайте тестовый запрос

Попросите ассистента получить небольшой фрагмент данных: например, продажи за последние 7 дней по 5 артикулам. Не нужен анализ, нужна сырая таблица.

Цель теста — убедиться, что инструмент отвечает, данные приходят в понятном виде, а цифры совпадают с кабинетом.

Шаг 6. Составьте карту пробелов

Сопоставьте список из шага 2 с тем, что реально доступно. Получится три группы:

• есть через инструменты — можно запрашивать в разборе;
• есть в кабинете, но не через инструменты — выгружаете вручную;
• нет нигде на маркетплейсе — себестоимость, сроки поставки, ваши планы закупок.

Учебный пример карты:

Это не реальные данные магазина, а форма, которую можно скопировать.

Шаг 7. Зафиксируйте план разбора

Запишите цель, источники, период и то, что добавите вручную. С этой запиской первый разбор пойдет быстрее, и вы сможете повторить его через месяц в тех же условиях.

Ручная альтернатива: CSV и отчеты

Если подключения пока нет или нужных инструментов не оказалось, разбор можно сделать на выгрузках.

Порядок такой:

1. Выгрузите из личного кабинета Wildberries или Ozon нужные отчеты: продажи, остатки, финансовый отчет за выбранный период.
2. Проверьте период в каждом файле. Отчеты из разных разделов могут охватывать разные даты.
3. Оставьте только нужные столбцы. Лишние колонки мешают и ассистенту, и вам.
4. Приведите идентификаторы к одному виду: артикул продавца или артикул маркетплейса, но одинаково во всех файлах.
5. Добавьте свою таблицу себестоимости с тем же идентификатором.
6. Загрузите файлы ассистенту или вставьте таблицу и опишите, что в каждом столбце.

Минусы ручного варианта понятны: данные устаревают в момент выгрузки, а сводить файлы приходится самому. Зато вы точно знаете, откуда каждая цифра.

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

Какие данные понадобятся

Минимальный набор для первого разбора:

• цель разбора одной фразой;
• период: даты начала и конца;
• маркетплейс и кабинет, если их несколько;
• список артикулов, если разбираете не весь ассортимент;
• себестоимость по артикулам, если вопрос касается денег;
• ваши ограничения: сроки поставки, минимальная партия, бюджет.

Себестоимость и ваши внутренние ограничения ни один коннектор к маркетплейсу не подставит. Их нет в отчетах Wildberries и Ozon. Если не добавить их, ассистент не сможет корректно считать маржу и должен прямо об этом сказать.

Готовый промт для проверки инструментов

Скопируйте промт в подключенного ассистента. Квадратные скобки замените своими данными.

Я готовлюсь к первому разбору магазина. Сейчас анализ не нужен — нужна проверка доступных инструментов.

Цель будущего разбора: [например, найти артикулы, у которых остатки закончатся раньше чем через 14 дней].
Маркетплейс: [Wildberries / Ozon / оба].
Период: [например, последние 30 дней].

Сделай по шагам:

1. Перечисли все инструменты, которые тебе сейчас доступны для работы с данными маркетплейсов. Для каждого укажи: название, маркетплейс, какие данные возвращает, есть ли ограничения по периоду или детализации, только ли он читает данные.
2. Если про какой-то инструмент ты не уверен, так и напиши. Не додумывай возможности.
3. Сопоставь инструменты с моей целью: какие данные для нее можно получить, а каких не хватает.
4. Сделай один тестовый запрос: [например, продажи за последние 7 дней по 5 любым артикулам]. Покажи результат таблицей без анализа и выводов.
5. Отдельным списком перечисли, какие данные мне нужно добавить вручную (например, себестоимость, сроки поставки).

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

Если ассистент не видит ни одного инструмента для маркетплейсов, значит подключение не настроено или не работает в этом ассистенте. Для этого и нужно актуальное подключение.

Где здесь Артель

Артель — решение для подключения ИИ-ассистента к поддерживаемым данным и инструментам Wildberries и Ozon. Оно нужно в тот момент, когда для разбора требуются актуальные данные из кабинета, а не выгрузка недельной давности.

Какие именно инструменты появятся у вас, зависит от настройки и ассистента. Поэтому список проверяйте тем же промтом в своем подключенном ассистенте, а не по описаниям. Шаги настройки и совместимость меняются, поэтому сверяйте их в актуальной инструкции подключения.

Важно понимать границы. Через Артель ассистент получает доступ к поддерживаемым данным, но себестоимость, которой нет в маркетплейсе, не появится. Неполноту отчетов коннектор тоже не устраняет: если в отчете маркетплейса нет нужной детализации, ее не будет и в ответе.

Примеры сценариев разбора можно дополнительно посмотреть в разделе рабочих сценариев.

Как сверить результат

Тестовый запрос из промта — это первая проверка. Сверьте его так:

1. Откройте тот же период в кабинете. Возьмите 2–3 артикула из таблицы ассистента и сравните цифры.
2. Проверьте даты. Убедитесь, что период в ответе совпадает с запрошенным. Частая ошибка — сдвиг на день из-за часового пояса или границы отчета.
3. Проверьте идентификаторы. Артикул продавца и артикул маркетплейса — разные вещи. Убедитесь, что ассистент не смешал их.
4. Проверьте пустые значения. Пустая ячейка и ноль означают разное. Ассистент должен явно показывать отсутствие данных.
5. Сверьте с выгрузкой. Если есть CSV за тот же период, сравните итоговые суммы.

Если расхождение есть, попросите ассистента показать, какой инструмент и с какими параметрами он вызвал. Часто причина в периоде или фильтре.

Результат проверки запишите: какие инструменты прошли сверку, какие нет. Это и есть ваш первый проверяемый результат.

Ограничения

• Набор инструментов не универсален. Он зависит от подключения, ассистента и выданных доступов. Проверяйте у себя.
• Данные маркетплейса неполные по определению. Себестоимости, ваших закупочных планов и сроков поставки в них нет.
• Отчеты могут обновляться с задержкой. Свежие дни иногда меняются задним числом. Для сверки берите период, который уже закрыт.
• Ассистент может ошибаться. Даже при доступе к данным он может неверно сгруппировать или посчитать. Поэтому ключевые цифры сверяйте вручную.
• Решения остаются за вами. Разбор — это подготовка к решению, а не само решение.

Частые вопросы

Почему нельзя просто спросить ассистента о магазине без проверки?

Можно, но тогда вы не знаете, на чем основан ответ. Ассистент может работать с неполными данными или рассуждать в общих словах. Проверка инструментов показывает, какие ответы опираются на данные, а какие нет. Это занимает 15–20 минут и экономит время на перепроверке выводов.

Что делать, если ассистент не видит инструментов для маркетплейсов?

Скорее всего, подключение не настроено или не поддерживается в этом ассистенте. Сверьте настройку и совместимость по актуальной инструкции подключения. Пока подключения нет, используйте ручной вариант: выгрузите отчеты в CSV и передайте их ассистенту вместе с описанием столбцов.

Нужно ли проверять инструменты перед каждым разбором?

Полную проверку достаточно сделать перед первым разбором и после изменений в подключении. Перед следующими разборами хватит короткого тестового запроса за несколько дней и сверки 2–3 цифр с кабинетом. Если ассистент начал отвечать иначе или пропал инструмент, повторите полную проверку.

Можно ли получить маржу без своей таблицы себестоимости?

Нет. Себестоимость — ваши внутренние данные, в отчетах маркетплейса ее нет, и коннектор ее не добавит. Без нее ассистент может посчитать выручку после комиссий и логистики, если такие данные доступны, но не маржу. Подготовьте таблицу себестоимости с теми же артикулами, что используются в отчетах.

Как понять, что результат тестового запроса правильный?

Сравните 2–3 артикула с кабинетом за тот же период, проверьте даты и тип артикула. Если есть выгрузка CSV, сверьте итоговые суммы. При расхождении попросите ассистента показать, какой инструмент и с какими параметрами он вызвал. Часто причина в разных периодах или фильтрах.

Вывод

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

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