AI mijozlarini MCP va ommaviy API yordamida Tetrees Agent’ga ulash

Tetrees Agent EX nima?

Tetrees Agent EX — joylashtirilgan Tetrees Agent MCP serveri va API orqali Tetrees AI Packs bilan ishlash uchun mo‘ljallangan ochiq integratsiya to‘plami. U xaridorlar, yaratuvchilar va sotuvchilar uchun mijozlar, konfiguratsiya namunalari hamda xavfsiz kengaytirish misollarini taqdim etadi.

To‘plam joylashtirilgan xizmatning ichki tuzilmasini emas, dasturchilar uchun mo‘ljallangan shartnomani taqdim etadi. U Tetrees Agent’ni amalga oshirish tafsilotlari, maxfiy Pack ma’lumotlari, Agent AVCP baholash qoidalari, xizmat promptlari, moderatsiya tizimlari, saqlash infratuzilmasi yoki ishlab chiqarish hisob ma’lumotlarini o‘z ichiga olmaydi.

Tetrees tomonidan joylashtirilgan operatsiyalar mahalliy GPU’ni talab qilmaydi. Model mablag‘i hisobidan bajariladigan ishlar ishga tushirishdan oldin Tetrees Points’da hisoblab ko‘rsatiladi. Pack’ni olgandan so‘ng foydalanuvchilar qo‘llab-quvvatlanadigan provayder kalitini mahalliy MCP jarayoniga ham taqdim etishlari mumkin.

Nimalar yaratishingiz mumkin

Xaridor va operator ish jarayonlari

Xaridorlar va operatorlar ochiq shartnomadan quyidagilar uchun foydalanishlari mumkin:

• AI Pack katalogini qidirish.
• Pack’ning ochiq Agent AVCP hisoboti va ish vaqti profilini ko‘rish.
• Tetrees Points sarflashdan oldin ishga tushirish narxini hisoblatish.
• Points hisobidan moliyalashtiriladigan, holat saqlanmaydigan sinov orqali Pack’ni sinab ko‘rish.
• Bepul Pack’ni olish yoki Tetrees EX’da pullik Pack’ni xarid qilish.
• Egalik qilinadigan o‘zgarmas .taip relizini yuklab olish.

Yaratuvchi ish jarayonlari

Yaratuvchilar tekshirilgan Pack’ni foydalanuvchi boshqaradigan imkoniyatlarga ulashlari, shu bilan birga bog‘lamalar va hisob ma’lumotlarini foydalanuvchining kompyuterida saqlashlari mumkin. Qo‘llab-quvvatlanadigan usullarga belgilangan HTTPS API, ichki MCP serveri va shell’dan foydalanmaydigan mahalliy ko‘nikma kiradi.

Sotuvchi ish jarayonlari

Sotuvchilar e’lonlar yaratishi, o‘zgarmas Pack versiyalari va rasmlarini yuklashi, tayyorlikni tekshirishi, Agent AVCP’ni ishga tushirishi, maxfiy tuzatish fikrlarini ko‘rib chiqishi va baholashdan o‘tgan relizni nashr qilishi mumkin.

Talablar

Joylashtirilgan MCP integratsiyasini sozlashdan oldin quyidagilarni tayyorlang:

• Node.js 20 yoki undan yangiroq.
• Tetrees Account sahifasidan olingan, bekor qilinishi mumkin bo‘lgan API tokeni.
• Joylashtirilgan MCP serveridan foydalanmoqchi bo‘lsangiz, MCP bilan mos keluvchi mijoz.
• Inspector, CLI, misollar yoki tekshiruv buyruqlarini ishga tushirmoqchi bo‘lsangiz, repozitoriyning mahalliy nusxasi.

Hisob ma’lumotlarini Pack’lar, promptlar, manba fayllari va umumiy MCP konfiguratsiyalariga kiritmang. Ixtiyoriy provayder kalitlari faqat mahalliy MCP jarayoni muhitida bo‘lishi kerak.

Joylashtirilgan MCP serverini sozlash

Quyidagi server ta’rifini MCP mijozingiz konfiguratsiyasiga qo‘shing. Joylashtiruvchini bekor qilinishi mumkin bo‘lgan Tetrees hisob tokeningiz bilan almashtiring.

{
  "mcpServers": {
    "tetrees-ai": {
      "command": "npx",
      "args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.0"],
      "env": {
        "TETREES_API_URL": "https://ex.tetrees.ai/api",
        "TETREES_TOKEN": "<revocable-account-token>"
      }
    }
  }
}

Konfiguratsiyani saqlaganingizdan so‘ng MCP mijozini qayta ishga tushiring. v=2.2.0 qo‘shimchasi npx dasturining bir xil URL ostida keshlangan eski tarball’dan qayta foydalanishiga yo‘l qo‘ymaydi. Bu qiymatni faqat Tetrees yangiroq MCP shartnomasini nashr qilganda o‘zgartiring.

Xavfsiz MCP so‘rovini sinab ko‘ring

MCP mijozingizdan pullik ishga tushirishni boshlamasdan Pack’ni qidirish va narxini hisoblashni so‘rang:

Search Tetrees AI Packs for repository issue triage. Show the public Agent AVCP
report and runtime profile for the best match, then quote an 8k/2k Point-funded
run. Do not run it until I approve the quoted maximum.

Bu so‘rov mo‘ljallangan xavfsizlik usuliga amal qiladi: Pack’ni topish, uning ochiq baholashi va ish vaqti talablarini ko‘rib chiqish, narxni hisoblatish hamda Points sarflashdan oldin aniq tasdiqni kutish.

Ochiq MCP shartnomasini tekshirish

Repozitoriy katalogidan bog‘liqliklarni o‘rnating, tokeningizni eksport qiling va MCP inspector’ini ishga tushiring:

npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect

Inspector rasmiy joylashtirilgan MCP paketini ishga tushiradi va uning ochiq vositalari hamda resurslarini ko‘rsatadi. Shuningdek, u xaridor, yaratuvchi va sotuvchi interfeyslarining kutilgan qismlarini tekshiradi. Tekshiruv Points sarflamasdan yoki hisob holatini o‘zgartirmasdan yakunlanadi.

Ochiq API CLI’dan foydalanish

Loyiha maxfiy fayllarni avtomatik yuklamaydi. CLI ularni o‘qishini kutish o‘rniga, .env.example faylidagi tegishli qiymatlarni shell muhitiga ko‘chiring.

export TETREES_TOKEN="txk_..."

Faqat o‘qish buyruqlarini ishga tushiring

Model ishini boshlamasdan xizmat va hisobingizni tekshiradigan buyruqlardan boshlang:

npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>

Pack’ni topish uchun catalogdan, uning ish vaqti profilini ko‘rib chiqish uchun runtimedan va ochiq Agent AVCP hisobotini tekshirish uchun reportdan foydalaning. models va skills buyruqlari qo‘llab-quvvatlanadigan ochiq tanlovlarni ko‘rsatadi, owned esa hisob bilan bog‘langan Pack’larni ro‘yxatlaydi.

Ishga tushirishdan oldin narxni hisoblang

Narxni hisoblash model so‘rovini boshlamaydi. Tanlangan Pack va model identifikatorlarini kiriting:

npm run tetrees -- quote <pack-id> <model-id>

Bajarishni tasdiqlashdan oldin aniq model, token chegarasi, joylashtirilgan ko‘nikmalar, o‘sish nazorat nuqtasi va hisoblangan Point majburiyatini ko‘rib chiqing.

Points sarflanadigan ishga tushirishni tasdiqlang

Ishga tushirish uchun aniq tasdiqlash bayrog‘ini kiriting:

npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend

Point tomonidan moliyalashtiriladigan previewlar holatsiz bo‘ladi va foydalanilmagan band qilingan Pointlar qaytariladi. CLI maxfiy ma’lumotlarga o‘xshash javob maydonlarini yashiradi hamda Tetrees xato kodlari, HTTP holat qiymatlari va Retry-After ma’lumotlarini ko‘rsatadi. U mutatsiyani avtomatik ravishda qayta urinib ko‘rmaydi.

Xaridor oqimiga amal qiling

Ehtiyotkor xaridor ish jarayoni quyidagi tartibda amalga oshiriladi:

1. Vazifaga mos Packni qidiring.
2. Uning ochiq Agent AVCP hisoboti va ish vaqti profilini ko‘rib chiqing.
3. Aniq model, token chegarasi, joylashtirilgan ko‘nikmalar va o‘sish nazorat nuqtasini ko‘rsating.
4. Point tomonidan moliyalashtiriladigan holatsiz previewni tasdiqlang va ishga tushiring.
5. Bepul Packni oling yoki Tetrees EX orqali pulli Packni sotib oling.
6. Yuklab olish, BYOK, saqlangan o‘sish va mijoz kengaytmalari kabi egalik imtiyozlaridan foydalaning.

Repozitoriyda faqat o‘qish uchun mo‘ljallangan qidiruv va narx taklifi namunasi hujjatlashtirilgan:

node examples/buyer/discover-and-quote.mjs "incident response"

Boshqa foydalanish holati uchun Packlarni o‘rganish maqsadida incident response o‘rniga boshqa qidiruv iborasini kiriting.

Quruvchi sifatida mahalliy imkoniyatlarni qo‘shing

Nashr etilgan Pack Agent AVCPdan o‘tgan mijoz kengaytmalarini e’lon qilishi mumkin. Kengaytmaning amaldagi bog‘lanishi va hisob ma’lumotlari mahalliy bo‘lib qoladi, shuning uchun Tetrees hosting bu ruxsatlarni meros qilib olmaydi.

Bog‘lash usulini tanlang

• https_api: E’lon qilingan metodlar va muhitga asoslangan sarlavhalar bilan belgilangan HTTPS bazaviy URL manziliga ulaning.
• mcp: Shellsiz ichki MCP serverini ishga tushiring va uni e’lon qilingan vosita nomlariga xaritalang.
• local_skill: Bitta JSON so‘rovini qabul qilib, bitta JSON natijasini qaytaradigan shellsiz quyi jarayonni ishga tushiring.

Konfiguratsiyani boshlash uchun examples/extensions/client-extensions.example.json faylidan foydalaning. Repozitoriyda mahalliy ko‘nikma namunasi sifatida examples/extensions/local-skill/issue-summary.mjs hamda to‘liq quruvchi shartnomasi uchun docs/BUILDER_GUIDE.md taqdim etilgan.

Yozish metodi har bir chaqiruv uchun aniq APPROVE extensionId.methodId tasdiqlash iborasini talab qiladi. Umumiy suhbatdagi tasdiqni yozish amalini bajarish uchun ruxsat deb qabul qilmang.

Sotuvchi sifatida Packni nashr eting

Sotuvchi yo‘li shartnoma asosida boshqariladi. Avval Packni o‘zgartirmasdan tayyorgarlik holati va hisobotlarni tekshiring:

node examples/seller/check-readiness.mjs <pack-id>

Yangi reliz tayyor bo‘lganda, aniq tasdiq bilan o‘zgarmas yuqoriroq versiyadan bittasini yuklang:

node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload

Yuklagandan so‘ng, nashr etish jarayonini yakunlash uchun joylashtirilgan MCP vositalari yoki Tetrees API ma’lumotnomasidan foydalaning:

1. Yuklangan versiyani yuboring.
2. Agent AVCP narx taklifini so‘rang.
3. Agent AVCPni ishga tushirishdan oldin aniq Point miqdorini tasdiqlang.
4. Maxfiy hisobot va tuzatish bo‘yicha fikr-mulohazalarni ko‘rib chiqing.
5. Faqat baholashdan o‘tgan dayjestni nashr eting.

Listingni tayyorlashda docs/SELLER_GUIDE.md va examples/seller/pack-listing.example.json fayllariga murojaat qiling.

Kengaytirilgan xavfsizlik va ishonchlilik bo‘yicha maslahatlar

Maxfiy ma’lumotlarni umumiy konfiguratsiyadan ajrating

Tetrees tokeni va ixtiyoriy provayder kalitlarini mahalliy jarayon muhitida saqlang. Provayder hisob ma’lumotlarini Pack, prompt, manba fayli yoki ulashilishi mumkin bo‘lgan konfiguratsiyaga hech qachon joylashtirmang. Zarur bo‘lganda kirishni bekor qilish uchun qaytarib olinadigan tokenlardan foydalaning.

Mutatsiyalarni avtomatik qayta urinmang

Muvaffaqiyatsiz yozish amallari uchun nima qilishni hal qilishdan oldin bildirilgan Tetrees xato kodi, HTTP holati va Retry-After qiymatini tekshiring. Avtomatik qayta urinishlar yuklash, xarid, ishga tushirish yoki holatni o‘zgartiruvchi boshqa amallarni takrorlashi mumkin.

Joylashtirilgan MCP shartnomasini ataylab mahkamlang

Eskirgan npx kesh yozuvlarining oldini olish uchun MCP paketi URL manzilidagi hujjatlashtirilgan so‘rov qo‘shimchasini saqlab qoling. Uni faqat rasman nashr etilgan shartnoma versiyasiga javoban yangilang.

Ochiq chegarani ko‘rib chiqing

Hissa qo‘shishdan oldin SECURITY.md va docs/PUBLIC_BOUNDARY.md fayllarini o‘qing. Hissalar faqat hujjatlashtirilgan ochiq autentifikatsiyalangan shartnoma bilan ishlashi kerak; Agent ichki qismlari, maxfiy Pack ma’lumotlari, baholash moslamalari, imzolash kalitlari, ma’lumotlar bazalari, administrator API’lari yoki joylashtirish infratuzilmasiga kirish mavjud deb hisoblamang.

Repozitoriyni tekshiring

O‘zgarishlarni tarqatish yoki paket tayyorlashdan oldin berilgan tekshiruvlarni ishga tushiring:

npm test
npm run check:public-boundary
npm pack --dry-run

Foydali ochiq manbalar

• Tetrees MCP qo‘llanmasi
• Tetrees API hujjatlari
• OpenAPI 3.1 spetsifikatsiyasi
• Postman to‘plami
• AI Pack katalogi

Xulosa

Tetrees Agent EX Tetrees AI Packlarini topish, baholash, ishga tushirish, kengaytirish va nashr etish uchun shaffof ochiq shartnomani taqdim etadi. Avval faqat o‘qish uchun tekshiruvdan boshlang, model tomonidan moliyalashtiriladigan ishni bajarishdan oldin aniq narx taklifini so‘rang, mablag‘ sarflash va yozish amallari uchun aniq tasdiqni talab qiling hamda foydalanuvchiga tegishli barcha hisob ma’lumotlari va kengaytma ruxsatlarini mahalliy saqlang.