Руководство · Экспериментальная практика
Universal Commerce Protocol: профиль магазина для агентов
Как UCP публикует возможности магазина через well-known-профиль, почему важны версия и согласование возможностей и где проходит граница между публичным описанием и транзакцией.
- Опубликовано
- Обновлено
Ограничение: материал объясняет проверяемый технический сигнал. Его наличие не гарантирует ранжирование, индексацию, цитирование или включение сайта в ответы ИИ.
Что публикует UCP
Universal Commerce Protocol описывает взаимодействие платформ и бизнеса через версионируемый профиль возможностей. Публичная точка discovery бизнеса располагается по `/.well-known/ucp` и сообщает protocol version и поддерживаемые capabilities.
Текущая спецификация отдельно определяет совместимость версии протокола и согласование возможностей. Поэтому недостаточно просто вернуть JSON по well-known URL: профиль должен быть внутренне согласован и описывать реальные возможности сервера.
Что проверяет AI Web Check
UCP проверяется только для сайта, определённого как интернет-магазин, и только как публичный well-known-документ. AI Web Check проверяет структуру опубликованного профиля и поля, зависящие от версии протокола, но не оформляет заказ, не выполняет оплату и не запускает другие операции магазина.
Отсутствие UCP остаётся необязательным сигналом. Сервис не считает обычный интернет-магазин «не готовым для ИИ» только потому, что он не поддерживает новый протокол для ИИ-агентов.
Публичное описание не даёт разрешения на покупку
Well-known-профиль сообщает, какие возможности доступны и как с ними согласовывать работу. Он не должен содержать секреты и не даёт любому автоматизированному клиенту право выполнять транзакционные действия.
Рабочий API должен отдельно проверять аутентификацию, авторизацию, допустимую область доступа и состояние операции. Для оформления заказа и оплаты особенно важно не путать публичную метаинформацию с полномочием действовать от имени пользователя.
Типичные ошибки
- Профиль объявляет возможность, которую рабочий API фактически не поддерживает.
- Версия документа и зависящие от неё поля смешаны из разных ревизий спецификации.
- В well-known JSON публикуются API-ключи, bearer-токены или приватный адрес API.
- Публичный well-known-адрес перенаправляет на другой сайт или небезопасный HTTP URL.
Практический порядок внедрения
Сначала реализуйте и протестируйте серверную возможность с обычной авторизацией и журналом действий. Затем добавьте публичный профиль UCP, который точно описывает поддерживаемую версию и только реально доступные возможности.
После публикации проверяйте well-known-документ отдельно от операций. Именно так AI Web Check рассматривает UCP: публичное описание можно безопасно проверять, не совершая покупок и не меняя состояние магазина.