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

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

Возвращайтесь к выводам и получайте уведомления

Отчёт сохраняет ответ на ваш вопрос вместе с цифрами и выводами. Уведомление помогает узнать, что результат готов.

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

Отчёт удобно открыть позже, обсудить с командой и сравнить с новым периодом. Настроенные регулярные сценарии уменьшают повторную ручную работу, а Telegram служит каналом доставки коротких сообщений.

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

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

Как начать

  1. Задайте агенту цель отчёта, период и нужные товары.
  2. Откройте сохранённый результат в кабинете и проверьте источники и недостающие данные.
  3. Для повторения выберите доступный сценарий и настройте его расписание.
  4. Для сообщений в Telegram привяжите его в настройках и проверьте, что нужный сценарий поддерживает уведомления.

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

Сохранённый отчёт, к которому можно вернуться, и уведомления о результатах поддержанных сценариев после настройки.

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

Не все сервисы отправляют уведомления. Привязка Telegram сама по себе не включает ежедневный анализ. Полные материалы открываются в приватном кабинете; полный ежедневный аудит всех сторон магазина ещё готовится.

Центр отчётов через MCP

reports.create создаёт выключенное определение отчёта daily-review/1 в Memory. Выберите sales, advertising, stock, change, время и дни недели. reports.run запускает один выпуск; reports.status показывает job; reports.result читает проверенный результат по artifact_id. reports.schedule отдельно включает или выключает повторение. Это ограниченный обзор ежедневного помощника, а не полный финансовый аудит. Статус partial и пробелы данных остаются видимыми.

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

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

reports.list

List up to ten Memory-backed report definitions and their schedule state for this account.

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

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

reports.create

Create an idempotent Memory-backed daily-review/1 report definition, initially paused. Sections sales/advertising/stock/change; not a complete financial audit.

ПараметрТипОбязателенНазначение и ограничения
titleстрокадаСостав и семантика описаны в руководстве домена. не менее символов: 3; не более символов: 120
request_idстрокадаСостав и семантика описаны в руководстве домена. формат: "uuid"
templateстроканетСостав и семантика описаны в руководстве домена. варианты: ["daily-review/1"]
sectionsмассивнетСостав и семантика описаны в руководстве домена. не менее элементов: 1; не более элементов: 4
timezoneстроканетСостав и семантика описаны в руководстве домена. не менее символов: 1; не более символов: 100
local_timeстроканетСостав и семантика описаны в руководстве домена. шаблон: "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
weekdaysмассивнетСостав и семантика описаны в руководстве домена. не менее элементов: 1; не более элементов: 7
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "title",
    "request_id"
  ],
  "properties": {
    "title": {
      "type": "string",
      "minLength": 3,
      "maxLength": 120
    },
    "request_id": {
      "type": "string",
      "format": "uuid"
    },
    "template": {
      "type": "string",
      "enum": [
        "daily-review/1"
      ]
    },
    "sections": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "sales",
          "advertising",
          "stock",
          "change"
        ]
      }
    },
    "timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "local_time": {
      "type": "string",
      "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
    },
    "weekdays": {
      "type": "array",
      "minItems": 1,
      "maxItems": 7,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 6
      }
    }
  }
}

reports.run

Queue one requested report generation using a stable request_id. Does not enable recurrence or execute marketplace changes.

ПараметрТипОбязателенНазначение и ограничения
card_idстрокадаЗадача Seller Memory; возьмите реальный UUID. формат: "uuid"
request_idстрокадаСостав и семантика описаны в руководстве домена. формат: "uuid"
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "card_id",
    "request_id"
  ],
  "properties": {
    "card_id": {
      "type": "string",
      "format": "uuid"
    },
    "request_id": {
      "type": "string",
      "format": "uuid"
    }
  }
}

reports.schedule

Explicitly enable or disable the saved report schedule. Requires confirm=true and account tasks.write; changes recurrence, not marketplace data.

ПараметрТипОбязателенНазначение и ограничения
card_idстрокадаЗадача Seller Memory; возьмите реальный UUID. формат: "uuid"
enabledда/нетдаСостав и семантика описаны в руководстве домена.
confirmда/нетдаЯвное подтверждение обновления клиента; не разрешение на WB write. только: true
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "card_id",
    "enabled",
    "confirm"
  ],
  "properties": {
    "card_id": {
      "type": "string",
      "format": "uuid"
    },
    "enabled": {
      "type": "boolean"
    },
    "confirm": {
      "type": "boolean",
      "const": true
    }
  }
}

reports.status

Read the bound report job state; completion and delivery are separate.

ПараметрТипОбязателенНазначение и ограничения
job_idстрокадаИдентификатор задачи очереди из jobs.create/list. формат: "uuid"
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "format": "uuid"
    }
  }
}

reports.result

Read verified bounded report JSON from a scoped artifact; server verifies archive checksums, account, workspace and tenant.

ПараметрТипОбязателенНазначение и ограничения
artifact_idстрокадаИдентификатор файла из каталога артефактов. формат: "uuid"
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "artifact_id"
  ],
  "properties": {
    "artifact_id": {
      "type": "string",
      "format": "uuid"
    }
  }
}

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

Отчёты и файлы

Получать результат работы и возвращаться к нему

Доступно. Отчёты видны вам и участникам команды, которым вы дали доступ к магазину.

Уведомления в Telegram

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

После настройки уведомлений. Сначала привяжите Telegram в настройках. Пока уведомления отправляют не все сервисы; список событий постепенно расширяется.

Ежедневные отчёты и уведомления

Начинать день с картины магазина и приоритетов. Выбирать нужные отчёты и расписание, сокращать ручные проверки.

По настроенным сценариям. Выберите доступный сценарий и настройте расписание. Для уведомлений привяжите Telegram. Полный ежедневный разбор всех сторон магазина ещё готовится; сейчас глубина отчёта зависит от собранных данных и выбранной задачи.

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

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