AIKraft/AI/Войти
AIKraft/Skills/VTEX IO: Master Data

VTEX IO: Master Data

Apply when working with MasterData v2 entities, schemas, or MasterDataClient in VTEX IO apps, or when anyone designing or implementing a solution must scrutinize whether Master Data is the correct storage. The skill prompts hard questions: native Catalog or other VTEX stores, OMS, or an external database may be better; do not default to MD because it is convenient. Covers JSON Schema, CRUD, trigge

vtex official Дизайн

Что делает навык

Навык предназначен для работы с сущностями MasterData v2, схемами и MasterDataClient в приложениях VTEX IO, а также для обоснования выбора Master Data как хранилища. Он охватывает создание JSON Schemas, операции CRUD, настройку поиска и триггеров, а также помогает избежать ошибок при выборе источника данных.

Когда применять

  • Хранение пользовательских данных, таких как отзывы, списки желаний, формы обратной связи или конфигурационные записи.
  • Настройка автоматизированных рабочих процессов с помощью триггеров Master Data.
  • Принятие решения о размещении данных в Catalog, Master Data, OMS или внешней базе данных.
  • Управление жизненным циклом схем для предотвращения превышения лимита в 60 схем.

Как работает

  1. Определить сущности данных и создать JSON Schemas с использованием masterdata builder.
  2. Выполнить операции CRUD через MasterDataClient (ctx.clients.masterdata).
  3. Настроить поиск, скроллинг и индексацию для эффективного извлечения данных.
  4. Настроить триггеры Master Data для запуска автоматизированных рабочих процессов.
  5. Проверить необходимость использования Master Data, избегая синхронных запросов на критическом пути покупки (корзина, оформление, оплата, размещение заказа).
  6. Предпочитать единый источник истины, избегая дублирования заголовков заказов или списков OMS в Master Data.

Примеры запросов агенту

Как настроить MasterData v2 для хранения отзывов о товарах?
Когда лучше использовать Catalog, а когда Master Data для хранения спецификаций SKU?
Как избежать превышения лимита в 60 схем при работе с Master Data?

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «vtex-io-masterdata» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r vtex-io-masterdata/ ~/.claude/skills/vtex-io-masterdata/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.