X·MPДокументация

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

Прикладные методики: от вопроса к проверяемому решению

Шесть сценариев помогают агенту провести анализ рекламы, подготовить закупку и распределение, проверить ФБС, разобраться в правилах и удержаниях.

Зачем это нужно

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

Пример из работы магазина

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

Как начать

  1. Установите или обновите клиент и проверьте ./.xmp/doctor.
  2. Назовите задачу, период и существенные ограничения; сохранённые условия агент явно прочитает из Memory.
  3. Получите анализ и подготовленный план с проверкой полноты данных.
  4. Согласуйте конкретные изменения и отдельно оцените результат после исполнения.

Что вы получите

Таблица решений, план пополнения/распределения, очередь ФБС либо доказательный разбор документа; у каждого результата — источники и критерий проверки.

Что важно учитывать

Навык не заменяет недостающие данные и не включает исполнение операций. Правовые выводы зависят от применимой редакции. Доступность методики не доказывает полноту данных конкретного магазина.

Какой сценарий выбрать

МетодикаНеобходимые входыЧто получитеПример запроса
Аудит рекламыРасходы, показы, клики, заказы, воронка, маржа и наличие; детализация и атрибуция проверяются.Проблемы и гипотезы по доступному уровню, приоритет действий и план измерения.Разбери рекламу за последние две полные недели: где потери, что проверить и что предложить изменить.
ПополнениеСпрос, свободный запас, резерв, поступления/ETA, сроки, кратность и бюджет.Потребность до округления, партия, дата заказа, стоимость и риск дефицита.Подготовь план пополнения выбранных товаров на четыре недели в пределах моего бюджета.
Распределение по складамПартия по SKU/размеру, региональный спрос, складские остатки, тарифы и приёмка.Таблица SKU × склад × количество, сравнение затрат/покрытия, нераспределённый остаток.Распредели имеющуюся партию по допустимым складам и объясни компромисс стоимости и покрытия.
Контроль ФБСЗадания, варианты товара, статусы, сроки/часовой пояс, свободный запас и полнота очереди.Приоритет сборки, просрочки, нехватка и конфликтующие статусы; план ручных действий.Проверь текущую очередь ФБС и подготовь список действий на сегодня без изменения заданий.
Оферта и правилаКонкретный вопрос, страна, сторона договора, модель продаж, дата события и официальный текст.Пункты и редакции, применимость, выводы, источники и вопросы для правовой проверки.Проверь, какие правила применимы к этому событию, и укажи основание и нужные документы.
УдержанияНачисления и корректировки, идентификаторы документов, денежная база, основание и редакция правил.Сверка суммы, доказательства, неясности и подготовленный проект обращения.Разбери это удержание: сверь сумму и основание, подготовь обращение, не отправляй.

Как работает прикладной навык

  1. Агент выбирает ведущую методику по вашему вопросу и явно читает нужный контекст магазина из Memory.
  2. Проверяет доступ, свежесть, период, детализацию и полноту источников через X-MP.
  3. Выполняет анализ или расчёт вариантов с исходными данными, единицами и допущениями.
  4. Готовит решение, таблицу или проект документа; показывает, что пока нельзя подтвердить.
  5. Для изменений переходит к соответствующему сервису и его порядку подтверждения. После реального действия проверяет результат.

Прикладной навык задаёт методику. Сервисный навык объясняет инструменты. MCP и сервер проверяют права. Формулы фактических KPI принадлежат реестру метрик, цели и ограничения — памяти магазина. Установка инструкций не выдаёт новые права.

Когда данных недостаточно

СитуацияЧто сделает агент
Есть только итог по товаруСделает анализ товара, но не выдумает конкретную кампанию или размер.
Нет сроков пополнения или стоимостиПодготовит условный план и укажет параметры, без которых нельзя выбрать окончательную закупку.
Нет регионального спроса или складских тарифовПокажет доступные варианты без заявления об оптимальном распределении.
Очередь ФБС неполная или стараяУкажет границы снимка; отсутствие задания не назовёт подтверждением отгрузки.
Оферта недоступна или редакция не установленаПопросит нужный документ либо выполнит условный разбор предоставленного текста.
В финансовых данных нет причины удержанияСверит доступные суммы и подготовит запрос детализации; не угадает основание.

Подключение и вызов

Навыки входят в клиентский пакет 0.34.0: всего 26 навыков и 112 MCP-инструментов. При новой установке используйте команду из кабинета. В существующей папке запустите ./.xmp/start при включённом обновлении либо попросите агента явно обновить клиент. ./.xmp/doctor проверяет пакет и подключения. Затем сформулируйте задачу обычным языком.

Явное чтение инструкции через MCP
{"name":"xmp.client.instructions","arguments":{"skills":["xmp-advertising-audit"]}}

Для оферты нужен web-инструмент выбранного AI-клиента или предоставленный официальный документ. Отдельный web-коннектор X-MP в этом выпуске не добавляется. Не передавайте пароли, cookies и ключ WB в чат.

Проверка результата

Каждый результат содержит дату, область анализа, факты и источники, ограничения, предложенное действие и способ его проверки. Отправленное обращение не равно возврату денег, созданный план не равен поставке, изменение настроек не доказывает рост прибыли. Для замера после действия используется общий навык xmp-outcome-review.

ФБС и поставки в этих методиках работают в режиме чтения и планирования. Промышленный оптимизатор распределения, бронирование слотов и новые marketplace write-методы этим выпуском не поставляются.

Методы и параметры

Параметры ниже относятся к MCP arguments. Идентичность и ключ не передаются в них. Для полного объекта config следуйте руководству домена.

xmp.client.instructions

Прочитать индекс инструкций или1–3 skill; бизнес-правила не меняются.

ПараметрТипОбязателенНазначение и ограничения
skillsмассивнетИмена выбранных инструкций из текущего индекса. не менее элементов: 1; не более элементов: 3
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "skills": {
      "type": "array",
      "minItems": 1,
      "maxItems": 3,
      "uniqueItems": true,
      "items": {
        "type": "string"
      }
    }
  }
}

xmp.client.doctor

Check client integrity, account identity, granted access and configured service states. Read-only; never enables grants, schedules or marketplace operations. Returns bounded diagnostics, not business data.

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

analysis.query

Рассчитать агрегаты и коэффициенты по магазину, товарам и дням с признаками качества.

ПараметрТипОбязателенНазначение и ограничения
date_fromстрокадаДата начала; смысл события или наблюдения зависит от метода. формат: "date"
date_toстрокадаВключённая дата окончания; проверяйте допустимую длину периода. формат: "date"
group_byстроканетГруппировка данных; проверяйте разрешённые варианты. по умолчанию: "product"; варианты: ["account", "day", "product", "day_product"]
metricsмассивнетСписок выбранных показателей; разные сервисы имеют собственный каталог. не менее элементов: 1; не более элементов: 12; по умолчанию: ["ordered_gmv", "sales_gmv", "ad_spend", "cancelled_units"]
nm_idsмассивнетСписок артикулов WB в пределах выбранного магазина. не более элементов: 20
sort_byстроканетВыбранный показатель для сортировки; должен присутствовать в запросе. по умолчанию: "ordered_gmv"; шаблон: "^[a-z][a-z0-9_]{1,63}$"
sort_directionстроканетНаправление сортировки. по умолчанию: "desc"; варианты: ["asc", "desc"]
offsetцелоенетСмещение следующей страницы либо байтов медиа; используйте значение ответа. минимум: 0; максимум: 10000; по умолчанию: 0
limitцелоенетЧисло строк/событий за страницу, а не полнота всего источника. минимум: 1; максимум: 50; по умолчанию: 20
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "date_from",
    "date_to"
  ],
  "properties": {
    "date_from": {
      "type": "string",
      "format": "date"
    },
    "date_to": {
      "type": "string",
      "format": "date"
    },
    "group_by": {
      "type": "string",
      "enum": [
        "account",
        "day",
        "product",
        "day_product"
      ],
      "default": "product"
    },
    "metrics": {
      "type": "array",
      "minItems": 1,
      "maxItems": 12,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "ordered_units",
          "ordered_gmv",
          "cancelled_units",
          "sales_gmv",
          "ad_spend",
          "ad_clicks",
          "ad_orders",
          "wb_for_pay",
          "contribution_profit",
          "stock_units",
          "opens",
          "carts",
          "ad_impressions",
          "funnel_orders",
          "average_ordered_unit_price",
          "cpm",
          "ad_spend_to_ordered_gmv",
          "ad_spend_per_ordered_unit",
          "operational_contribution_margin",
          "average_order_value",
          "cancelled_order_share",
          "ad_ctr",
          "cpc",
          "cpo",
          "cart_cr",
          "order_cr",
          "cart_to_order_cr"
        ]
      },
      "default": [
        "ordered_gmv",
        "sales_gmv",
        "ad_spend",
        "cancelled_units"
      ]
    },
    "nm_ids": {
      "type": "array",
      "maxItems": 20,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^[0-9]{1,20}$"
      }
    },
    "sort_by": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_]{1,63}$",
      "default": "ordered_gmv"
    },
    "sort_direction": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "default": "desc"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000,
      "default": 0
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}

metrics.catalog

Прочитать определения KPI: формулы, входы, единицы, детализацию и зрелость.

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

finance.summary

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

ПараметрТипОбязателенНазначение и ограничения
date_fromстрокадаДата начала; смысл события или наблюдения зависит от метода. формат: "date"
date_toстрокадаВключённая дата окончания; проверяйте допустимую длину периода. формат: "date"
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "date_from",
    "date_to"
  ],
  "properties": {
    "date_from": {
      "type": "string",
      "format": "date"
    },
    "date_to": {
      "type": "string",
      "format": "date"
    }
  }
}

Связанные возможности

Аналитика магазина

Разбираться в расходах, продажах и причинах изменений

Доступно. Прибыль рассчитывается только при достаточных данных о себестоимости и расходах.

Техническая справка для агента и разработчика

Этот раздел предназначен для настройки интеграции. Для обычной работы начните с шагов выше.