Yeqa uye kokuyinhloko
Izifundo ze-AI

Isingeniso se-ARTEX: Ukwakha isistimu ezimele yokuhlola ukungena esebenzisa i-AI nokuqonda ukwakheka kokuhlola ngamagrama amabili

Lesi sihloko sichaza amakhono abalulekile e-ARTEX, indlela yokuyifaka, ukulungiselela isizindalwazi ne-LLM, ukuqapha imisebenzi, ukuvumelanisa izimpahla, ukuhlola kabusha ubungozi nokuthuthukisa uhlelo, siphinde sichaze indlela yayo yokuhlola ezimele esekelwe ku-planner, worker kanye nemodeli yamagrafu amabili.

Isingeniso se-ARTEX nokwakheka kokuhlola ngamagrama amabili

Qala ngokuqonda ububanzi bokusetshenziswa

I-ARTEX yenzelwe kuphela ukufunda komuntu siqu, ucwaningo lwekhodi nokuqinisekisa ubuchwepheshe endaweni yendawo ehlukanisiwe. Ngokusho kwesitatimende sephrojekthi, akuvunyelwe ukuyisebenzisa ukuskena, ukuhlola, ukusebenzisa ubuthakathaka noma ukuhlasela noma yiluphi uhlelo oluku-inthanethi, iwebhusayithi, uhlelo oluxhumeke kunethiwekhi noma indawo yokukhiqiza, noma ngabe okuqondiwe kungokwakho noma ugunyaziwe. Ngaphambi kokuqala, qinisekisa ukuthi uyayiqonda futhi uyayilandela ilayisense ye-AGPL-3.0 yephrojekthi, imithetho yokuphepha kwenethiwekhi yendawo okuyo, kanye nemikhawulo yokusetshenziswa nezichasiselo zokuzikhulula ezisendaweni yokugcina ikhodi.

Lesi sihloko sizosebenzisa ukuthunyelwa kwasendaweni nendawo evikelekile ehlukanisiwe njengesisekelo, futhi sichaze indlela yokufaka i-ARTEX, ukumisa i-PostgreSQL ne-LLM, ukubuka imisebenzi kusixhumi esibonakalayo, kanye nokusebenzisa imisebenzi efana nokuvumelanisa ama-asset nokuphinda kuhlolwe ubungozi.

I-ARTEX iwuhlelo lwe-AI olunezisebenzi eziningi, olwakhiwe nge-backend ye-Go ne-frontend ye-Next.js. Iphrojekthi inikeza i-Demo eku-inthanethi yokubuka indlela esebenzisana ngayo. Ekusebenzeni okujwayelekile, i-frontend ingafakwa ku-binary eyodwa kusetshenziswa i-go:embed ye-Go.

Yini engenziwa yi-ARTEX

I-ARTEX yakhelwe ukuzulazula okuzimele, ukuhlela imisebenzi nokulondoloza umlando wenqubo. Uhlelo luqukethe izikrini zedeshibhodi, uhlu lwemisebenzi, inqubo yokusebenzisa iseshini, uchungechunge lokuhlola, okutholakele, ama-asset, imephu yokumbozwa kwama-asset, amarekhodi ethrafikhi, izingxoxo zomuntu oseluphendulweni, ukuphathwa kwama-Agent nokumiswa kwe-LLM.

Ideshibhodi
  • Ukuhlola ngama-agent amaningi: Izindima ezifana ne-goals, planner, worker ne-mainagent zibambisana ukuqhubekisela phambili imisebenzi.
  • Imodeli yamagrafu amabili: Igrafu yama-asset igcina amaqiniso ama-asset abiwe phakathi kwemisebenzi, kanti igrafu yokuhlola igcina imigomo, izinhloso, amaqiniso, izikhumbuzi nokutholakele komsebenzi ngamunye.
  • Ukushintshisana ngolwazi olusezingeni lenqubo: I-worker ingabheka inqubo yokusebenza yamanye ama-worker futhi iphinde isebenzise okubonwe kuwo.
  • Umuntu oseluphendulweni: Ngengxoxo nokuvunywa kokungenelela, umuntu ubamba iqhaza ekubizweni kwamathuluzi nasezinqumweni zemisebenzi ebalulekile.
  • Ukusakazwa komsebenzi ngesikhathi sangempela: I-backend ithumela ulwazi lomsebenzi nge-SSE, ukuze inqubo yokusebenza komsebenzi ibukwe ngokuqhubekayo kusixhumi esibonakalayo.
  • Amarekhodi ethrafikhi: I-proxy ye-MITM erekhodayo igcinela ukusetshenziswa kwamathuluzi ithrafikhi nobufakazi.
  • Ukuvumelanisa ama-asset: Kungavumelaniswa ama-asset afana namadomeyini, ama-subdomain, ama-IP, izimbobo, amasayithi nama-endpoint kusuka ku-ScopeSentry.
  • Ukuphinda kuhlolwe ubungozi: Kungadalwa iseshini ezimele ye-Agent yokuphinda kuhlolwe ubungozi obuvele bukhona, kugcinwe iziphetho, ubufakazi nezixhumanisi zamasession.
Uhlu lwemisebenzi

Faka i-ARTEX

Indlela yokuqala: Sebenzisa iskripthi sokufaka ngokuchofoza okukodwa

Lena yindlela enconywa yiphrojekthi yokufaka. Iskripthi sizohlola noma sifake i-Docker, bese sinikeza ukukhetha phakathi kokusebenzisa yonke into nge-Docker noma ukuhlanganisa nokusebenzisa endaweni.

Ideshibhodi

git clone https://github.com/Autumn-27/ARTEX.git
cd ARTEX
./install.sh

Uma ukhetha i-Docker yonke, kufanele ugcwalise iphasiwedi ye-PostgreSQL, noma ungacindezela u-Enter ukuze iskripthi sikhiqize iphasiwedi engahleliwe. Ngemva kwalokho iskripthi sizobhala ku-.env bese sisebenzisa i-docker compose up -d.

Uma ukhetha ukusebenza endaweni, ungaxhuma kusizindalwazi esivele sikhona noma uvumele i-Docker iqale esisodwa. Iskripthi sizokhiqiza i-config.json, sihlanganise i-binary eyodwa enefrontend bese siqala isevisi.

Ngemva kokufaka, vakashela ku-http://localhost:8787. Ekuvuleni kokuqala, ngena ku-/setup ukuze usethe iphasiwedi yomlawuli.

Indlela yesibili: Sebenzisa i-Docker Compose ngesandla

git clone https://github.com/Autumn-27/ARTEX.git
cd ARTEX
cp .env.example .env
docker compose up -d

Hlela i-.env, okungenani ugcwalise i-POSTGRES_PASSWORD; uma ufuna ukumisa i-Anthropic ngokusebenzisa okuguquguqukayo kwemvelo, ungagcwalisa ne-ANTHROPIC_API_KEY. Isithombe se-container siqukethe amathuluzi ajwayelekile, kanti i-./skills ne-./data kugcinwa ngokufakwa kwe-bind mount.

Ngemva kokuqala, vakashela ku-http://localhost:8787. Uma udinga i-MCP ekude, khetha i-http noma i-sse kuzilungiselelo zesistimu. I-SSE yakudala ivamise ukusebenzisa i-/sse ukwakha ukusakazwa kwemicimbi, bese yamukela izicelo ze-JSON-RPC nge-/message?sessionId=... ebuyisiwe; lungisa unhlokweni wokuqinisekisa njenge-Authorization=Bearer <token>.

Indlela yesithathu: Sebenzisa i-binary ehlanganiswe ngaphambilini

Landa iphakheji ecindezelwe ehambisana nenkundla yakho ku-Releases, bese uyivula. Ngokuvamile izoqukatha i-artex, i-start.sh noma ku-Windows i-start.bat, kanye ne-skills/ ne-config.example.json.

Umsebenzi

cp config.example.json config.json
./start.sh

Sebenzisa i-start.sh noma i-start.bat ukuqala, ungasebenzisi ngokuqondile i-./artex. Iskripthi sokuqala siphethe ukugada inqubo futhi sisekela ukuqaliswa kabusha ngemva kokuvuselelwa kwekhasi ngokuchofoza okukodwa. Uma kudingeka ukuthi isebenze ngemuva, ungasebenzisa:

nohup ./start.sh >artex.log 2>&1 &

Indlela yesine: Hlanganisa kusuka kukhodi yomthombo

Uma udinga ukwakha i-binary eyodwa enefrontend efakiwe, qala ukhiqize amafayela amile e-Next.js, bese uwakopisha kunkomba ye-backend efakiwe.

cd web && npm ci && npm run build:static && cd ..
cp -r web/out server/webui/dist
CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
./start.sh

Qedela ukumiswa okuyisisekelo

Hlela i-PostgreSQL

I-ARTEX incike ku-PostgreSQL. Uma usebenzisa indlela yokusebenza endaweni, ungagcwalisa imininingwane yokuxhumana nesizindalwazi ku-config.json, noma ubhale ngaphezulu kokumiswa nge-ARTEX_PG_DSN.

{
  "database": {
    "host": "127.0.0.1",
    "port": 5432,
    "user": "artex",
    "password": "yourpass",
    "dbname": "artex",
    "sslmode": "disable"
  }
}

Inqubo yokusebenza

Njalo lapho isevisi iqala, izokwenza ngokuphindaphindeka ukuqaliswa kwesakhiwo sesizindalwazi nokuthuthwa kwaso, okuhlanganisa izinguquko ezidingekayo zezinkambu nezinkomba. Ngaphambi kokuthuthukisa, kusanconywa ukwenza ikhophi eyisipele yesizindalwazi nefolda ye-./data.

Hlela i-LLM

Imisebenzi yokuhlola idinga i-LLM. Ungasebenzisa i-API Key ye-Anthropic noma ye-OpenAI, noma uyigcwalise ekhasini elithi “LLM configuration” kusixhumi esibonakalayo.

export ANTHROPIC_API_KEY=sk-...

Ungasetha futhi i-OPENAI_API_KEY. Iphrojekthi iphinde isekele ukulungisa umhlinzeki, imodeli, ikheli ne-proxy kusetshenziswa i-ARTEX_LLM_PROVIDER, i-ARTEX_LLM_MODEL, i-ARTEX_LLM_BASE_URL ne-ARTEX_LLM_PROXY.

Lungisa ukuhambisana namachweba

Inani lama-work agent omsebenzi ngamunye lingalungiswa ku-“System settings”, inani elizenzakalelayo lingu-3. Amapharamitha okuqalisa asekela ukusetha ikheli le-Web/API kanye nechweba le-proxy elirekhoda ithrafikhi:

./start.sh -addr :8787 -proxy :8788

Iskripthi sokuqala sidlulisela amapharamitha ku-artex njengoba enjalo.

Qala ukusebenzisa isixhumi esibonakalayo se-Web

Uchungechunge lokuhlola

1. Ngena bese ubheka ideshibhodi

Ekuvakasheni kokuqala, setha iphasiwedi yomlawuli, bese ungena kudeshibhodi ukuze ubuke ukubuka konke, ukusetshenziswa kwama-Token nokusakazwa komsebenzi. Ideshibhodi ilungele ukuhlola ngokushesha ukuthi uhlelo lusebenza kahle yini nokuthi imisebenzi ikhiqize umsebenzi omusha yini.

2. Bheka imisebenzi nenqubo yokusebenza

Ohlwini lwemisebenzi, khetha umsebenzi oqondiwe ukuze ubuke amasession awo, ukubizwa kwamathuluzi, amarekhodi omsebenzi nochungechunge lokuhlola. Ikhasi lenqubo yokusebenza libonisa izinyathelo zomsebenzi we-agent, kanti uchungechunge lokuhlola lusiza ukuqonda ubudlelwano phakathi kwemigomo, izinhloso, amaqiniso nokutholakele.

Inqubo yokusebenza komsebenziUchungechunge lokuhlola

Lapho usebenzisa lawa makhasi, qinisekisa kuqala izinqubo endaweni yendawo ehlukanisiwe, bese usebenzisa amarekhodi omsebenzi namarekhodi ethrafikhi ukuhlola ukuthi yiziphi izinyathelo ezenziwe yi-agent ngempela.

3. Bheka okutholakele nama-asset

Ikhasi lokutholakele libonisa ndawonye ubungozi noma okunye okutholwe yimisebenzi, kanti ikhasi lama-asset libonisa ulwazi lwama-asset oluqoqwe futhi lwahlanganiswa uhlelo.

Uhlu lokutholakeleUhlu lwama-asset

Imephu yokumbozwa kwama-asset ingabonisa ama-asset angaphakathi kobubanzi ngesakhiwo esiqondiswa amandla, igqamise ama-node ahlolwe, futhi isekele ukugoqa nokwandisa ama-node. Ilungele ukubuka ngokujwayelekile ukuthi yimaphi ama-asset asehloliwe nokuthi yimaphi angakambozwa.

Imephu yokumbozwa kwama-asset

Vumelanisa ama-asset e-ScopeSentry

Uma usuqoqe ama-asset ku-ScopeSentry, ungaxhuma umthombo wedatha ekhasini elithi “Asset synchronization” le-ARTEX ukuze ugweme ukuwaqoqa kabusha.

Okutholakele

  1. Gcwalisa ikheli le-ScopeSentry ne-API Key ukuze uqedele ukuxhuma umthombo wedatha.
  2. Khetha okuqondiwe okudingeka kuvumelaniswe ngokwephrojekthi noma umsebenzi.
  3. Khetha izinhlobo zama-asset, njengamadomeyini, ama-subdomain, ama-IP, izimbobo, amasayithi noma ama-endpoint.
  4. Qalisa ukungenisa ukuze i-ARTEX ihlanganise idatha ngokobubanzi bama-asset benkampani.
  5. Hlola imiphumela yokungenisa kugrafu yama-asset, bese uyinikeza ama-agent ukuze aqhubeke nokuhlola.

Igrafu yama-asset iyinqolobane yomhlaba wonke yamaqiniso ama-asset abiwe phakathi kwemisebenzi. Uhlelo lubala ubudlelwano bomzali nengane kanye nokhiye bokususa okuphindaphindwayo, kanti i-agent ithumela ulwazi lwama-asset olungacutshungulwanga.

Ukuqonda isakhiwo samagrafu amabili se-ARTEX

Igrafu yezimpahla: ichaza ukuthi yiziphi izimpahla ezikhona

Amanodi egrafu yezimpahla afaka phakathi root_domain, subdomain, ip, service, app kanye endpoint. Amadomeyini, ama-subdomain, amasevisi nama-endpoint ahlelwa ngobudlelwano bomzali nengane, futhi ahlotshaniswa nenkampani efanele.

Igrafu yokuhlola: ichaza ukuthi umsebenzi uqhubekiswa kanjani

Igrafu yokuhlola igcinwa ngokuzimela emsebenzini ngamunye. Amanodi afaka phakathi goal, intent, fact, finding kanye hint. Uhlelo lurekhoda uchungechunge lokuqhubeka ngobudlelwano obufana no-spawns, derived_from, yields kanye proves.

La magrafu amabili axhunyaniswa ngama-anchor. Izinhloso, amaqiniso nobuthakathaka bungaxhunywa empahleni ethile, ngakho ungabuka izimpahla ezithintekayo usuka ohlangothini lokuhlola, noma ubuyele empahleni ethile ukuze ubone ukuthi yiziphi izindlela eziyihlolile kulo msebenzi.

Indlela i-planner ne-worker ezisebenzisana ngayo

Injini isebenzisa umjikelezo ovalekile oqhutshwa yimicimbi: ngemva kokushintsha kwegrafu, i-planner iyavuswa, ifunde isimo samanje bese isabalalisa izinhloso; i-worker ithatha inhloso eyodwa, isebenzise amathuluzi ukuyenza bese ibhala izimpahla, amaqiniso noma okutholakele okusha kusizindalwazi; ukubhala lokhu kuphinde kuvuse i-planner.

Impahla

I-planner isabalalisa izinhloso kuphela lapho ithola izindlela ezintsha ezingakambozwa. Ngemva kokuqeda inhloso eyithathile, i-worker iyama, ukuze kugwenywe ukuphindaphindwa okungenamkhawulo ngama-worker ahlukene.

Ochungechungeni lokuhlola olunezinyathelo eziningi nokuncika phakathi kwezinyathelo, i-planner igcina i-todolist eyabelwana ngayo futhi egcinelwe lowo msebenzi. Isinyathelo esilandelayo sisabalaliswa kuphela lapho isinyathelo sangaphambili sesiqediwe futhi iqiniso elihambisanayo selikhona. Le ndlela ivimbela uchungechunge lonke ukuthi luvulwe ngokufana ngesikhathi esisodwa.

Ukusesha inqubo yokusebenza kwamanye ama-worker

Ama-worker alandelayo angasebenzisa search_all_worker_traces(q) ukusesha ngamagama angukhiye phakathi kwezinqubo zokwenziwa kweminye imisebenzi kule task, noma asebenzise list_worker_traces ukubuka imisebenzi eseyenziwe, bese esebenzisa get_worker_trace(intent_id, step_ids=[...]) ukuthola okuqukethwe okuphelele kwezinyathelo ezikhethiwe. Uhlelo luzikhipha ngokuzenzakalelayo izinhloso ze-worker yamanje.

Lokhu kushintshana kolwazi olusezingeni lenqubo kusiza i-agent ukuthi iphinde isebenzise okuphawuliwe okungakabhalwa ngokusemthethweni kuma-fact, kuyilapho igcina umngcele wokuthi i-worker ngayinye yenze kuphela inhloso eyabelwe yona.

Ukurekhodwa kwethrafikhi nokugunyazwa

I-ARTEX inikeza i-proxy yokuqopha ithrafikhi kanye nesango lokugunyaza amathuluzi. Ikhasi lethrafikhi lisetshenziselwa ukubuka amarekhodi akhiqizwe ukusetshenziswa kwamathuluzi, kanti ikhasi lokugunyaza elibambayo lisetshenziselwa ukuphatha imisebenzi edinga ukuqinisekiswa umuntu.

Amarekhodi ethrafikhi

Ngesikhathi sokuqinisekisa ukuphepha, kunconywa ukuthi ubuke ngesikhathi esisodwa iseshini yomsebenzi, ukubizwa kwamathuluzi, ukusakazwa komsebenzi kanye namarekhodi ethrafikhi, ukuze uqinisekise ukuthi ukuziphatha kohlelo kuhambisana nalokho okulindelekile. Ingxoxo yomuntu okhona ku-loop ingasetshenziswa futhi ukwengeza umongo nokubamba iqhaza ekugunyazeni.

Ukwenza ukuhlolwa kabusha kobuthakathaka

Ithebhu ethi “Ukuhlolwa kabusha” emininingwaneni yomsebenzi ikuvumela ukuthi ukhethe ubuthakathaka balo msebenzi ngamakhasi, ubuke iziphetho nobufakazi bangaphambilini, bese uqala ukuhlolwa kabusha ngokuzimela. Uhlu lobuthakathaka, imininingwane yobuthakathaka, ukubuka okuqoqwe ngemisebenzi kanye nokubuka kwezimpahla konke kunikeza indawo yokuqala yokuhlola kabusha.

Igrafu yokumbozwa kwezimpahla

  1. Chofoza “Ukuhlola kabusha” ohlwini lobuthakathaka noma emininingwaneni yobuthakathaka.
  2. Gcwalisa inguqulo yokulungisa, izimo zokuhlola noma imikhawulo njengoba kudingeka.
  3. Qalisa iseshini ezimele ye-Agent yokuhlola kabusha.
  4. Buka inqubo yokuhlola kabusha eseshini, bese ubuka isiphetho nobufakazi ngemva kokuqeda.

Iziphetho zokuhlola kabusha zifaka phakathi “Kusengaphindaphindeka”, “Sekulungisiwe” kanye “Akunakuqinisekiswa”. Uma ukuhlola kabusha kuqedwa ngempumelelo futhi isiphetho sithi “Sekulungisiwe”, uhlelo luzobuyekeza ngokuzenzakalelayo isimo sokuphathwa kobuthakathaka; ukusebenza okuqhubekayo, ukwehluleka, ukumiswa noma ezinye iziphetho ngeke kushintshe ngokuzenzakalelayo isimo sokuqala. Ubufakazi nombiko wokuqala kuyagcinwa.

Uhlelo luhlinzeka kusengaphambili nge-Agent ehlelekayo ethi “Ukuhlolwa kabusha kobuthakathaka” retester. Ingacushwa ekuphathweni kwama-Agent ukuze kulungiswe i-prompt, i-LLM, isabelomali sokuqalisa namathuluzi; uma ingaboshelwanga ku-LLM ethile, isebenzisa ukucushwa komhlaba wonke okusebenzayo. Uma ubuthakathaka obufanayo buhlolwa kabusha, iseshini ekhona iyasetshenziswa futhi; ngemva kokumiswa, ukwehluleka noma ukuqalwa kabusha kwesevisi, ukuhlola kabusha kungaqalwa futhi.

Qaphela ukuthi incazelo yephrojekthi iveza ukuthi umlando wokuhlola kabusha awukafakwa ekuthunyelweni kwemibiko yobuthakathaka noma ephaketheni lokugcinwa komsebenzi, futhi awukaxhunyaniswa ngokuzenzakalelayo nephakethe lethrafikhi. Imodi yokubonisa ikhiqiza amarekhodi okulingisa amakwe ngokucacile kuphela, futhi ayiceli okuqondiwe kwangempela.

Amaphuzu abalulekile okuphakelwa nge-reverse proxy

I-frontend, i-API ne-SSE kunikezwa ngokuzenzakalelayo yichweba elilodwa le-backend, ngakho ngokuvamile kudingeka uvulele umphakathi ichweba le-HTTPS kuphela, bese ugcina i-8787 ye-ARTEX ngaphakathi kwenethiwekhi. Ukusakazwa komsebenzi wesikhathi sangempela kusebenzisa ikheli elivela emthonjeni ofanayo, ngakho ngokuvamile akudingeki usethe NEXT_PUBLIC_SSE_BASE.

Ama-reverse proxy afana ne-Nginx kufanele avale ukubhafa kwe-SSE futhi asethele isikhathi sokulinda sokufunda eside; ngaphandle kwalokho isiphequluli singase sixhume ngempumelelo kodwa singakwazi ukuqhubeka nokwamukela imicimbi yomsebenzi.

location / {
    proxy_pass http://127.0.0.1:8787;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 3600s;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
}

Kudingeka usethe NEXT_PUBLIC_SSE_BASE ngesikhathi sokwakha kuphela lapho i-SSE kufanele isebenzise umthombo ohlukile, njengesizinda esingaphansi esizimele. Le variable igcinwa ephaketheni elimile ngesikhathi se-next build; ukuyisetha ngesikhathi sokusebenza kwesiqukathi ngeke kusebenze.

Ukuthuthukisa nokubuyela emuva

Ithrafikhi

Ukuthuthukiswa kwe-ARTEX kushintsha uhlelo, kodwa kugcina ivolumu yedatha ye-PostgreSQL, ./data kanye ./skills. Kunconywa ukuthi wenze isibuyekezo ngokuchofoza kanye ekhadini elithi “Izinguqulo nezibuyekezo” ekhasini lokucushwa kwesistimu. Inqubo yokubuyekeza ilanda iphakethe lokukhishwa lesikhulumi samanje, iqinisekise SHA256SUMS, yenze ukuhlolwa kwe-smoke nge-binary entsha, bese umbhalo wokuqalisa uqedela ukushintshwa.

Uma ukuqinisekiswa noma ukuhlolwa kwe-smoke kwehluleka, uhlelo olugcinwe okwesikhashana luyalahlwa; uma inguqulo entsha yehluleka ukuqala izikhathi ezintathu zilandelana, ibuyela emuva ngokuzenzakalelayo. Inguqulo yangaphambilini igcinwa njenge-artex.old. Nokho, isakhiwo sesizindalwazi asibuyeli emuva kanye nohlelo, ngakho kusafanele wenze ikhophi eyisipele yesizindalwazi ne-./data ngaphambi kokuthuthukisa.

Ukubuyekeza kuzoqala kabusha isevisi futhi kuphazamise imisebenzi esebenzayo, ngakho kufanele kwenziwe ngesikhathi esingenamsebenzi. Ekuphakeleni kwe-Docker, qaphela nokuthi ukubuyekeza kwekhasi kushintsha uhlelo kuphela, akushintshi uchungechunge lwamathuluzi olusesithombeni. Ukuze uthuthukise isithombe, sebenzisa:

docker compose pull artex
docker compose up -d artex

Ungasebenzisa futhi umbhalo wokubuyekeza okurephozithori:

cd ARTEX
./update.sh

Ukuthuthukiswa nokuhlolwa kwasendaweni

Indawo yokuthuthukisa ingasebenzisa dev.sh ukuqalisa kanyekanye i-backend, i-proxy yethrafikhi kanye neseva yokuthuthukisa ye-Next.js:

./dev.sh

Ichweba le-backend elizenzakalelayo ngu-8787, elommeli wethrafikhi ngu-8788, kanti leseva yokuthuthukisa ye-frontend ngu-5173. Ungazisebenzisa futhi ngokwehlukana:

go run ./cmd/artex
cd web && npm run dev
go test ./...

Uma udinga ukubuka kuqala i-frontend kuphela ngaphandle kokuqala i-backend, sebenzisa:

cd web && NEXT_PUBLIC_MOCK=1 npm run dev

Isifinyezo

I-ARTEX ihlanganisa i-backend ye-Go monolithic, isixhumi esibonakalayo se-Next.js, i-PostgreSQL, ama-agent e-LLM, ukurekhodwa kwethrafikhi, indlela yokugunyaza kanye nokuphathwa kwezimpahla ohlelweni olulodwa. Lapho uqala, ungaqale usebenzise i-Docker noma umbhalo wokufaka ukuze uqedele ukuphakela, bese ulungisa i-PostgreSQL ne-LLM, kamuva uqonde ukuziphatha kohlelo kancane kancane ngemisebenzi, amasesshini, amaketanga okuhlola, igrafu yokumbozwa kwezimpahla namarekhodi ethrafikhi.

Ukuqonda umehluko phakathi kwegrafu yezimpahla negrafu yokuhlola kuyisihluthulelo sokuqonda i-ARTEX: igrafu yezimpahla iphendula ukuthi “yiziphi izimpahla ezikhona”, kanti igrafu yokuhlola iphendula ukuthi “umsebenzi uqhubeka kanjani”. Ngaphambi kwanoma yikuphi ukuhlola, nciphisa ngokuqinile umsebenzi endaweni yasendaweni ehlukanisiwe nasekusetshenzisweni kokufunda okuvunyelwe yiphrojekthi, futhi uthobele isimemezelo sephrojekthi, ilayisensi yomthombo ovulekile kanye nemithetho esebenzayo.