Yakha Futhi Usebenzise Ama-ejenti Okuthenga Nabathengisi nge-Claude Commerce Agents

Okuhlinzekwa yi-Claude Commerce Agents

I-Claude Commerce Agents iwukusetshenziswa okuyisibonelo kwama-ejenti amabili e-AI agxile kwezohwebo, akhelwe phezu kwe-Claude. Ibhizinisi lingafaka i-ejenti yokuthenga kuhlelo olubhekene namakhasimende, kuyilapho abasebenzi bengasebenzisa i-ejenti yomthengisi ukuphatha izinqubo zasemuva.

Ijenti ngayinye ichazwa kanye kuphela kusetshenziswa i-prompt yayo, amakhono, izivumelwano zamathuluzi, namasango okuphepha. Lezi zincazelo ezifanayo zingasebenza nge-Messages API, i-Claude Agent SDK, noma i-Managed Agents. Izibonelo ezine ezisebenzayo zibonisa ukwakheka ezindaweni zokudayisa, ezokuvakasha, ezokuxhumana, nezokuzijabulisa.

Zonke izinkampani, imikhiqizo, amabhrendi, nabantu abakule repository bayizinganekwane. Izibonelo azifaki ama-oda, azikhokhisi amakhadi, futhi azibuyekezi uhlu olusebenzayo. Ukukhokha kudluliselwa kumphathi, kanti izinguquko zomthengisi zihlala zisesigabeni sokusalindile kuze kube umuntu uyazivuma.

Qonda izindima ezimbili zama-ejenti

I-ejenti yokuthenga

I-ejenti yokuthenga isiza ngemisebenzi ebhekene namakhasimende, njengokusesha nokuqhathanisa imikhiqizo, ukuhlela okuthengiwe, ukugcwalisa inqola, ukuphendula imibuzo ngama-oda nezinqubomgomo, kanye nokukhumbula ulwazi olunikezwe ikhasimende.

Imisebenzi yayo emihlanu itholakala ngaphansi kwe-shopping-agent/skills/. Ukuze usebenzise i-ejenti nezinhlelo zangempela, ukusetshenziswa kwakho kufanele kusebenzise StorefrontBackend phezu kwezinsizakalo ezifanele zekhathalogi, zenqola, zama-oda, nezinqubomgomo.

I-ejenti yomthengisi

I-ejenti yomthengisi isiza abasebenzi baqonde ukusebenza, bagcine uhlu lwemikhiqizo, baphendule izexwayiso zesitoko nama-oda, balungise amanani namaphromoshini, futhi babhale imikhankaso. Imisebenzi yayo emihlanu ingaphansi kwe-merchant-agent/skills/.

Ukusetshenziswa kwayo kuxhuma ezinhlelweni zezibalo, zekhathalogi, zesitoko, zamanani, nezemikhankaso ngokusebenzisa MerchantBackend. Konke ukubhala kufakwa esigabeni sokusalindile kunokuba kusetshenziswe ngokushesha; uhlelo lomphathi kufanele lubonise futhi luvume ushintsho oluhlongozwayo.

Ukwakhiwa nezici ezibalulekile

• Izisekelo ezabiwe: commerce-common/ iqukethe ukumiswa, ukuvimbela ukungqubuzana, inkumbulo, ukuphathwa kwamakhono, ukusekela izimangalo ngedatha, ukwethulwa, imicimbi, nohlaka lom执行eli olusetshenziswa yizo zombili izindima.
• Izikhathi zokusebenza eziningi: ama-prompt, amakhono, nezivumelwano zamathuluzi ezifanayo zisebenza ne-Messages API, i-Agent SDK, kanye ne-Managed Agents.
• Ukwehlukaniswa kwe-backend: amathuluzi ama-ejenti abiza izixhumi ze-backend, okuvumela iseva yakho igcine imininingwane yokufinyelela futhi ilawule ukufinyelela ezinhlelweni zebhizinisi.
• Izinguquko zomthengisi ezisalindile: ukubhala komthengisi kudinga ukuvunywa endaweni yokuvuma yohlelo lomphathi.
• Amakhono alungisekayo: izici ezingasekelwe zingavalwa ukuze amathuluzi azo, imigqa yama-prompt, nemithetho yokusekela izimangalo ngedatha kususwe.
• Ukwethulwa okunwebekayo: izixhumi ezithile zesizinda zingangezwa nge-PresentationExtension.
• Izibonelo ezisebenzayo: izinhlelo zokusebenza zewebhu eziyisishiyagalombili zinikeza isitolo kanye nengosi yomthengisi endaweni ngayinye kwezine.

Okudingekayo ngaphambi kokuqala

Faka Python 3.11 noma entsha kanye ne-Node.js 22. Udinga futhi ukhiye we-Anthropic API ukuze usebenzise ukuxhumana okubukhoma namamodeli.

Faka i-repository

Clone iphrojekthi, dala indawo ebonakalayo ye-Python, faka okuncikile kwe-Python oku-pinned, dala ifayela lendawo, bese ufaka indawo yokusebenza ye-JavaScript eyabiwe:

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)

Vula .env bese wengeza i-ANTHROPIC_API_KEY yakho. Gcina indawo ebonakalayo isebenza ngenkathi usebenzisa izikripthi ze-Python.

Qalisa idemo yakho yokuqala

Qalisa isitolo sokudayisa kanye ne-API yaso usebenzisa:

python scripts/run_demo.py retail

I-API yokudayisa isebenza ku-port 8000, kanti isitolo sisebenza ku-port 3000. Ukuze uqale ingosi yomthengisi esikhundleni sesitolo, engeza --merchant:

python scripts/run_demo.py retail --merchant

Sebenzisa --all ukuze uqale zombili izindawo:

python scripts/run_demo.py retail --all

Izindawo ezitholakalayo nama-port ewebhu yilezi:

• Ukudayisa: isitolo 3000, ingosi yomthengisi 3100.
• Ezokuvakasha: isitolo 3001, ingosi yomthengisi 3101.
• Ezokuxhumana: isitolo 3002, ingosi yomthengisi 3102.
• Ezokuzijabulisa: isitolo 3003, ingosi yomthengisi 3103.

Uhlu ngalunye lwezibonelo lune-README enemiyalo ephakanyisiwe nencazelo yalokho okufanele kube nempendulo enhle.

Hlola izibonelo zezindawo

Ukudayisa

Isibonelo sokudayisa se-ACME sibonisa ukusesha kwemikhiqizo, ukuqhathanisa, ukuhlela, izinqola, ukudluliselwa kokukhokha, kanye nenkumbulo. Ingosi yomthengisi yayo ihlanganisa izifinyezo zokusebenza, ukufakwa kwesitoko okulindile, ukulungiswa kohlu, kanye nomthunywa wokuhlaziya osebenzisa ukubuka kwe-SQL.

Ezokuvakasha

I-ACME Travel yengeza isitoko esiboshelwe ezinsukwini kanye nesandiso se-present_itinerary. Ingxenye yomthengisi ihlanganisa ikhalenda lokugcwala kanye nezinguquko zamanani eziboshelwe kumawindi ezinsuku.

Ezokuxhumana

I-ACME Mobile ibonisa umongo we-akhawunti, imatrix yezinhlelo, kanye nokudalulwa kwezimali okubhalwe yiseva. Izinqubo zomthengisi zihlanganisa inhlanganisela yezinhlelo nezinguquko zamanani, kuyilapho kuvikela izimali ezilawulwayo.

Ezokuzijabulisa

I-ACME Tickets ihlanganisa ukubanjwa kwesikhathi, izinhlu zokulinda, ukudluliselwa, amamephu ezindawo, kanye nokudalulwa kwazo zonke izimali. Amathuluzi ayo omthengisi ahlanganisa ukuhamba kwemicimbi, ukukhulula ukubanjwa okukhiqiza umthamo, kanye nezinguquko zamanani ezigcina izimali.

Sebenzisa isikhathi sokusebenza se-Messages API

Ukuqaliswa kwe-Messages API kuyiluphu eyisithenjwa yokushintshana. Dala ukucushwa, unikeze ukuqaliswa kwe-backend yakho, uqondise i-runtime kumakhono okuthenga, bese usakaza imicimbi ekhiqizwa ngesikhathi sokushintshana:

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)

Ukusakazwa kwemicimbi kungafaka text_delta, tool_call, ui, cart_update, kanye no-turn_complete. Ohlangothini lomthengisi, ukubhala okuhlehlisiwe kuvezwa yimicimbi ye-change_update.

Ukukhishwa kwememori nge-update_memory kuqondene nale ndlela ye-runtime. Izibonelo zabasingathi zithola isihlonzi seseshini ngesihloko sesicelo esithi X-Session-Id.

Sebenzisa i-Agent SDK runtime

I-Agent SDK isebenzisa ama-prompt, amakhono, namathuluzi afanayo ngenkathi iphethe iluphu ye-agent. Umsingathi ulayisha kusengaphambili ukufundwa okudingekayo ukuze kutholakale ulwazi oluqondisayo, futhi akukho msebenzi oqhubekayo ngemva kokushintshana.

Qalisa isicelo esisodwa sokuthenga kukhonsoli:

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

Qalisa ikhonsoli yomthengisi ngokuthi:

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

Ikhonsoli yomthengisi icela imvume ethi y/N ngaphambi kokusebenzisa izinguquko ezihlehlisiwe.

Sabalalisa nge-Managed Agents

I-Managed Agents ibamba i-agent ngenkathi isebenzisa amakhono nezinkontileka ezifanayo. I-agent ibiza iseva yakho ye-MCP ukuze ithole ukufinyelela ezinhlelweni. Qalisa ukuhlolwa kokusabalalisa ngaphandle kokwenza izinguquko ngokuthi:

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

Sebenzisa indlela elinganayo engaphansi kwe-merchant-agent/managed-agents/ endimeni yomthengisi. Faka i---live kuphela uma uhlose ukwenza ukusabalalisa okubukhoma.

Yakha i-commerce agent yakho

I-plugin ye-Claude Code efakiwe ingakudalela iphrojekthi esebenzisa i-stack yakho noma ibuyekeze i-agent ekhona. Njengoba i-repository isikloniwe endaweni, bhalisa bese ufaka i-plugin:

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

Ngaphakathi kwe-Claude Code, cela ukwakhiwa kwesisekelo somsizi wokuthenga:

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

Umyalo ubuza nge-stack yakho yobuchwepheshe, wethule uhlelo lwawo, bese wakha iphrojekthi. Qhubeka nokuthuthukisa usebenzisa /add-commerce-flow kanye ne-/author-commerce-evals. Sebenzisa /review-commerce-agent lapho uqala nge-agent esivele ikhona.

Xhuma ama-agent ezinhlelweni zakho

I-repository ayizi nezixhumi ze-MCP. Kunalokho, womabili ama-agent afinyelela ezinhlelweni zebhizinisi ngokusebenzisa izixhumi ze-backend. Indlela ngayinye ye-backend kufanele ibize isevisi yakho ohlangothini lweseva isebenzisa iziqinisekiso ezigcinwe ngumsingathi zeseshini yamanje. Imodeli ithola kuphela umphumela wendlela.

1. Khetha indima: sebenzisa i-StorefrontBackend yokuthengela amakhasimende noma i-MerchantBackend yokusebenza kwabasebenzi.
2. Hlela imisebenzi yokufunda: xhuma ikhathalogi, izinqubomgomo, izibalo, isitoko, amanani, noma okunye ukufunda okusekelwayo ezinhlelweni zakho eziyinhloko zokugcina amarekhodi.
3. Gcina ukugeleza okuhleliwe: uma inqubo kufanele ilandele ukulandelana okumisiwe, phoqa lokho kulandelana ku-backend kunokuthembela kumodeli.
4. Lawula ukubhala: gcina izinguquko zomthengisi zihlehlisiwe kuze kube yilapho indawo yokugunyaza yomsingathi izigunyaza.
5. Dlulisela ku-checkout: buyisa i-URL yakho ye-checkout ku-backend bese uvumela umsizingathi ayiveze. Imodeli akufanele neze iyibone i-URL.

I-backend ingabiza amapulatifomu e-commerce noma izixhumi ezisemthethweni ohlangothini lweseva. Izindawo ezingaba yizinjongo zokuhlanganisa ezishiwo yiphrojekthi zifaka izinqolobane zedatha yezibalo, izinhlelo zezimali, namathuluzi okuletha. Amasango okuqinisekisa umsuka wolwazi kufanele ahlale ephambi kokubhala, kuhlanganisa nalapho amaseva e-MCP esetshenziswa ne-Managed Agents.

Yenza ngokwezifiso amakhono nobuwena

Qala ngendawo encane ewusizo. I-pilot yokuthenga ingasebenzisa ukusesha nemininingwane yomkhiqizo ngenkathi ibuyisa imiphumela ethi ayitholakali ezindleleni ezisetshenziswa njengesibonelo. I-pilot yomthengisi ingasebenzisa izindlela zokufunda eziyisishiyagalombili futhi yenqabe ukubhala, ivumele izifinyezo namamethrikhi kusebenze ngaphandle kokuveza indlela yokubhala.

Uma ibhizinisi lingenalo ikhono elithile, cisha isilungiselelo esihambisanayo se-enable_*. Lokhu kususa amathuluzi ahambisanayo, okuqukethwe kwe-prompt, nomthetho wokuqondisa ulwazi kuyo yonke indlela ye-runtime. Ukugeleza okuncike ekhonweni elingatholakali kungafakwa ngaphansi kwe-skills/_staged/.

Dala ukugeleza ngokwezifiso ngokwengeza uhla lwemibhalo oluqukethe i-SKILL.md ngaphansi kohla lwemibhalo olufanele lwe-skills/. Sebenzisa i-PresentationExtension ukuze uthole i-UI eqondene nesizinda. Izilungiselelo ze-brand_name, assistant_name, ne-brand_voice zenza ubuwena banoma iyiphi i-agent benziwe ngokwezifiso.

Izibopho zokuphepha nokusabalalisa

Iphrojekthi iphoqelela ukuhlukaniswa kwemingcele, amasango okuqinisekisa umsuka wolwazi, imikhawulo, ukuqinisekiswa kwememori, nokugunyazwa kwabathengisi ngaphakathi kwezingcingo zamathuluzi kuzo zonke izindlela ezintathu ze-runtime. Ukuqondisa ulwazi, amabhajethi okuhlaziya, nokukhishwa kwememori yizici ezisezingeni le-runtime.

Lezi zilawuli azithathi indawo yokuphepha okuqondene nokusetshenziswa ngakunye. Izibonelo azinakho ukuqinisekiswa kobuwena, futhi amaseva azo e-MCP abophele ku-loopback kuphela. I-host yakho yokukhiqiza isalokhu inesibopho sobuwena, ukugunyazwa, imithetho yebhizinisi, ukuthobela imithetho, ukuphathwa kwemininingwane yokungena, kanye nezinqubomgomo zokugunyaza. Buyekeza umhlahlandlela wokuphepha ngaphambi kokuxhuma amasistimu angempela.

Qinisekisa ukuqaliswa

Faka izidingo zokuthuthukisa uma udinga amathuluzi okuhlola nawokuhlola ikhwalithi yekhodi:

pip install -r requirements-dev.txt

Qalisa ukuhlolwa kokufometha, ukuhlolwa kwe-lint, izivivinyo, kanye nokuhlolwa kwe-repository:

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

Qalisa ukugeleza okuphelele kokuqinisekisa, okuhlanganisa ukugijimisa kokulingisa kokuthunyelwa nokwakhiwa kwewebhu:

python scripts/verify_all.py

Ukuze uhlole ingxoxo eyodwa ebukhoma, nikeza ukhiye we-API bese uqalisa:

python scripts/smoke_chat.py --vertical travel

Amathiphu athuthukile

• Hlola ukuziphatha kwe-cache: funda cache_read_input_tokens esehlakalweni se-turn_complete noma kumalogi okubiza imodeli ngesikhathi sokusebenza. Inani elinguziro ethunini lesibili libonisa ukuthi isiqalo se-prompt sishintshile.
• Sekela izimakethe: phatha umthengisi njengobukhulu bokusesha, bese ubeka i-ejenti yomthengisi kumsebenzisi osebenza kuyo okhonjwe yiseshini.
• Hl ಗೌ respect amanani e-akhawunti: lapho intengo incike ku-akhawunti noma kwinkontileka, buyisa intengo esebenza ku-akhawunti yeseshini.
• Hlela i-checkout: uma ungeyena umnikazi we-checkout, khubaza inqola noma dlulisela ukugeleza ku-quote, ku-oda lokuthenga, noma ekhasini le-checkout elisingathwayo.
• Sebenzisa amaklayenti aqondene neplathifomu: ama-runtime amukela iklayenti le-anthropic nge-client=, kuyilapho ama-runtime e-SDK efunda ukumiswa kweplathifomu yawo endaweni ye-CLI.
• Buyekeza izinketho zokuthunyelwa: i-repository ichaza ukuthunyelwa kwe-GCP Vertex AI, AWS Bedrock, Microsoft Foundry, kanye ne-gateway ku-umhlahlandlela wokuthunyelwa.
• Funda ngokuxhumana ne-backend: ubuwena, imininingwane yokungena, i-checkout, ukugeleza oku-odwe, izinketho zomkhiqizo, kanye nezibalo ezingatholakali kuchazwe ku-umhlahlandlela we-backend.

Isiphetho

I-Claude Commerce Agents inikeza ukwakheka okusebenzayo kokwakha abasizi bokuthenga ababhekene namakhasimende namathuluzi omthengisi adinga ukugunyazwa, kusetshenziswa ama-prompt, amakhono, izinkontileka, kanye nezilawuli zokuphepha ezabiwe. Qala nge-vertical esebenzayo, khetha i-runtime ehambisana neplathifomu yakho, sebenzisa isixhumi esibonakalayo esifanele se-backend, khubaza amakhono angasekelwa, bese uqinisekisa lonke uhlelo ngaphambi kokuxhuma idatha yokukhiqiza noma imisebenzi yokubhala.

I-repository inelayisensi ngaphansi kwe-Apache License 2.0. Iwukuqaliswa okuyisibonelo, ayisanakekelwa, futhi ayamukeli iminikelo.