Jenga na Uendeshe Mawakala wa Ununuzi na Wafanyabiashara kwa Claude Commerce Agents

Claude Commerce Agents hutoa nini

Claude Commerce Agents ni utekelezaji wa marejeo wa mawakala wawili wa AI wanaolenga biashara, waliojengwa kwa kutumia Claude. Biashara inaweza kupachika shopping agent katika programu inayotumiwa na wateja, huku wafanyakazi wakitumia merchant agent kuendesha taratibu za nyuma ya ofisi.

Kila wakala hufafanuliwa mara moja kupitia prompt yake, ujuzi, mikataba ya zana, na vizuizi vya usalama. Ufafanuzi huo unaweza kuendeshwa kupitia Messages API, Claude Agent SDK, au Managed Agents. Vertikali nne zinazoweza kuendeshwa zinaonyesha usanifu huu katika biashara ya rejareja, usafiri, mawasiliano, na burudani.

Kampuni, bidhaa, chapa, na watu wote katika hazina hii ni wa kubuni. Mifano haiweki oda, haitoi malipo kwa kadi, wala kusasisha orodha zinazotumika. Malipo hukabidhiwa kwa mwenyeji, na mabadiliko ya mfanyabiashara hubaki yakiwa yameandaliwa hadi mtu ayaidhinishe.

Elewa majukumu mawili ya mawakala

Shopping agent

Shopping agent husaidia kazi zinazowalenga wateja kama vile kutafuta na kulinganisha bidhaa, kupanga manunuzi, kujaza kikapu, kujibu maswali kuhusu oda na sera, na kukumbuka maelezo yaliyotolewa na mteja.

Mitiririko yake mitano iko chini ya shopping-agent/skills/. Ili kutumia wakala na mifumo halisi, uwekaji wako hutekeleza StorefrontBackend juu ya huduma husika za katalogi, kikapu, oda, na sera.

Merchant agent

Merchant agent huwasaidia wafanyakazi kuelewa utendaji, kudumisha orodha, kujibu arifa za bidhaa zilizopo na oda, kurekebisha bei na matangazo, na kuandaa rasimu za kampeni. Mitiririko yake mitano iko chini ya merchant-agent/skills/.

Uwekaji huunganisha wakala na mifumo ya uchanganuzi, katalogi, bidhaa zilizopo, bei, na kampeni kwa kutekeleza MerchantBackend. Kila uandishi huandaliwa badala ya kutekelezwa mara moja; programu mwenyeji lazima iwasilishe na kuidhinisha mabadiliko yaliyopendekezwa.

Usanifu na vipengele muhimu

• Misingi inayoshirikiwa: commerce-common/ ina usanidi, uzuiaji, kumbukumbu, ushughulikiaji wa ujuzi, uegemezaji, uwasilishaji, matukio, na mfumo wa utekelezaji unaotumiwa na majukumu yote mawili.
• Mazingira mengi ya utekelezaji: prompt, ujuzi, na mikataba ileile ya zana hufanya kazi na Messages API, Agent SDK, na Managed Agents.
• Uondoaji wa utegemezi wa backend: zana za mawakala huita violesura vya backend, hivyo seva yako inaweza kuhifadhi vitambulisho vya ufikiaji na kudhibiti ufikiaji wa mifumo ya biashara.
• Mabadiliko ya mfanyabiashara yaliyoandaliwa: uandishi wa mfanyabiashara unahitaji idhini kupitia sehemu ya idhini ya programu mwenyeji.
• Uwezo unaoweza kusanidiwa: vipengele visivyotumika vinaweza kuzimwa ili zana, mistari ya prompt, na kanuni za uegemezaji ziondolewe.
• Uwasilishaji unaoweza kupanuliwa: violesura mahususi vya kikoa vinaweza kuongezwa kupitia PresentationExtension.
• Mifano inayoweza kuendeshwa: programu nane za wavuti hutoa storefront na tovuti ya mfanyabiashara kwa kila mojawapo ya vertikali nne.

Mahitaji ya awali

Sakinisha Python 3.11 au mpya zaidi na Node.js 22. Pia unahitaji ufunguo wa API wa Anthropic ili kuendesha mwingiliano wa moja kwa moja na modeli.

Sakinisha hazina

Clone mradi, tengeneza mazingira pepe ya Python, sakinisha utegemezi wa Python uliobandikwa matoleo, tengeneza faili la mazingira, na sakinisha workspace ya pamoja ya JavaScript:

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)

Fungua .env na uongeze ANTHROPIC_API_KEY yako. Weka mazingira pepe likiwa limewashwa unapoendesha hati za Python.

Endesha onyesho lako la kwanza

Anzisha storefront ya rejareja na API yake kwa:

python scripts/run_demo.py retail

API ya rejareja huendeshwa kwenye porti 8000, na storefront huendeshwa kwenye porti 3000. Ili kuanzisha tovuti ya mfanyabiashara badala ya storefront, ongeza --merchant:

python scripts/run_demo.py retail --merchant

Tumia --all kuanzisha sehemu zote mbili:

python scripts/run_demo.py retail --all

Vertikali zinazopatikana na porti zake za wavuti ni:

• Rejareja: storefront 3000, tovuti ya mfanyabiashara 3100.
• Usafiri: storefront 3001, tovuti ya mfanyabiashara 3101.
• Mawasiliano: storefront 3002, tovuti ya mfanyabiashara 3102.
• Burudani: storefront 3003, tovuti ya mfanyabiashara 3103.

Kila saraka ya mfano ina README yenye prompt zilizopendekezwa na maelezo ya kile ambacho jibu zuri linapaswa kuwa nacho.

Chunguza vertikali za mfano

Rejareja

Mfano wa rejareja wa ACME unaonyesha utafutaji wa bidhaa, ulinganishaji, upangaji, vikapu, makabidhiano ya malipo, na kumbukumbu. Tovuti yake ya mfanyabiashara ina muhtasari wa utendaji, urejeshaji wa bidhaa uliopangwa, marekebisho ya orodha, na mjumbe wa uchanganuzi juu ya mwonekano wa SQL.

Usafiri

ACME Travel huongeza bidhaa zilizopo zinazofungamana na tarehe na kiendelezi cha present_itinerary. Upande wa mfanyabiashara una kalenda ya kujazwa na mabadiliko ya viwango ndani ya madirisha ya tarehe.

Mawasiliano

ACME Mobile huonyesha muktadha wa akaunti, jedwali la mipango, na ufichuzi wa ada ulioandikwa na seva. Mitiririko ya mfanyabiashara inashughulikia mchanganyiko wa mipango na mabadiliko ya bei huku ikilinda ada zinazodhibitiwa.

Burudani

ACME Tickets inajumuisha uhifadhi wa muda, orodha za kusubiri, uhamishaji, ramani za kumbi, na ufichuzi wa ada zote. Zana zake za mfanyabiashara zinashughulikia mwendo wa matukio, kuachilia uhifadhi unaozalisha uwezo, na mabadiliko ya bei yanayohifadhi ada.

Tumia mazingira ya utekelezaji ya Messages API

Utekelezaji wa Messages API ni mzunguko wa marejeo wa zamu. Unda usanidi, toa utekelezaji wa backend yako, elekeza runtime kwenye ujuzi wa ununuzi, kisha pitisha matukio yanayotengenezwa wakati wa zamu:

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)

Mtiririko wa matukio unaweza kujumuisha text_delta, tool_call, ui, cart_update, na turn_complete. Kwa upande wa mfanyabiashara, uandishi uliowekwa kwenye foleni huwakilishwa na matukio ya change_update.

Uchimbaji wa kumbukumbu kupitia update_memory ni mahususi kwa njia hii ya runtime. Mifano ya wenyeji hupokea kitambulisho cha kipindi kupitia kichwa cha ombi cha X-Session-Id.

Tumia runtime ya Agent SDK

Agent SDK huendesha vidokezo, ujuzi na zana zilezile huku ikisimamia mzunguko wa wakala. Mwenyeji hupakia mapema usomaji wa taarifa za msingi, na hakuna kazi inayoendelea baada ya zamu.

Endesha ombi moja la ununuzi kutoka kwenye kiweko:

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

Anzisha kiweko cha mfanyabiashara kwa:

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

Kiweko cha mfanyabiashara huomba idhini ya y/N kabla ya kutekeleza mabadiliko yaliyowekwa kwenye foleni.

Tekeleza kupitia Managed Agents

Managed Agents humpangisha wakala huku ikitumia ujuzi na mikataba ileile. Wakala huita seva yako ya MCP ili kupata ufikiaji wa mifumo. Endesha jaribio la utekelezaji bila kufanya mabadiliko kwa:

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

Tumia njia inayolingana chini ya merchant-agent/managed-agents/ kwa jukumu la mfanyabiashara. Ongeza --live tu unapokusudia kufanya utekelezaji halisi.

Unda msingi wa wakala wako wa biashara

Programu-jalizi ya Claude Code iliyojumuishwa inaweza kuunda mradi unaolingana na stack yako au kukagua wakala uliopo. Baada ya kuunganisha hifadhi kwenye mashine yako, sajili na usakinishe programu-jalizi:

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

Ndani ya Claude Code, omba msingi wa msaidizi wa ununuzi:

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

Amri hiyo huuliza kuhusu stack yako ya teknolojia, huwasilisha mpango wake, na hujenga mradi. Endelea na uundaji kwa /add-commerce-flow na /author-commerce-evals. Tumia /review-commerce-agent unapoanzia kwa wakala ambaye tayari yupo.

Unganisha mawakala na mifumo yako

Hifadhi hii haisambazi viunganishi vya MCP. Badala yake, mawakala wote wawili hufikia mifumo ya biashara kupitia violesura vya backend. Kila mbinu ya backend inapaswa kuita huduma yako upande wa seva kwa kutumia vitambulisho vinavyoshikiliwa na mwenyeji kwa kipindi cha sasa. Modeli hupokea matokeo ya mbinu pekee.

1. Chagua jukumu: tekeleza StorefrontBackend kwa ununuzi wa wateja au MerchantBackend kwa shughuli za wafanyakazi.
2. Ramani ya shughuli za usomaji: unganisha katalogi, sera, uchanganuzi, hisa, bei au usomaji mwingine unaotumika na mifumo yako ya chanzo kikuu cha taarifa.
3. Hifadhi mtiririko uliopangwa: ikiwa mchakato lazima ufuate mlolongo maalum, tekeleza mlolongo huo kwenye backend badala ya kutegemea modeli.
4. Dhibiti uandishi: weka mabadiliko ya mfanyabiashara kwenye foleni hadi sehemu ya idhini ya mwenyeji iyaidhinishe.
5. Elekeza malipo: rudisha URL yako ya malipo kutoka backend na umruhusu mwenyeji kuionyesha. Modeli haipaswi kamwe kuona URL hiyo.

Backend inaweza kuita majukwaa ya biashara au viunganishi rasmi upande wa seva. Malengo ya muunganisho yaliyotajwa na mradi yanajumuisha maghala ya uchanganuzi, mifumo ya fedha na zana za uwasilishaji. Milango ya uthibitishaji wa chanzo inapaswa kubaki mbele ya uandishi, ikiwemo wakati seva za MCP zinatumiwa na Managed Agents.

Geuza uwezo na utambulisho kukufaa

Anza na kiolesura kidogo chenye manufaa. Mradi wa majaribio wa ununuzi unaweza kutekeleza utafutaji na maelezo ya bidhaa huku ukirudisha matokeo yasiyopatikana kutoka kwa mbinu za mfano. Mradi wa majaribio wa mfanyabiashara unaweza kutekeleza mbinu nane za usomaji na kukataa uandishi, hivyo kuruhusu muhtasari na vipimo kufanya kazi bila kuweka wazi njia ya uandishi.

Ikiwa biashara haina uwezo fulani, zima mpangilio unaolingana wa enable_*. Hii huondoa zana zinazohusiana, maudhui ya kidokezo na kanuni ya taarifa za msingi katika kila njia ya runtime. Mitiririko inayotegemea uwezo usiopatikana inaweza kuwekwa chini ya skills/_staged/.

Unda mtiririko maalum kwa kuongeza saraka iliyo na SKILL.md chini ya saraka inayofaa ya skills/. Tumia PresentationExtension kwa kiolesura mahususi cha kikoa. Mipangilio ya brand_name, assistant_name na brand_voice hubinafsisha utambulisho wa wakala wowote.

Majukumu ya usalama na utekelezaji

Mradi hutekeleza vizuizi vya mipaka, milango ya uthibitishaji wa chanzo, vikomo, uthibitishaji wa kumbukumbu na idhini za mfanyabiashara ndani ya miito ya zana katika njia zote tatu za runtime. Uwekaji wa taarifa za msingi, bajeti za uchanganuzi na uchimbaji wa kumbukumbu ni vipengele vya kiwango cha runtime.

Vidhibiti hivi havichukui nafasi ya usalama mahususi wa uwekaji wa mfumo. Mifano hii haina uthibitishaji, na seva zake za MCP zinafungamana na loopback pekee. Mpangishi wako wa uzalishaji bado anawajibika kwa utambulisho, uidhinishaji, kanuni za biashara, uzingatiaji wa sheria, utunzaji wa vitambulisho, na sera za uidhinishaji. Pitia mwongozo wa usalama kabla ya kuunganisha mifumo halisi.

Thibitisha utekelezaji

Sakinisha mahitaji ya uundaji ikiwa unahitaji zana za majaribio na ukaguzi wa msimbo:

pip install -r requirements-dev.txt

Endesha ukaguzi wa uumbizaji, ukaguzi wa msimbo, majaribio, na ukaguzi wa hifadhi:

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

Endesha mtiririko kamili wa uthibitishaji, ukiwemo majaribio ya uwekaji wa mfumo na uundaji wa wavuti:

python scripts/verify_all.py

Ili kujaribu mazungumzo moja ya moja kwa moja, toa ufunguo wa API kisha endesha:

python scripts/smoke_chat.py --vertical travel

Vidokezo vya hali ya juu

• Chunguza tabia ya akiba: soma cache_read_input_tokens kutoka kwenye tukio la turn_complete au kumbukumbu za wakati wa kuendesha za miito ya modeli. Thamani ya sifuri kwenye zamu ya pili inaonyesha kuwa kiambishi awali cha ombi kimebadilika.
• Hakikisha uungwaji mkono wa masoko: mchukulie muuzaji kama kipimo cha utafutaji na weka wakala wa mfanyabiashara katika upeo wa mwendeshaji aliyetambuliwa na kipindi.
• Heshimu bei za akaunti: bei inap תל?

Hitimisho

Claude Commerce Agents hutoa usanifu wa vitendo wa kuunda wasaidizi wa ununuzi wanaowahudumia wateja na zana za wafanyabiashara zinazohitaji uidhinishaji, kwa kutumia vidokezo, ujuzi, mikataba, na vidhibiti vya usalama vinavyoshirikiwa. Anza na kipengele kinachoweza kuendeshwa, chagua mazingira ya utekelezaji yanayofaa jukwaa lako, tekeleza kiolesura kinachofaa cha backend, zima uwezo usiotumika, na thibitisha mfumo mzima kabla ya kuunganisha data ya uzalishaji au shughuli za uandishi.

Hifadhi hii imepewa leseni chini ya Apache License 2.0. Ni utekelezaji wa marejeleo, haitunzwe, na haikubali michango.