Claude Commerce Agents yordamida xarid qilish va sotuvchi agentlarini yaratish va ishga tushirish

Claude Commerce Agents taqdim etadigan imkoniyatlar

Claude Commerce Agents — Claude asosida yaratilgan, savdoga yo‘naltirilgan ikkita AI agentining namunaviy amalga oshirilishidir. Biznes mijozlarga mo‘ljallangan ilovaga xarid agentini joylashtirishi mumkin, xodimlar esa ofis ichidagi ish jarayonlarini boshqarish uchun sotuvchi agentidan foydalanishi mumkin.

Har bir agent o‘z prompti, ko‘nikmalari, vosita shartnomalari va xavfsizlik bosqichlari orqali bir marta belgilanadi. Bir xil ta’riflar Messages API, Claude Agent SDK yoki Managed Agents orqali ishlashi mumkin. Ishlaydigan to‘rtta vertikal misol chakana savdo, sayohat, telekommunikatsiya va ko‘ngilochar sohalarda arxitekturani namoyish etadi.

Repozitoriydagi barcha kompaniyalar, mahsulotlar, brendlar va shaxslar xayoliydir. Misollar buyurtma bermaydi, kartalardan mablag‘ yechmaydi yoki amaldagi e’lonlarni yangilamaydi. To‘lovni yakunlash host ilovaga topshiriladi, sotuvchi tomonidan kiritiladigan o‘zgarishlar esa inson tasdiqlamaguncha tayyorlangan holatda qoladi.

Ikki agent rolini tushunish

Xarid agenti

Xarid agenti mahsulotlarni qidirish va taqqoslash, xaridlarni rejalashtirish, savatni to‘ldirish, buyurtma va siyosatlarga oid savollarga javob berish hamda mijoz taqdim etgan ma’lumotlarni eslab qolish kabi mijozlarga mo‘ljallangan vazifalarni qo‘llab-quvvatlaydi.

Uning beshta oqimi shopping-agent/skills/ ichida joylashgan. Agentni haqiqiy tizimlar bilan ishlatish uchun joriy katalog, savat, buyurtma va siyosat xizmatlari asosida StorefrontBackendni amalga oshirishingiz kerak.

Sotuvchi agenti

Sotuvchi agenti xodimlarga samaradorlikni tushunish, e’lonlarni yuritish, zaxira va buyurtma ogohlantirishlariga javob berish, narxlar va aksiyalarni o‘zgartirish hamda kampaniyalar loyihasini tayyorlashda yordam beradi. Uning beshta oqimi merchant-agent/skills/ ichida joylashgan.

Joylashtirish jarayonida agentni tahlil, katalog, zaxira, narxlash va kampaniya tizimlariga MerchantBackendni amalga oshirish orqali ulang. Har bir yozuv darhol qo‘llanmaydi, balki tayyorlangan holatda saqlanadi; host ilova taklif qilingan o‘zgarishni ko‘rsatishi va tasdiqlashi kerak.

Asosiy arxitektura va imkoniyatlar

• Umumiy asoslar: commerce-common/ ikkala rol tomonidan ishlatiladigan konfiguratsiya, to‘siqlash, xotira, ko‘nikmalarni boshqarish, grounding, taqdimot, hodisalar va executor karkasini o‘z ichiga oladi.
• Bir nechta ish muhitlari: bir xil promptlar, ko‘nikmalar va vosita shartnomalari Messages API, Agent SDK va Managed Agents bilan ishlaydi.
• Backend abstraksiyasi: agent vositalari backend interfeyslarini chaqiradi, shu orqali serveringiz hisob ma’lumotlarini saqlashi va biznes tizimlariga kirishni vositachilik qilishi mumkin.
• Sotuvchi o‘zgarishlarini tayyorlash: sotuvchi yozuvlari host ilovasining tasdiqlash oynasi orqali tasdiqlanishi kerak.
• Sozlanadigan imkoniyatlar: qo‘llab-quvvatlanmaydigan imkoniyatlarni o‘chirib qo‘yish mumkin, bunda ularga tegishli vositalar, prompt satrlari va grounding qoidalari olib tashlanadi.
• Kengaytiriladigan taqdimot: sohaga xos interfeyslarni PresentationExtension orqali qo‘shish mumkin.
• Ishlaydigan misollar: sakkizta veb-ilova to‘rtta vertikal sohaning har biri uchun storefront va sotuvchi portalini taqdim etadi.

Talablar

Python 3.11 yoki undan yangiroq va Node.js 22ni o‘rnating. Shuningdek, model bilan jonli ishlashni ishga tushirish uchun Anthropic API kaliti kerak bo‘ladi.

Repozitoriyni o‘rnatish

Loyihani klonlang, Python virtual muhitini yarating, Python bog‘liqliklarining belgilangan versiyalarini o‘rnating, muhit faylini yarating va umumiy JavaScript ish maydonini o‘rnating:

git clone https://github.com/anthropics/commerce-agents.git && cd commerce-agents
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
(cd examples && npm ci)

.env faylini oching va ANTHROPIC_API_KEY qiymatini qo‘shing. Python skriptlarini ishga tushirayotganda virtual muhitni faol holda saqlang.

Birinchi demoni ishga tushirish

Chakana savdo storefronti va uning API'sini quyidagi buyruq bilan ishga tushiring:

python scripts/run_demo.py retail

Chakana savdo API'si 8000-portda, storefront esa 3000-portda ishlaydi. Storefront o‘rniga sotuvchi portalini ishga tushirish uchun --merchantni qo‘shing:

python scripts/run_demo.py retail --merchant

Ikkala interfeysni ham ishga tushirish uchun --alldan foydalaning:

python scripts/run_demo.py retail --all

Mavjud vertikal sohalar va veb-portlar:

• Chakana savdo: storefront 3000, sotuvchi portali 3100.
• Sayohat: storefront 3001, sotuvchi portali 3101.
• Telekommunikatsiya: storefront 3002, sotuvchi portali 3102.
• Ko‘ngilochar soha: storefront 3003, sotuvchi portali 3103.

Har bir misol katalogida tavsiya etilgan promptlar va yaxshi javob nimalarni o‘z ichiga olishi kerakligi tasvirlangan README mavjud.

Vertikal misollarni o‘rganish

Chakana savdo

ACME chakana savdo misoli mahsulot qidiruvi, taqqoslashlar, rejalashtirish, savatlar, to‘lovni yakunlashni topshirish va xotira imkoniyatlarini namoyish etadi. Uning sotuvchi portali samaradorlik dayjestlari, tayyorlangan zaxira to‘ldirishlari, e’lonlarni tuzatish va SQL ko‘rinishi ustidagi tahlil delegatini o‘z ichiga oladi.

Sayohat

ACME Travel sanaga bog‘langan zaxira va present_itinerary kengaytmasini qo‘shadi. Sotuvchi qismida bandlik taqvimi va sana oralig‘iga bog‘liq tarif o‘zgarishlari mavjud.

Telekommunikatsiya

ACME Mobile hisob konteksti, tariflar matritsasi va server tomonidan yaratiladigan to‘lov ma’lumotlarini namoyish etadi. Sotuvchi ish jarayonlari tariflar tarkibi va narx o‘zgarishlarini qamrab oladi, shu bilan birga tartibga solinadigan to‘lovlar himoyalanadi.

Ko‘ngilochar soha

ACME Tickets vaqtli band qilish, kutish ro‘yxatlari, o‘tkazmalar, venue xaritalari va barcha to‘lovlarni o‘z ichiga olgan narx ma’lumotlarini taqdim etadi. Uning sotuvchi vositalari tadbir sur’ati, sig‘imni bo‘shatadigan band qilishlarni bekor qilish va to‘lovlarni saqlagan holda narxlarni o‘zgartirishni qamrab oladi.

Messages API ish muhitidan foydalanish

Messages API implementatsiyasi havolaviy navbat siklidir. Konfiguratsiya yarating, backend implementatsiyangizni taqdim eting, runtime'ni shopping ko‘nikmalariga yo‘naltiring va navbat davomida yaratilgan hodisalarni oqim ko‘rinishida oling:

from pathlib import Path

from shopping_agent import ShoppingAgentConfig
from shopping_agent_runtime import ShoppingAgent

agent = ShoppingAgent(
    backend=your_backend,
    skills_dir=Path("shopping-agent/skills"),
    config=ShoppingAgentConfig(brand_name="Your Store"),
)

async for event in agent.stream_turn(messages, session, state):
    ...

await agent.update_memory(messages, session)

Hodisalar oqimi text_delta, tool_call, ui, cart_update va turn_complete hodisalarini o‘z ichiga olishi mumkin. Merchant tomonida bosqichma-bosqich yozuvlar change_update hodisalari orqali ifodalanadi.

update_memory orqali xotira ajratib olish ushbu runtime yo‘liga xos. Namunaviy hostlar sessiya identifikatorini X-Session-Id so‘rov sarlavhasi orqali oladi.

Agent SDK runtime'idan foydalanish

Agent SDK agent siklini boshqarish bilan birga ayni promptlar, ko‘nikmalar va vositalarni ishga tushiradi. Host grounding ma’lumotlarini oldindan oladi va navbat tugaganidan keyin hech qanday ish bajarilmaydi.

Konsoldan bitta xarid so‘rovini ishga tushiring:

python shopping-agent/runtime-agent-sdk/main.py --once "a two-person tent under $250"

Merchant konsolini ishga tushiring:

python merchant-agent/runtime-agent-sdk/main.py

Merchant konsoli bosqichma-bosqich o‘zgarishlarni qo‘llashdan oldin y/N tasdig‘ini so‘raydi.

Managed Agents orqali deploy qiling

Managed Agents ayni ko‘nikmalar va shartnomalardan foydalangan holda agentni host qiladi. Agent tizimga kirish uchun MCP serveringizga murojaat qiladi. Deploy jarayonini amalda bajarmasdan tekshirish uchun quyidagini ishga tushiring:

scripts/deploy_managed_agent.sh shopping-agent/managed-agents/shopping-agent

Merchant roli uchun merchant-agent/managed-agents/ ostidagi mos yo‘ldan foydalaning. --live parametrini faqat haqiqiy deployni amalga oshirmoqchi bo‘lganingizda qo‘shing.

O‘zingizning commerce agentingizni yarating

To‘plamdagi Claude Code plagini stekingiz asosida loyiha yaratishi yoki mavjud agentni ko‘rib chiqishi mumkin. Repository'ni lokal klonlagach, plaginni ro‘yxatdan o‘tkazing va o‘rnating:

claude plugin marketplace add anthropics/commerce-agents
claude plugin install commerce-builder@claude-commerce-agents
claude

Claude Code ichida shopping yordamchisi skeletini so‘rang:

/scaffold-commerce-agent a shopping assistant for our store

Buyruq texnologiyalar stekingiz haqida so‘raydi, rejasini taqdim etadi va loyihani yaratadi. Ishlanmani /add-commerce-flow va /author-commerce-evals yordamida davom ettiring. Mavjud agent asosida boshlaganingizda /review-commerce-agent buyrug‘idan foydalaning.

Agentlarni tizimlaringizga ulang

Repository MCP connectorlarini o‘z ichiga olmaydi. Buning o‘rniga ikkala agent ham biznes tizimlariga backend interfeyslari orqali ulanadi. Har bir backend metodi joriy sessiya uchun host saqlaydigan hisob ma’lumotlaridan foydalanib, server tomonida xizmatingizga murojaat qilishi kerak. Model faqat metod natijasini oladi.

1. Rolni tanlang: mijozlar xaridlari uchun StorefrontBackendni yoki xodimlar operatsiyalari uchun MerchantBackendni amalga oshiring.
2. O‘qish operatsiyalarini moslang: katalog, siyosatlar, analitika, zaxira, narxlash yoki qo‘llab-quvvatlanadigan boshqa o‘qishlarni asosiy manba tizimlaringizga ulang.
3. Tartibli oqimlarni saqlang: agar ish jarayoni qat’iy ketma-ketlikka amal qilishi kerak bo‘lsa, bu ketma-ketlikni modelga tayanmasdan backend'da majburiy qiling.
4. Yozuvlarni boshqaring: merchant o‘zgarishlarini host tasdiqlash interfeysi ruxsat berguncha bosqichma-bosqich holatda saqlang.
5. Checkout'ga topshiring: checkout URL manzilingizni backend'dan qaytaring va uni host ko‘rsatsin. Model URL manzilni hech qachon ko‘rmasligi kerak.

Backend commerce platformalariga yoki rasmiy connectorlarga server tomonida murojaat qilishi mumkin. Loyiha tilga olgan ehtimoliy integratsiya maqsadlari qatoriga analitika omborlari, moliya tizimlari va yetkazib berish vositalari kiradi. MCP serverlari Managed Agents bilan ishlatilganda ham yozuvlar oldidan provenance gate'lari saqlanishi kerak.

Imkoniyatlar va identifikatsiyani sozlang

Eng kichik foydali sirt bilan boshlang. Shopping pilot qidiruv va mahsulot tafsilotlarini amalga oshirishi, mavjud bo‘lmagan natijalarni esa stub metodlardan qaytarishi mumkin. Merchant pilot sakkizta o‘qish metodini amalga oshirib, yozuvlarni rad etishi mumkin; bunda yozish yo‘lini ochmasdan dayjestlar va metrikalar ishlaydi.

Agar biznesda biror imkoniyat mavjud bo‘lmasa, mos enable_* sozlamasini o‘chiring. Bu barcha runtime yo‘llarida tegishli vositalar, prompt mazmuni va grounding qoidasini olib tashlaydi. Mavjud bo‘lmagan imkoniyatga bog‘liq oqimlar skills/_staged/ ostiga joylashtirilishi mumkin.

skills/ katalogining tegishli qismida SKILL.md bo‘lgan katalog qo‘shib, maxsus oqim yarating. Domenga xos UI uchun PresentationExtensiondan foydalaning. brand_name, assistant_name va brand_voice sozlamalari istalgan agent identifikatsiyasini moslashtiradi.

Xavfsizlik va deploy mas’uliyatlari

Loyiha barcha uchta runtime yo‘lida tool call'lar ichida fencing, provenance gate'lari, cheklovlar, xotirani tekshirish va merchant tasdiqlarini majburiy qo‘llaydi. Grounding, tahlil byudjetlari va xotirani ajratib olish runtime darajasidagi imkoniyatlardir.

Bu boshqaruv elementlari joylashtirishga xos xavfsizlikni almashtirmaydi. Misollarda autentifikatsiya mavjud emas, MCP serverlari esa faqat loopback interfeysiga ulanadi. Ishlab chiqarish hosti identifikatsiya, avtorizatsiya, biznes qoidalari, muvofiqlik, hisob maʼlumotlarini boshqarish va tasdiqlash siyosatlari uchun javobgar bo‘lib qoladi. Haqiqiy tizimlarni ulashdan oldin xavfsizlik qo‘llanmasini ko‘rib chiqing.

Amalga oshirilgan yechimni tekshiring

Test va lint vositalari kerak bo‘lsa, ishlab chiqish talablarini o‘rnating:

pip install -r requirements-dev.txt

Formatlash tekshiruvlari, lint, testlar va repozitoriy tekshiruvlarini ishga tushiring:

ruff check . && ruff format --check . && pytest && python scripts/check.py

Joylashtirishni sinov tariqasida ishga tushirish va veb-buildlarni ham o‘z ichiga olgan to‘liq tekshiruv jarayonini bajaring:

python scripts/verify_all.py

Bitta jonli suhbatni sinab ko‘rish uchun API kalitini taqdim eting va quyidagini ishga tushiring:

python scripts/smoke_chat.py --vertical travel

Ilg‘or maslahatlar

• Kesh xatti-harakatini tekshiring: turn_complete hodisasidan yoki ish vaqtidagi model chaqiruvlari jurnallaridan cache_read_input_tokens qiymatini o‘qing. Ikkinchi burilishdagi nol qiymat prompt prefiksi o‘zgarganini bildiradi.
• Marketpleyslarni qo‘llab-quvvatlang: sotuvchini qidiruv o‘lchami sifatida ko‘ring va merchant agentni sessiya orqali aniqlangan operator doirasida cheklang.
• Hisobga bog‘liq narxlarni hisobga oling: narx hisob yoki shartnomaga bog‘liq bo‘lsa, sessiya hisobiga mos narxni qaytaring.
• Checkoutni moslashtiring: checkout sizga tegishli bo‘lmasa, savatni o‘chirib qo‘ying yoki jarayonni taklif, xarid buyurtmasi yoxud joylashtirilgan checkout sahifasiga yo‘naltiring.
• Platformaga xos mijozlardan foydalaning: runtime’lar client= orqali anthropic mijozini qabul qiladi, SDK runtime’lari esa platforma konfiguratsiyasini CLI muhitidan o‘qiydi.
• Joylashtirish imkoniyatlarini ko‘rib chiqing: repozitoriy GCP Vertex AI, AWS Bedrock, Microsoft Foundry va gateway orqali joylashtirishni joylashtirish qo‘llanmasida hujjatlashtiradi.
• Backend moslashtirilishini o‘rganing: identifikatsiya, hisob maʼlumotlari, checkout, buyurtma jarayonlari, mahsulot opsiyalari va mavjud bo‘lmagan raqamlar backend qo‘llanmasida yoritilgan.

Xulosa

Claude Commerce Agents umumiy promptlar, ko‘nikmalar, kontraktlar va xavfsizlik boshqaruvlari asosida mijozlarga yo‘naltirilgan xarid yordamchilari hamda tasdiqlash bilan cheklangan merchant vositalarini yaratish uchun amaliy arxitekturani taqdim etadi. Ishlaydigan vertikal yechimdan boshlang, platformangizga mos runtime’ni tanlang, tegishli backend interfeysini joriy qiling, qo‘llab-quvvatlanmaydigan imkoniyatlarni o‘chirib qo‘ying va ishlab chiqarish maʼlumotlari yoki yozish amallarini ulashdan oldin to‘liq tizimni tekshiring.

Repozitoriy Apache License 2.0 litsenziyasi asosida tarqatiladi. U namunaviy amalga oshirish bo‘lib, qo‘llab-quvvatlanmaydi va hissalarni qabul qilmaydi.