Isifundo Somsizi Wokonga Imali kaMaiMai: Lungiselela Uku-oda kwaMcDonald's nge-MCP futhi Uhlole Ukulahleka Kwamakhuphoni

Isingeniso Sephrojekthi

Umsizi Wokonga Imali kaMaiMai (mcd-coupon-strategist) ungumsizi wezindleko zoku-oda owakhiwe phezu kwe-MCP yaseMcDonald's China. Awuphenduli nje kuphela umbuzo othi “nginga-oda kanjani ngonge kakhulu kulokhu ku-oda?”, kodwa uhlaziya nama-oda adlule nesitoko samakhuphoni ukuze ukutshele ukuthi yimaphi amakhuphoni aseduze nokuphelelwa yisikhathi asephenduka ukulahlekelwa kwangempela.

Le phrojekthi ihlukanisa inkinga yokonga imali yaba imigudu emibili:

• Ukulungiselela kwesikhathi esifushane: Ifunda imenyu yamanje yesitolo namakhuphoni atholakalayo ku-akhawunti, ibale izinto ngazinye, amaphakheji, ukusetshenziswa kwamakhuphoni nezinketho zokwengeza izinto, bese isebenzisa calculate-price ukuthola intengo yangempela ngayinye.
• Ukuhlola kwesikhathi eside: Isebenzisa order-list kanye ne-query-my-coupons ukuhlaziya izindleko, inani le-oda ngalinye, imikhiqizo ethengwa kaningi namakhuphoni aseduze nokuphelelwa yisikhathi.

Umbono oyinhloko wale phrojekthi awukona ukusiza umsebenzisi aqhubeke nokusebenzisa imali kuphela, kodwa ukuqala ngokuthola ukulahlekelwa okuqhubekayo.

Imisebenzi Eyinhloko Nendlela Esebenza Ngayo

Ukubala Intengo Yangempela Yesitolo Samanje

Amanani nesimo sokutholakala kungahluka ezitolo ezahlukene, ngakho iphrojekthi ayigcini amanani emenyu ngaphakathi kwekhodi. Izinketho ezikhethiwe ekugcineni zithunyelwa ku-calculate-price ye-MCP ukuze kubalwe intengo, esikhundleni sokuvumela imodeli iqagele inani.

Umphumela awufaki kuphela inani eliphansi elikhokhwayo, kodwa uchaza nokuthi umehluko wentengo uvela esakhiweni sephakheji, kukhuphoni noma ezintweni ezengeziwe. Ngokwesibonelo, iphakheji yezinto ezintathu ingabiza kancane kunokuthenga ibhega namafrizi ngokwehlukana. Kuleso simo uhlelo luzoncoma ngokusobala iphakheji futhi luchaze ukuthi kongiwe malini.

Ukubona Izingibe Zokwengeza Izinto

Ukusebenzisa ikhuphoni akusho ukuthi njalo uyonga kakhulu. Ake sithi izinto obuhlele ukuzithenga zibiza ama-yuan angu-46.5, bese wengeza into ebiza ama-yuan angu-3.5 ukuze usebenzise ikhuphoni elithi “sebenzisa ama-yuan angu-50, wehliselwe ngo-12”. Ngemva kwekhuphoni ukhokha ama-yuan angu-38; kodwa uma iphakheji efanayo ibiza ama-yuan angu-33.5 kuphela, inketho yokwengeza isabiza ama-yuan angu-4.5 ngaphezulu.

Iphrojekthi iqhathanisa inani lokugcina elikhokhwayo, hhayi inani elidonswe eliboniswe ekhuphoni kuphela. Ngaphandle kokuthi into eyengeziwe ibidingwa umsebenzisi, izokweluleka ngokuqondile ukuthi angayisebenzisi le ndlela.

Ukubala Izindleko Zamakhuphoni Angasetshenzisiwe

“Izindleko ezithule zekhuphoni” yinani lenzuzo yekhuphoni elizophelelwa yisikhathi kungekho osetshenzisiwe. Njengoba amakhuphoni abuyiswa yi-MCP engase abe negama kuphela, iphrojekthi ibheka imenyu yesitolo samanje ukuze ithole inani lawo:

• Ikhuphoni lokwehlisa inani ngemva komkhawulo: “sebenzisa ama-yuan angu-50, wehliselwe ngo-12” libalwa ngokuqondile njengama-yuan angu-12.
• Ikhuphoni lokuthenga okukodwa uthole okukodwa mahhala: “thenga amafrizi aphakathi, uthole elinye mahhala” libalwa ngentengo yemenyu yaleyo nto.
• Ikhuphoni lentengo engaguquki: “ikhofi elibandayo laseMelika eliphakathi ngama-yuan angu-9.9” libalwa njengentengo yemenyu kususwe ama-yuan angu-9.9.

Uma into ehambisanayo ingatholakali kwimenyu, iphrojekthi ibeka inani lekhuphoni ku-0 bese ikumaka embikweni. Ayifaki isilinganiso esibukeka sinengqondo kodwa esingenasisekelo.

Ukuhlaziya Imikhuba Yokusebenzisa Yesikhathi Eside

Imojuli yokuhlola ingahlanganisa inani lama-oda, izindleko eziphelele, inani le-oda ngalinye nezinto ezithengwa kaningi kuma-oda adlule, bese inikeza iziphakamiso zesakhiwo. Ngokwesibonelo, uma ibhega efanayo ithengwa yodwa izikhathi eziningi, uhlelo lungaphakamisa ukuqhathanisa nephakheji ehambisanayo, ngoba ukushintsha kube yiphakheji kuvame ukunciphisa izindleko. Ama-oda abuyiselwe ngokuphelele ayahlungwa ukuze angafakwa ekusetshenzisweni.

Amalungiselelo

Ngaphambi kokusebenzisa imisebenzi ye-MCP eku-inthanethi, lungiselela lokhu okulandelayo:

• Iklayenti elisekela izixhumi ezenziwe ngokwezifiso ze-MCP, njenge-WorkBuddy eboniswe ku-README.
• Ithokheni etholwe endaweni evulekile ye-MCP yakwaMcDonald's.
• Uma kudingeka ukuhlolwa kwasendaweni, i-Python 3.8 noma inguqulo ephezulu.

Amaqoqo amane okuhlola kwasendaweni awadingi ithokheni ye-MCP; kodwa ukuhlola imenyu yangempela, amakhuphoni e-akhawunti nama-oda adlule kudinga ithokheni esebenzayo.

Ukucela Nokumisa Ithokheni Ye-MCP

Isinyathelo Sokuqala: Cela Ithokheni

Vakashela indawo evulekile ye-MCP yakwaMcDonald's, ngena ngenombolo yocingo, bese wenza ithokheni ye-MCP isebenze ku-console uyikopishe.

Isinyathelo Sesibili: Dala Ukumiswa Kwe-MCP

Indawo yokugcina inefayela lokumisa elisuse imininingwane ebucayi, elithi mcp-config.example.json. Isakhiwo sokumisa sinje:

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn",
      "headers": {
        "Authorization": "Bearer ${MCD_MCP_TOKEN}"
      }
    }
  }
}

Shintsha i-${MCD_MCP_TOKEN} ufake ithokheni yakho, bese uyibhala ekumisweni kwe-MCP Client. Ungalokothi uthumele ithokheni yangempela endaweni yokugcina esesidlangalaleni, futhi ungayivezi ezithombeni-skrini, kumalogi noma emibikweni yezinkinga.

Isinyathelo Sesithathu: Yenza Isebenze Ku-WorkBuddy

1. Vula i-WorkBuddy, uye ku-“Ochwepheshe, amakhono, izixhumi” ngakwesokunxele, bese ukhetha ithebhu ethi “Izixhumi”.
2. Chofoza “Isixhumi Esenziwe Ngokwezifiso”, bese ukhetha “Misa i-MCP”.
3. Namathisela ukumiswa kwe-JSON okufakwe ithokheni bese ukulondoloza.
4. Buyela ohlwini lwezixhumi ezenziwe ngokwezifiso, wenze i-mcd-mcp isebenze.

Indlela Eyisisekelo Yokusebenzisa

Isibonelo Sokuqala: Thola Inhlanganisela Ngokwabelwa Kwemali

Qala ngokukhetha isitolo, bese uchaza ngokucacile isabelomali, uhlobo lokudla oludingayo nenani lezinketho ofuna ukuziqhathanisa. Ungathumela ngokuqondile:

Ngisebenzisa uhlelo lokulethwa lukaMcDonald's. Ngemva kokukhetha isitolo ngisize ngibale:
Nginekhuphoni, ngifuna ibhega eyodwa + ingxenye eyodwa yamafrizi + isiphuzo esisodwa, isabelomali singama-yuan angu-40,
nginga-oda kanjani ukuze ngonge kakhulu? Ngiphe izinketho ezimbili ngiziqhathanise.

Umsizi uzofunda imenyu yesitolo samanje namakhuphoni atholakalayo, akhiqize izinhlanganisela ezikhethiwe, bese usebenzisa i-MCP ukubala intengo yangempela. Umphumela ojwayelekile ungase uncome iphakheji yezinto ezintathu ye-McSpicy Chicken Leg Burger ebiza ama-yuan angu-33.5, uyiqhathanise nenketho yokuthenga ibhega namafrizi ngokwehlukana ngama-yuan angu-37.

Isibonelo Sesibili: Khawulela Ukudla Okuyinhloko Nesitsha Esihambisanayo

Isabelomali singama-yuan angu-35, ngifuna ukudla okuyinhloko kwenkukhu nesitsha esisodwa esihambisanayo.
Sicela uhlole izinto ezitholakalayo esitolo samanje, unikeze inketho enconyiwe, enye indlela kanye nenketho ongayincomi,
futhi uchaze ukuthi kungani inketho ngayinye ishibhile noma ibiza kakhulu.

Lolu hlobo lwesicelo lwenza umsizi acabange ngesabelomali, ukusutha kanye nesigaba somkhiqizo ngesikhathi esisodwa, kunokuba ancome nje inketho enenani eliphansi kakhulu kodwa engahlangabezani nezidingo.

Isibonelo Sesithathu: Hlola Ukuthi Ukwengeza Izinto Kuyafaneleka Yini

Nginekhuphoni elithi “sebenzisa ama-yuan angu-50, wehliselwe ngo-12”.
Ngokwezidingo zami zamanje zokuthenga, sicela uqhathanise inani lokugcina lokuthenga ngokuqondile, ukwengeza izinto ukuze ngisebenzise ikhuphoni, nokuthenga iphakheji,
uma ukwengeza izinto kubiza kakhulu, ngixwayise ngokusobala.

Lapho uqhathanisa, gxila enani lokugcina elikhokhwayo, hhayi enanini elidonswe ekhuphoni kuphela. Iphrojekthi ifaka izindleko zezinto ezengeziwe ekubaleni futhi iveze ukuthi iphakheji inenzuzo enkulu yini kunokungeza izinto.

Isibonelo Sesine: Hlola Ukusetshenziswa Kwakamuva

Sicela uhlaziye ama-oda ami kaMcDonald's ezinyangeni ezimbalwa ezedlule:
Bala inani lama-oda, izindleko eziphelele nenani le-oda ngalinye, uthole izinto ezithengwa kaningi;
futhi ubhale amakhuphoni azophelelwa yisikhathi maduze, inani lawo elilindelekile nezinsuku ezisele,
ekugcineni ungitshele ukuthi yini okufanele ngiyilungise kuqala kule nyanga.

Lokhu kuqalisa umgudu wokuhlola wesikhathi eside. Okugxilwa kukho kumphumela kufaka inani eliphelele lamakhuphoni azophelelwa yisikhathi, imikhuba yokusebenzisa kanye neziphakamiso zesakhiwo ezingenziwa, hhayi inani eliphansi le-oda elilodwa kuphela.

Ukuqhuba Ukuhlolwa Kwasendaweni

Ngemva kokuthola ikhodi yomthombo yephrojekthi, sebenzisa ukuhlolwa okulandelayo empandeni yendawo yokugcina usebenzisa i-Python 3.8 noma inguqulo ephezulu:

python src/test_saver.py
python src/test_auditor.py
python src/test_adapter.py
python src/test_order_adapter.py

• test_saver.py: Iqinisekisa ukubalwa kwezinhlanganisela, ukuhlelwa kwazo nokutholwa kwezingibe zokwengeza izinto.
• test_auditor.py: Iqinisekisa izindleko zamakhuphoni angasetshenzisiwe, imikhuba yokusebenzisa nemingcele yezinsuku.
• test_adapter.py: Iqinisekisa ukuguqulwa kwamayunithi nokuhlaziywa kwezimpendulo ze-MCP.
• test_order_adapter.py: Iqinisekisa ukuhlaziywa kwama-oda namakhuphoni, ukuhlungwa kokubuyiselwa kwemali kanye nokubalwa kwenani lamakhuphoni.

Lezi zivivinyo ezine zisebenza ngokuphelele endaweni futhi azidingi ukumiswa kwethokheni ye-MCP. I-README ayibhali umyalo owengeziwe wokufaka amaphakheji esoftware, ngakho kufanele kulandelwe ikhodi yangempela namadokhumenti okuhlanganisa akwindawo yokugcina.

Ukuqonda Isakhiwo Sephrojekthi

Iphrojekthi isebenzisa ungqimba lwe-adapter ukuhlukanisa izimpendulo eziluhlaza ze-MCP kuma-algorithm ebhizinisi. Amamojuli amakhulu yilawa:

• src/saver.py: Iphethe umgudu wokonga wemiyalo eyodwa, ibala izinhlanganisela ezikhethiwe futhi iqhathanise amanani angempela akhokhwayo.
• src/auditor.py: Iphethe ukuhlola kwesikhathi eside, ibala izindleko zamakhuphoni angasetshenzisiwe futhi yakha iphrofayela yokusebenzisa.
• src/mcd_adapter.py: Iphethe ukuhlanganiswa kwezinkambu, ukuhlungwa kokubuyiselwa kwemali, ukubheka kabusha inani lamakhuphoni kanye nokuguqulwa okukodwa kuphela “kusuka kuma-fen kuya kuma-yuan”.
• MCP_INTEGRATION.md: Ibhala i-MCP Server, amathuluzi, umgudu wokuwabiza kanye nenkontileka yokuwabiza ehlolwe ngokoqobo.
• SKILL.md: Ichaza incazelo ye-Skill nomgudu wokusebenza wonke.

Ungqimba lwama-algorithm aluthinti ngokuqondile izimpendulo eziluhlaza ze-MCP, okusiza ukugwema umehluko wezinkambu nokudideka kwamayunithi emali. Kubaluleke kakhulu ukuqaphela ukuthi izixhumi ezahlukene zingase zibe nendlela engafani yokusebenzisa “ama-fen” nama-“yuan”; lokhu kufanele kusingathwe ngokufanayo ngongqimba lwe-adapter.

Amasu Okusebenzisa Athuthukile

Qala Ngokucacisa “Okuzodliwa”, Bese Uqhathanisa Amanani

Intengo ephansi kakhulu ayisho ukuthi inketho ifanelekile. Esicelweni kufanele ubhale ukudla okuyinhloko, izitsha ezihambisanayo, iziphuzo, inani labantu, isabelomali kanye nezidingo ezincane, ukuze uhlelo luqhathanise izinketho ezihlangabezana nezidingo ezifanayo.

Cela Incazelo Yokuthi Ukonga Kuvelaphi

Ungacela ukuthi kuphume “ikhuphoni elisetshenzisiwe, iphakheji okushintshelwe kuyo, izinto ezengeziwe ezifakiwe nokuthi kongiwe malini uma kuqhathaniswa nenketho eyisisekelo”. Ngaleyo ndlela awutholi isiphetho kuphela, kodwa ungahlola nokuthi isincomo siyahambisana yini nezidingo zakho zangempela.

Hlukanisa Inani Elibhaliwe Ekhuphoni Nenzuzo Yangempela

Ikhuphoni elibiza ama-yuan angu-12 ngokomqondo alisho ukuthi i-oda lamanje lizokonga ama-yuan angu-12. Umkhawulo wokusebenzisa, izitolo ezisebenzayo, izinto ezivumelekile kanye nezindleko zokwengeza izinto konke kungashintsha inzuzo yangempela. Kufanele ubuke kokubili inani elibhaliwe ekhuphoni nenani lokugcina elikhokhwayo.

Phatha Kuqala Amakhuphoni Aseduze Nokuphelelwa Yisikhathi Anenani Eliqinisekile

Lapho uhlola isikhathi eside, ungawahlela ngezinsuku ezisele nenani eliqinisekisiwe. Amakhuphoni intengo yawo yoqobo engatholakali kwimenyu kufanele aqhubeke amakwe njengangaziwa noma 0; akufanele uqagele inani ukuze umbiko ubonakale uphelele.

Sebenzisa Idatha Yesitolo Samanje Njalo

Ungaphindi usebenzise amanani avela kwezinye izitolo noma kuma-oda adlule. Imenyu, isimo sokutholakala nobubanzi bezitolo ezisebenza kuzo amakhuphoni kungashintsha; isinqumo ngasinye kufanele sisekelwe emiphumeleni esemthethweni yesitolo samanje ngesikhathi sangempela.

Vikela Imininingwane Yokungena Ku-akhawunti

Kuyanconywa ukuthi uhlale ugcina ithokheni usebenzisa okuguquguqukayo kwemvelo noma ukumiswa okuphephile kweklayenti. Lapho wabelana ngokumiswa esidlangalaleni, gcina kuphela indawo yokubeka efana ne-${MCD_MCP_TOKEN}.

Imingcele Yomklamo Nezinto Okufanele Uziqaphele

• Wonke amanani kufanele asekelwe empendulweni yangempela ye-MCP calculate-price.
• Inani lekhuphoni elingaqinisekiswa kwimenyu liphathwa njengo-0 futhi limakwe; alilinganiselwa.
• Ama-oda abuyiselwe imali awafakwa ezindlekweni zokusebenzisa.
• Iphrojekthi ngeke ikhuthaze ukuthenga izinto ezingadingekile ngenhloso yokusebenzisa ikhuphoni.
• Ukudla, amanani, isimo sokutholakala nobubanzi bokusebenza kwamakhuphoni kusekelwe emiphumeleni yesikhathi sangempela yeziteshi ezisemthethweni zakwaMcDonald's.
• Le phrojekthi iwumsebenzi womncintiswano othuthukiswe ngokuzimela, hhayi umkhiqizo osemthethweni wakwaMcDonald's.
• Imiphumela ingeyokusiza ekuthatheni izinqumo zokusebenzisa kuphela futhi ayiyona iseluleko sezokwelapha, somsoco noma esinye iseluleko sobungcweti.

Isifinyezo

Umsizi Wokonga Imali kaMaiMai uhlanganisa ukulungiselela uku-oda ngesikhathi sangempela nokuhlola ukusetshenziswa kwesikhathi eside: esikhathini esifushane usebenzisa ukubalwa kwentengo yangempela ukukhetha inhlanganisela yamaphakheji, izinto ngazinye namakhuphoni; esikhathini eside usebenzisa ama-oda nesitoko samakhuphoni ukuze uthole ukulahlekelwa okufihlekile njengamanani e-oda ngalinye aphezulu, ukuthenga izinto ngazinye okuphindaphindiwe namakhuphoni aphelelwa yisikhathi.

Ngemva kokumisa ithokheni ye-MCP, ungaqala ngesicelo soku-oda esinesabelomali nezidingo zokudla, bese uzama kancane kancane ukuqhathanisa izinketho zokwengeza izinto nokuhlola ukusetshenziswa kwenyanga. Kubathuthukisi, ukuhlukaniswa kwe-saver.py, auditor.py kanye ne-mcd_adapter.py kunikeza nesibonelo esicacile sokuhlela i-MCP ngemigudu emibili.