AIKraft/AI/Войти
AIKraft/Skills/VTEX IO: пути сервисов и CDN

VTEX IO: пути сервисов и CDN

Apply when defining service.json routes, choosing public vs segment vs private URL prefixes for VTEX IO services, or setting HTTP cache headers that interact with the VTEX edge and CDN. Covers path patterns, cookie visibility, edge caching behavior, and aligning Cache-Control with data sensitivity. Use for Node or .NET IO backends where request path and response headers determine CDN safety.

vtex official Данные

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

Навык применяется при определении маршрутов в service.json для бэкендов VTEX IO, чтобы обеспечить корректную передачу куки и кэширование на edge (CDN). Он охватывает выбор префиксов путей (public, segment, private), настройку заголовков Cache-Control и диагностику проблем с отсутствующими куки.

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

  • Выбор между префиксами public, segment (/_v/segment/...) и private (/_v/private/...) для маршрута в service.json
  • Настройка заголовков Cache-Control, чтобы поведение публичного кэша соответствовало области данных (анонимный, сегмент или аутентифицированный покупатель)
  • Объяснение причин, по которым маршрут не получает куки vtex_session или vtex_segment
  • Отладка поведения CloudFront или edge, когда куки отсутствуют

Как работает

  1. Определите, какой тип доступа требуется для данных маршрута (публичный, сегментный или приватный)
  2. Выберите соответствующий префикс пути: public, /_v/segment/... или /_v/private/...
  3. Настройте заголовки HTTP-ответов, такие как Cache-Control, чтобы они соответствовали уровню конфиденциальности данных
  4. Проверьте, передаются ли необходимые куки (vtex_session, vtex_segment) через edge
  5. При проблемах с отсутствующими куки используйте официальное руководство по устранению неполадок для CloudFront или edge

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

Как правильно настроить service.json для маршрута, который должен кэшироваться публично, но учитывать сегмент пользователя?
Почему мой маршрут не получает куки vtex_session, и как это исправить на уровне заголовков?
Как настроить Cache-Control для endpoint, обслуживающего данные аутентифицированного покупателя, чтобы избежать утечки в публичный кэш?

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

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

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

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