Agent2API bo‘yicha boshlang‘ich qo‘llanma: ish stoli AI tizimidagi avtorizatsiya holatini OpenAI-ga mos shlyuzga ulash

Agent2API nima

Agent2API — bir nechta AI ish stoli mijozlarida allaqachon tizimga kirilgan akkauntlarni birlashtiradigan va yagona OpenAI bilan mos interfeys orqali modellardan foydalanish imkonini beradigan mahalliy AI API shlyuzidir. Mijoz base_url ni sozlashni qo‘llab-quvvatlasa, odatda yuqori darajadagi API Key yoki mijozni o‘zgartirish talab qilinmaydi; u http://127.0.0.1:3065/v1 manziliga ulanishi mumkin.

Loyiha Chat, Responses va Messages protokollarini qo‘llab-quvvatlaydi hamda /v1/models model ro‘yxati interfeysini taqdim etadi. Shlyuz mahalliy kompyuterda yoki siz joylashtirgan serverda ishlaydi, akkaunt limiti esa tegishli akkauntning o‘zidan olinadi.

Asosiy funksiyalar

• OpenAI bilan mos interfeys: /v1/chat/completions, /v1/responses, /v1/messages ni qo‘llab-quvvatlaydi; Messages protokoli count_tokens ni ham qo‘llaydi.
• Bir nechta provayder: WorkBuddy, 小浣熊, CatPaw, Qoder, Trae kabi ko‘plab provayderlar ichki qo‘llab-quvvatlanadi, shuningdek, maxsus provayderlarni sozlash mumkin.
• Akkauntlarni navbat bilan ishlatish: akkauntlar ustuvorlik bo‘yicha navbatga qo‘yiladi; 429 xatosi yuz berganda boshqa akkauntga o‘tish mumkin, limit bo‘yicha kutish davridagi akkauntlar qayta ishlatilmaydi.
• Hisob ma’lumotlarini boshqarish: ayrim provayderlar Token’ni avtomatik yangilash, muddati yaqin hisob ma’lumotlarini ommaviy yangilash va modellar katalogini yangilashni qo‘llab-quvvatlaydi.
• Tarmoq va xavfsizlik: akkauntlar uchun alohida tashqi tarmoq proksisini sozlash va bir nechta shlyuz Key orqali ruxsatlarni taqsimlash mumkin.
• Operatsion boshqaruv: so‘rovlar soni, muvaffaqiyat darajasi, Token sarfi, keshga murojaat qilish darajasi va uzoq muddatli issiqlik xaritasi kabi hisobotlarni taqdim etadi.
• Rejalashtirilgan vazifalar: avtomatik kunlik ro‘yxatdan o‘tish, hisob ma’lumotlarini boshqarish va modellar katalogini yangilash vazifalarini boshqarish mumkin.

Joylashtirish usulini tanlash

Agent2API uch xil shaklda taqdim etiladi. Ish stoli versiyasi shaxsiy kompyuterlar uchun mos bo‘lib, Windows, macOS va Linux tizimlarini qo‘llab-quvvatlaydi hamda tizim treyida doimiy ishlashi mumkin; server versiyasi grafik interfeyssiz Windows Server yoki Linux muhitlari uchun mos; Docker esa konteyner muhitiga ega foydalanuvchilar uchun qulay. Uchala usulda ham ishlash vaqtida Node.js o‘rnatilishi talab qilinmaydi.

• Ish stoli versiyasi: ilovani o‘rnatish paketi orqali ishga tushiradi, shlyuz ilova jarayonida ishlaydi.
• Server versiyasi: tizim xizmati sifatida o‘rnatiladi, boshqaruv paneliga brauzer orqali kiriladi va tizim ishga tushganda avtomatik yoqilishni qo‘llab-quvvatlaydi.
• Docker: aimodcc/agent2api:latest obrazidan foydalanadi, amd64 va arm64 ni qo‘llab-quvvatlaydi.

O‘rnatish va dastlabki sozlash

1-usul: Ish stoli versiyasi

Loyiha Latest Releases sahifasidan tizimingizga mos o‘rnatish paketini yuklab oling. Ishga tushirgach, “Akkauntlar” sahifasiga o‘ting va bir yoki bir nechta provayder akkauntini qo‘shing. Ish stoli versiyasi shlyuzi sukut bo‘yicha mahalliy kompyuterning 3065 portini tinglaydi.

2-usul: Linux serveri

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

O‘rnatish tugagach, brauzer orqali http://127.0.0.1:3065/ manziliga kiring. Xizmat masofaviy xostda ishlayotgan bo‘lsa, manzildagi xost nomini server IP manzili yoki domeniga almashtiring.

3-usul: Windows Server

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

Yuqoridagi buyruqlarni administrator huquqiga ega PowerShell’da bajaring. O‘rnatish skripti xizmatni tizimda ro‘yxatdan o‘tkazadi.

4-usul: Docker

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

Bu yerdagi ./data:/data sozlamalar va akkaunt ma’lumotlarini saqlab qolish uchun ishlatiladi. Konteyner ishga tushgach, boshlang‘ich sozlashni yakunlash uchun http://127.0.0.1:3065/ manzilini oching.

Administrator va shlyuz Key’ni boshlang‘ich sozlash

1. Boshqaruv panelini oching va administrator akkauntini ro‘yxatdan o‘tkazing.
2. “Shlyuz Key” sahifasiga o‘ting va mijoz chaqiruvlari uchun ishlatiladigan Key yarating.
3. “Akkauntlar” sahifasiga o‘ting, provayder va versiyani tanlang, so‘ng sahifadagi jarayon bo‘yicha veb orqali tizimga kiring yoki kirish holatini import qiling.
4. Akkaunt holati, amal qilish muddati va balans ma’lumotlari to‘g‘ri ekanini tekshiring.
5. Mavjud modellar va model moslashtirishlarini tekshirish uchun “Modellarni boshqarish” sahifasiga o‘ting.

Shlyuz Key sozlanmagan bo‘lsa, loyiha sukut bo‘yicha API so‘rovlarini rad etadi. Shlyuz Key’ni ochiq kod, jurnallar yoki ishonchsiz mijozlarda oshkor qilmang.

Akkaunt va modellarni sozlash

Akkauntlarni boshqarish sahifasida akkauntlarning amal qilish muddati, balansi, global navbati va modellar bo‘yicha limit kutish holatini ko‘rish mumkin. Bir nechta akkaunt qo‘shilgach, tizim ularni ustuvorlik bo‘yicha taqsimlaydi; akkauntlardan biri 429 xatosini keltirib chiqarsa yoki kutish holatiga o‘tsa, boshqa mavjud akkauntga o‘tish mumkin.

Modellarni boshqarish sahifasida provayder bo‘yicha modellar ro‘yxati, koeffitsiyent, kontekst ma’lumotlari va moslashtirish munosabatlarini ko‘rish mumkin. Modellar ro‘yxatini onlayn avtomatik yuklashni qo‘llab-quvvatlaydigan provayderlar muntazam yangilanadi; ayrim platformalarda zaxira sifatida ichki statik jadval ham mavjud.

Birinchi API chaqiruvi

Maxsus API manzilini qo‘llab-quvvatlaydigan mijozda Base URL’ni quyidagicha belgilang:

http://127.0.0.1:3065/v1

API Key maydoniga avval yaratilgan shlyuz Key’ni kiriting. Masalan, sk-local dan namuna qiymat sifatida foydalanish mumkin, ammo amaldagi chaqiruvlarda panelda yaratilgan Key ishlatilishi kerak.

Avval shlyuzning sog‘lomlik holatini tekshiring:

curl http://127.0.0.1:3065/health

Keyin modellar ro‘yxatini ko‘ring:

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

Chat Completions interfeysidan foydalanish namunasi:

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": "Salom, o‘zingizni tanishtirib bering."}
    ]
  }'

YOUR_GATEWAY_KEY o‘rniga shlyuz Key’ni, YOUR_MODEL_ID o‘rniga esa /v1/models qaytargan model ID’sini kiriting. Responses va Messages protokollari ham xuddi shu shlyuz manzilidan foydalanadi; aniq so‘rov maydonlari tegishli mijoz yoki protokol formatiga mos bo‘lishi kerak.

Bir nechta akkaunt, proksi va rejalashtirilgan vazifalar

Akkauntlarni navbat bilan ishlatish

Bir provayderga bir nechta akkaunt qo‘shilgach, global ustuvorlik navbati va 429 holatidagi pasaytirish mexanizmi orqali mavjudlikni oshirish mumkin. Akkaunt limiti, amal qilish muddati va foydalanish ssenariysiga qarab oqilona ustuvorliklarni belgilash hamda kutish holatidagi akkauntlarni muntazam tekshirish tavsiya etiladi.

Tashqi tarmoq proksisi

Loyiha har bir akkaunt uchun alohida chiqish nuqtasini sozlashni qo‘llab-quvvatlaydi. Bu funksiya turli akkauntlarning tashqi tarmog‘ini alohida boshqarish zarur bo‘lgan holatlar uchun mos, biroq proksining mavjudligi, muvofiqligi va akkaunt xavfsizligiga oid xatarlarni foydalanuvchi mustaqil baholashi kerak.

Rejalashtirilgan vazifalar

Vazifalarni boshqarish sahifasida avtomatik kunlik ro‘yxatdan o‘tish, hisob ma’lumotlarini boshqarish va modellar katalogini yangilashni markazlashgan holda boshqarish, shuningdek vazifa tugmasi va bajarilish oralig‘ini sozlash mumkin. Turli provayderlar qo‘llab-quvvatlaydigan imkoniyatlar farq qilishini unutmang: masalan, ayrim platformalar Token’ni yangilash, kunlik ro‘yxatdan o‘tish yoki balansni tekshirishni qo‘llab-quvvatlamaydi.

Hisobotlar va foydalanish hajmini ko‘rish

Hisobotlar sahifasida so‘rovlar soni, muvaffaqiyat darajasi, Token umumiy miqdori, mashhur modellar va akkauntlar reytingini, shuningdek provayderlar bo‘yicha foydalanish taqsimotini ko‘rish mumkin. Tendensiyalar sahifasida 24 soatlik keshga murojaat qilish darajasi, Token sarfi va kunlik statistik ma’lumotlar ko‘rsatiladi.

Provayder balans yoki foydalanish hajmini tekshirishni qo‘llab-quvvatlasa, bu ma’lumotlarni akkaunt sahifasida bevosita ko‘rish mumkin. Kunlik ro‘yxatdan o‘tish markazi esa umumiy ko‘rinish va kunlik ro‘yxatdan o‘tish guruhlarini ko‘rish uchun ishlatiladi.

Ishlab chiqish va qurish bo‘yicha eslatmalar

Agar ish stoli versiyasini manba koddan qurish kerak bo‘lsa, muhit talablari Rust 1.77 yoki undan yuqori versiyasi, Tauri 2 vositalar to‘plami hamda Node.js 18.17 yoki undan yuqori versiyasini o‘z ichiga oladi. Node.js faqat frontend qurilishi va Tauri skriptlari uchun ishlatiladi; paketlangan ish stoli versiyasining ishlash muhiti Node.js’ga bog‘liq emas.

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

Bunda tauri:dev ishlab chiqish rejimi va tezkor qayta yuklash uchun, tauri:build esa desktop ilovasi o‘rnatish paketini yaratish uchun ishlatiladi. macOS DMG faylini faqat macOS tizimida yaratish mumkin, Windows tizimidan kross-kompilyatsiya qilib bo‘lmaydi; rasmiy build artefaktlari loyiha CI ish jarayoni tomonidan yaratiladi.

Hisob ma’lumotlari xavfsizligi va foydalanish chegaralari

Agent2API faqat o‘rganish va fikr almashish uchun mo‘ljallangan. U norasmiy mijoz ko‘rinishida sizning shaxsiy hisobingizdagi kirish holatidan qayta foydalanishi mumkin, bu esa yuqori darajadagi xizmat foydalanish shartlariga mos kelmasligi ehtimoli bor. Hisobning tezligi cheklanishi, xavfsizlik nazoratiga tushishi, muzlatilishi yoki bloklanishi kabi xatarlar uchun foydalanuvchining o‘zi javobgar.

Loyiha accessToken, refreshToken kabi hisob ma’lumotlarini mahalliy konfiguratsiya katalogida ochiq matn ko‘rinishida saqlaydi; standart joylashuv: ~/.agent2api/. Eksport qilingan fayllarda ham ochiq matn ko‘rinishidagi hisob ma’lumotlari bo‘lishi mumkin. Shu sababli konfiguratsiyani ochiq repozitoriyga yubormang, bulutli diskka yuklamang yoki boshqalar bilan ulashmang.

README loyihadan tijoriy maqsadlarda foydalanishni, foyda olish uchun qayta tarqatishni, hisoblarni ommaviy boshqarishni, yuqori darajadagi xizmat to‘lovlari yoki kvota cheklovlarini chetlab o‘tishni hamda qonun va qoidalarga zid boshqa faoliyatni qat’iyan taqiqlaydi. Ishlab chiqarish yoki tijoriy holatlarda yuqori darajadagi xizmatning rasmiy kanallari va rasmiy API’dan foydalanish kerak. Foydalanishdan oldin LICENSE va foydalanish bayonotini o‘qing.

Xulosa

Agent2API bir nechta desktop mijozlaridagi hisoblarni yagona mahalliy OpenAI’ga mos shlyuzga birlashtiradi. O‘rnatishni yakunlab, hisoblar qo‘shilib, shlyuz Key’i yaratilgach, yagona base_url orqali maxsus API manzilini qo‘llab-quvvatlaydigan vositalarga ulanish mumkin; ko‘p hisoblar o‘rtasida navbatma-navbat foydalanish, modellarni boshqarish, proksi, rejalashtirilgan vazifalar va hisobotlar esa keyingi mahalliy boshqaruv ehtiyojlari uchun mos keladi. Foydalanish vaqtida hisob ma’lumotlarini ehtiyotkorlik bilan himoya qiling va yuqori darajadagi xizmat shartlari hamda loyihaning qo‘shimcha foydalanish bayonotiga qat’iy rioya qiling.