Isifundo Sokuqala se-Agent2API: Xhuma Isimo Sokungena se-AI Yedeskithophu Ku-Gateway Ehambisana ne-OpenAI

Yini i-Agent2API

I-Agent2API iyisango lendawo le-API ye-AI elihlanganisa ama-akhawunti asevele angene kumaklayenti amaningi e-AI edeskithophu, bese linikeza amandla okubiza amamodeli ngesixhumi esibonakalayo esihambisana ne-OpenAI. Uma iklayenti lisekela i-base_url eyenziwe ngokwezifiso, lingaxhuma ku-http://127.0.0.1:3065/v1; ngokuvamile alidingi i-API Key yomnikezeli futhi akukho shintsho oludingekayo eklayentini.

Iphrojekthi isekela amaphrothokholi amathathu: Chat, Responses ne-Messages, futhi inikeza isixhumi esibonakalayo sohlu lwamamodeli ku-/v1/models. Isango lisebenza kukhompyutha yakho noma kuseva oyisebenzisayo, kuyilapho umthamo we-akhawunti usala uvela ku-akhawunti ehambisanayo.

Uhlolojikelele lwezici eziyinhloko

• Isixhumi esibonakalayo esihambisana ne-OpenAI: sisekela i-/v1/chat/completions, /v1/responses ne-/v1/messages; i-Messages futhi isekela i-count_tokens.
• Abahlinzeki abaningi: kufakwe abahlinzeki abaningi, okuhlanganisa i-WorkBuddy, 小浣熊, CatPaw, Qoder, Trae nabanye; ungakwazi futhi ukumisa umhlinzeki wangokwezifiso.
• Ukushintshaniswa kwama-akhawunti: ama-akhawunti ahlelwa ngomugqa ngokubaluleka. Uma kuvela i-429, kungashintshwa i-akhawunti; ama-akhawunti asesikhathini sokupholisa ngenxa yomkhawulo awasetshenziswa futhi.
• Ukugcinwa kwemininingwane yokungena: abanye abahlinzeki basekela ukuvuselelwa okuzenzakalelayo kwe-Token, ukuvuselela ngobuningi imininingwane esizophelelwa isikhathi nokuvuselela ikhathalogi yamamodeli.
• Inethiwekhi nokuphepha: kusekelwa i-proxy ehlukile yokuphuma ku-inthanethi ye-akhawunti ngayinye, kanye nokwabiwa kwezimvume kusetshenziswa ama-Gateway Key amaningi.
• Ukuphathwa kokusebenza: kunemibiko yenani lezicelo, izinga lempumelelo, ukusetshenziswa kwama-Token, izinga lokutholwa kwe-cache namamephu okushisa esikhathi eside.
• Imisebenzi ehleliwe: ungaphatha ukungena kwansuku zonke okuzenzakalelayo, ukugcinwa kwemininingwane yokungena nokuvuselelwa kwekhathalogi yamamodeli.

Khetha indlela yokuyisebenzisa

I-Agent2API inezindlela ezintathu. Uhlelo lwedeskithophu lufanele ukusetshenziswa kukhompyutha yomuntu siqu, futhi lusekela i-Windows, macOS ne-Linux, luhlale lusebenza ku-tray; iseva ifanele i-Windows Server noma i-Linux engenayo i-graphical interface; i-Docker ifanele abasebenzisi asebenendawo esebenzisa ama-container. Zonke lezi zindlela azidingi ukufakwa kwe-Node.js ngesikhathi sokusebenza.

• Ideskithophu: qala uhlelo usebenzisa iphakheji yokulifaka; isango lisebenza ngaphakathi kwenqubo yohlelo.
• Iseva: lifake njengesevisi yesistimu, finyelela iphaneli yokuphatha ngesiphequluli, futhi usekele ukuziqalisa lapho ikhompyutha ivulwa.
• Docker: sebenzisa isithombe se-aimodcc/agent2api:latest, esisekela i-amd64 ne-arm64.

Ukufaka nokumisa okokuqala

Indlela yokuqala: Ideskithophu

Landa iphakheji yokufaka efanele isistimu yakho ku-Latest Releases yephrojekthi. Ngemva kokuqala, vula ikhasi elithi “Ama-akhawunti” bese wengeza i-akhawunti eyodwa noma amaningi abahlinzeki. Isango ledeskithophu lilalela ngokuzenzakalelayo ku-port 3065 yasendaweni.

Indlela yesibili: Iseva ye-Linux

tar -xzf agent2api-server-linux-amd64.tar.gz && cd agent2api-server-linux-amd64 && sudo bash install.sh

Ngemva kokufaka, finyelela ku-http://127.0.0.1:3065/ ngesiphequluli. Uma isevisi isebenza emshinini okude, shintsha igama lomshini kuleli kheli ufake i-IP noma isizinda seseva.

Indlela yesithathu: Windows Server

Expand-Archive agent2api-server-windows-amd64.zip -DestinationPath C:\agent2api-pkg
cd C:\agent2api-pkg
.\install-service.ps1

Qalisa le miyalo ku-PowerShell enamalungelo omlawuli. Iskripthi sokufaka sizobhalisa isevisi ohlelweni.

Indlela yesine: Docker

docker run -d --name agent2api --restart unless-stopped -p 3065:3065 -v ./data:/data aimodcc/agent2api:latest

I-./data:/data isetshenziselwa ukugcina ukumiswa nedatha yama-akhawunti. Ngemva kokuqala kwe-container, vula i-http://127.0.0.1:3065/ ukuze uqedele ukuqaliswa.

Ukuqalisa umlawuli ne-Gateway Key

1. Vula iphaneli yokuphatha bese ubhalisa i-akhawunti yomlawuli.
2. Vula ikhasi elithi “Gateway Key” bese udala i-Key ezosetshenziswa amaklayenti ukubiza i-API.
3. Vula ikhasi elithi “Ama-akhawunti”, khetha umhlinzeki nenguqulo, bese uqedela ukungena ngewebhu noma ungenise isimo sokungena ngokulandela inqubo esekhasini.
4. Qinisekisa ukuthi isimo se-akhawunti, isikhathi sokusebenza nebhalansi kujwayelekile.
5. Vula ikhasi elithi “Ukuphathwa kwamamodeli” ukuze uhlole amamodeli atholakalayo nokumaphwa kwamamodeli.

Uma ungayimisi i-Gateway Key, iphrojekthi izenqaba izicelo ze-API ngokuzenzakalelayo. Ungayivezi i-Gateway Key kukhodi yomphakathi, kumalogi noma kumaklayenti angathembekile.

Ukumisa ama-akhawunti namamodeli

Ekhasini lokuphatha ama-akhawunti ungabuka isikhathi sokusebenza se-akhawunti, ibhalansi, umugqa womhlaba wonke nesimo sokupholisa komkhawulo ngemodeli. Ngemva kokwengeza ama-akhawunti amaningi, uhlelo luzowahlela ngokubaluleka; uma i-akhawunti ethile ibanga i-429 noma ingena esimweni sokupholisa, lungashintshela kwenye etholakalayo.

Ikhasi lokuphatha amamodeli likuvumela ukuthi ubuke uhlu lwamamodeli, iziphindaphindi, imininingwane yomongo nobudlelwano bokumaphwa ngomnikezeli. Abahlinzeki abasekela ukudonswa kohlu lwamamodeli ku-inthanethi bazoluvuselela ngezikhathi ezithile; ezinye izinkundla nazo zinamatafula amile akhelwe ngaphakathi njengesipele.

Ucingo lokuqala lwe-API

Kuklayenti elisekela ikheli le-API langokwezifiso, setha i-Base URL ibe:

http://127.0.0.1:3065/v1

Faka i-Gateway Key osanda kuyidala ku-API Key. Ngokwesibonelo, ungasebenzisa i-sk-local njengenani lesibonelo, kodwa ngesikhathi socingo lwangempela sebenzisa i-Key ekhiqizwe kuphaneli.

Qala uhlole isimo sempilo sesango:

curl http://127.0.0.1:3065/health

Bese ubuka uhlu lwamamodeli:

curl http://127.0.0.1:3065/v1/models \
  -H "Authorization: Bearer YOUR_GATEWAY_KEY"

Isibonelo sokubiza isixhumi esibonakalayo se-Chat Completions:

curl http://127.0.0.1:3065/v1/chat/completions \
  -H "Authorization: Bearer YOUR_GATEWAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Sawubona, sicela uzethule."}
    ]
  }'

Shintsha i-YOUR_GATEWAY_KEY ufake i-Gateway Key, bese ushintsha i-YOUR_MODEL_ID ufake i-ID yemodeli ebuyiswe yi-/v1/models. Amaphrothokholi e-Responses ne-Messages nawo asebenzisa ikheli lesango elifanayo; izinkambu eziqondile zesicelo kufanele zilandele ifomethi yeklayenti noma yephrothokholi ehambisanayo.

Ama-akhawunti amaningi, ama-proxy nemisebenzi ehleliwe

Ukushintshaniswa kwama-akhawunti amaningi

Ngemva kokwengeza ama-akhawunti amaningi kumhlinzeki ofanayo, ungasebenzisa umugqa wokubaluleka womhlaba wonke nendlela yokwehlisa umthwalo ye-429 ukuze uthuthukise ukutholakala. Kunconywa ukuthi ubeke ukubaluleka okufanele ngokomthamo we-akhawunti, isikhathi sokusebenza nesimo sokusetshenziswa, futhi uhlole njalo ama-akhawunti asesikhathini sokupholisa.

I-proxy yokuphuma ku-inthanethi

Iphrojekthi isekela ukumisa indawo yokuphuma ehlukile ye-akhawunti ngayinye. Lesi sici sifanele izimo lapho inethiwekhi ephumayo yama-akhawunti ahlukene idinga ukuphathwa ngokwehlukana, kodwa umsebenzisi kufanele azihlolele ukutholakala kwe-proxy, ukuhambisana nemithetho nobungozi bokulawulwa kwe-akhawunti.

Imisebenzi ehleliwe

Ekhasini lokuphatha imisebenzi ungaphatha ndawonye ukungena kwansuku zonke okuzenzakalelayo, ukugcinwa kwemininingwane yokungena nokuvuselelwa kwekhathalogi yamamodeli, futhi usethe izinkinobho zemisebenzi nezikhawu zokwenza. Qaphela ukuthi amakhono asekelwa abahlinzeki abahlukene awafani; ngokwesibonelo, ezinye izinkundla azisekeli ukuvuselelwa kwe-Token, ukungena kwansuku zonke noma ukuhlolwa kwebhalansi.

Ukubuka imibiko nokusetshenziswa

Ikhasi lemibiko likuvumela ukuthi ubuke inani lezicelo, izinga lempumelelo, inani lama-Token, amamodeli athandwayo nokuma kwama-akhawunti, kanye nokusatshalaliswa kokusetshenziswa kwabahlinzeki. Ikhasi lamathrendi libonisa izinga lokutholwa kwe-cache lamahora angu-24, ukusetshenziswa kwama-Token nedatha ehlanganiswe ngosuku.

Uma umhlinzeki esekela ukuhlolwa kwebhalansi noma kokusetshenziswa, ungabuka imininingwane efanele ngqo ekhasini le-akhawunti. Isikhungo sokungena kwansuku zonke sisetshenziselwa ukubuka uhlolojikelele lokungena namaqembu okungena nsuku zonke.

Amacebiso okuthuthukisa nokwakha

Uma udinga ukwakha uhlelo lwedeskithophu kusuka kukhodi yomthombo, izidingo zemvelo zihlanganisa i-Rust 1.77 noma entsha, uchungechunge lwamathuluzi lwe-Tauri 2, kanye ne-Node.js 18.17 noma entsha. I-Node.js isetshenziselwa kuphela ukwakha i-frontend nezikripthi ze-Tauri; uhlelo lwedeskithophu olwakhiwe aluyidingi i-Node.js ngesikhathi sokusebenza.

npm run tauri:install
npm run tauri:dev
npm run tauri:build
npm run build:icon

Phakathi kwakho, i-tauri:dev isetshenziselwa imodi yokuthuthukisa nokulayisha kabusha ngokushesha, kanti i-tauri:build isetshenziselwa ukwakha iphakheji yokufaka yohlelo lwedeskithophu. I-DMG ye-macOS ingakhiwa kuphela ku-macOS; ayikwazi ukwakhiwa ngokuhlanganisa kusuka ku-Windows. Imikhiqizo yokukhishwa esemthethweni ikhiqizwa ukugeleza komsebenzi kwe-CI yephrojekthi.

Ukuphepha Kwezincwadi Zokufakazela Nobubanzi Bokusetshenziswa

Agent2API yenzelwe ukufunda nokuxoxa kuphela. Isebenzisa isimo sokungena se-akhawunti yakho ngendlela yeklayenti elingekho emthethweni, okungase kungahambisani nemigomo yokusetshenziswa yesevisi yomthombo. Izingozi zokunciphiselwa komthamo, ukuhlolwa kokuvikeleka, ukumiswa noma ukuvinjelwa kwe-akhawunti zithwalwa ngumsebenzisi.

Iphrojekthi igcina izincwadi zokufakazela ze-akhawunti ezifana ne-accessToken ne-refreshToken ngendlela yombhalo osobala kumkhombandlela wokumisa okwenziwa kule khompyutha. Indawo ezenzakalelayo yi-~/.agent2api/. Amafayela akhishelwe ngaphandle nawo angase abe nezincwadi zokufakazela ezisobala, ngakho ungathumeli ukumisa kumthombo ogcinwe emphakathini, ungakufaki kusevisi yokugcina amafayela ku-inthanethi, futhi ungabelani ngakho nabanye.

I-README ikwenqabela ngokusobala ukusebenzisa iphrojekthi ngezinjongo zentengiso, ukuyisabalalisa kabusha ukuze uthole inzuzo, ukuphatha ama-akhawunti ngobuningi, ukweqa imikhawulo yokukhokhisa noma yesabelo yesevisi yomthombo, kanye neminye imisebenzi ephula imithetho nemigomo. Izimo zokukhiqiza noma ezentengiso kufanele zisebenzise iziteshi ezisemthethweni kanye ne-API esemthethweni yomthombo. Ngaphambi kokusebenzisa, funda i-LICENSE nesitatimende sokusetshenziswa.

Isiphetho

Agent2API ihlanganisa ama-akhawunti amaklayenti edeskithophu amaningi ibe yisango lendawo elihambisana ne-OpenAI. Ngemva kokuqeda ukufaka, ukwengeza ama-akhawunti nokudala i-Gateway Key, ungasebenzisa i-base_url efanayo ukuxhuma kumathuluzi asekela amakheli e-API enziwa ngokwezifiso. Ukushintshanisa ama-akhawunti amaningi, ukuphathwa kwamamodeli, ama-proxy, imisebenzi ehleliwe nemibiko kulungele izidingo ezengeziwe zokuphatha endaweni. Lapho uyisebenzisa, vikela kahle izincwadi zokufakazela futhi ulandele ngokuqinile imigomo yesevisi yomthombo kanye nesitatimende esengeziwe sokusetshenziswa kwephrojekthi.