Xhuma Amaklayenti e-AI ku-Tetrees Agent nge-MCP kanye ne-Public API

Yini i-Tetrees Agent EX?

I-Tetrees Agent EX iyikhithi yokuhlanganisa evulekile yokusebenza ne-Tetrees AI Packs kusetshenziswa iseva ye-Tetrees Agent MCP ne-API esingathwe. Ihlinzeka ngamaklayenti, izibonelo zokumisa, nezibonelo zezandiso eziphephile kubathengi, abakhi, nabathengisi.

Le khithi iveza isivumelwano esibhekiswe kubathuthukisi, hhayi imininingwane yangaphakathi yesevisi esingathwe. Ayifaki imininingwane yokuqaliswa kwe-Tetrees Agent, ubuhlakani obuyimfihlo be-Pack, imithetho yokukala ye-Agent AVCP, imiyalelo yesevisi, amasistimu okulinganisa okuqukethwe, ingqalasizinda yokugcina, noma iziqinisekiso zokukhiqiza.

Imisebenzi esingathwe yi-Tetrees ayidingi i-GPU yasendaweni. Ukusetshenziswa okuxhaswe ngamamodeli kunikezwa isilinganiso ngama-Tetrees Points ngaphambi kokuqaliswa. Ngemva kokuthola i-Pack, abasebenzisi bangaphinde banikeze ukhiye womhlinzeki osekelwayo kwinqubo yabo yasendaweni ye-MCP.

Ongakha

Ukugeleza Komsebenzi Komthengi Nokuqhuba

Abathengi nabaqhubi bangasebenzisa isivumelwano esivulekile ukuze:

• Baseshe ikhathalogi yama-AI Pack.
• Babuke umbiko womphakathi we-Agent AVCP kanye nephrofayela yesikhathi sokusebenza ye-Pack.
• Bathole isilinganiso sokuqalisa ngaphambi kokusebenzisa ama-Tetrees Points.
• Bahlole i-Pack ngokubuka kuqala okungenasimo, okuxhaswe ngama-Points.
• Bathole i-Pack yamahhala noma bathenge i-Pack ekhokhelwayo ku-Tetrees EX.
• Badawunilode ukukhishwa okungaguquki kwe-.taip abanikazi bayo.

Ukugeleza Komsebenzi Komakhi

Abakhi bangaxhuma i-Pack ehloliwe kumakhono alawulwa umsebenzisi, kuyilapho ukuxhumeka nezimpawu zokungena kugcinwa emshinini womsebenzisi. Amaphethini asekelwayo ahlanganisa i-HTTPS API engaguquki, iseva ye-MCP eshumekiwe, kanye nekhono lasendaweni elingasebenzisi i-shell.

Ukugeleza Komsebenzi Komthengisi

Abathengisi bangakha izinhlu, balayishe izinguqulo nezithombe ze-Pack ezingaguquki, bahlole ukulungela, baqhube i-Agent AVCP, babuyekeze impendulo yangasese yokulungisa, futhi bashicilele ukukhishwa okuphumelela ukuhlolwa.

Izidingo Zokuqala

Ngaphambi kokumisa ukuhlanganiswa kwe-MCP esingathwe, lungisa okulandelayo:

• Node.js 20 noma entsha.
• Ithokheni ye-API engahoxiswa evela ekhasini le-Akhawunti ye-Tetrees.
• Ikhasimende elihambisana ne-MCP uma uhlela ukusebenzisa iseva ye-MCP esingathwe.
• Ikhophi yendawo yendawo yokugcina ikhodi uma ufuna ukusebenzisa umhloli, i-CLI, izibonelo, noma imiyalo yokuqinisekisa.

Gcina iziqinisekiso zikude kuma-Pack, emiyalweni, kumafayela ekhodi, nasekulungiselelweni okwabiwe kwe-MCP. Okhiye bomhlinzeki abazikhethela kufanele babe khona kuphela endaweni yenqubo yasendaweni ye-MCP.

Misa Iseva Ye-MCP Esingathwe

Faka le ncazelo yeseva elandelayo ekulungiselelweni kweklayenti lakho le-MCP. Faka esikhundleni sombambiqhaza ithokheni ye-akhawunti yakho ye-Tetrees engahoxiswa.

{
  "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>"
      }
    }
  }
}

Qalisa kabusha iklayenti le-MCP ngemva kokulondoloza ukulungiselelwa. Isijobelelo esithi v=2.2.0 sivimbela i-npx ekusebenziseni kabusha i-tarball endala egcinwe ngaphansi kwe-URL efanayo. Shintsha leli nani kuphela lapho i-Tetrees ishicilela isivumelwano esisha se-MCP.

Zama Isicelo Se-MCP Esiphephile

Celisa iklayenti lakho le-MCP ukuthi liseshe futhi lithole isilinganiso se-Pack ngaphandle kokuqala ukusebenzisa okukhokhelwayo:

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.

Lesi sicelo silandela iphethini yokuphepha ehlosiwe: thola i-Pack, hlola ukuhlolwa kwayo komphakathi nezidingo zesikhathi sokusebenza, cela isilinganiso, bese ulinda imvume ecacile ngaphambi kokusebenzisa ama-Points.

Hlola Isivumelwano Somphakathi Se-MCP

Kusuka enkombeni yendawo yokugcina ikhodi, faka okuncikile, uthumele ithokheni yakho, bese uqalisa umhloli we-MCP:

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

Umhloli uqalisa iphakheji esemthethweni ye-MCP esingathwe futhi ubala amathuluzi nezinsiza zayo zomphakathi. Uphinde ahlole izindawo ezilindelekile zomthengi, umakhi, nomthengisi. Ukuhlola kuyaphela ngaphandle kokusebenzisa ama-Points noma ukushintsha isimo se-akhawunti.

Sebenzisa i-CLI Ye-API Yomphakathi

Le phrojekthi ayilayishi ngokuzenzakalelayo amafayela ayimfihlo. Kopisha amanani afanele asuka ku-.env.example uwafake endaweni ye-shell yakho, kunokulindela ukuthi i-CLI iwafunde.

export TETREES_TOKEN="txk_..."

Qalisa Imiyalo Yokufunda Kuphela

Qala ngemiyalo ehlola isevisi ne-akhawunti yakho ngaphandle kokuqala umsebenzi wemodeli:

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>

Sebenzisa i-catalog ukuthola i-Pack, i-runtime ukubuyekeza iphrofayela yayo yesikhathi sokusebenza, kanye ne-report ukuhlola umbiko wayo womphakathi we-Agent AVCP. Imiyalo ye-models ne-skills iveza izinketho zomphakathi ezisekelwayo, kuyilapho i-owned ibala ama-Pack ahlotshaniswa ne-akhawunti.

Thola Isilinganiso Ngaphambi Kokuqalisa

Isilinganiso asiqali isicelo semodeli. Nikeza i-Pack ekhethiwe nezihlonzi zemodeli:

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

Buyekeza imodeli ngqo, umkhawulo wamathokheni, amakhono asingathwe, indawo yokuhlola yokukhula, kanye nokuzibophezela kwama-Points okunikeziwe ngaphambi kokuvumela ukuqaliswa.

Qinisekisa Ukuqalisa Okusebenzisa Ama-Points

Ukuqala ukuqalisa, faka ifulegi lokuqinisekisa eliqondile:

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

Iziboniso ezixhaswe ngama-Point azigcini isimo, futhi ama-Point abekelwe eceleni angasetshenziswanga ayabuyiselwa. I-CLI isusa izinkambu zezimpendulo ezibukeka njengezimfihlo futhi ibike amakhodi amaphutha e-Tetrees, amanani esimo se-HTTP, kanye nolwazi lwe-Retry-After. Ayizami ngokuzenzakalelayo futhi umsebenzi wokushintsha isimo.

Landela Ukuhamba Komthengi

Ukuhamba komthengi oqaphile kuqhubeka ngale ndlela elandelayo:

1. Sesha i-Pack ehambisana nomsebenzi.
2. Hlola umbiko wayo womphakathi we-Agent AVCP kanye nephrofayela yesikhathi sokusebenza.
3. Chaza imodeli ngqo, umkhawulo wamathokheni, amakhono asingathiwe, kanye nendawo yokuhlola ukukhula.
4. Vuma futhi usebenzise isiboniso esingenasimo esixhaswe ngama-Point.
5. Thola i-Pack yamahhala noma uthenge i-Pack ekhokhelwayo nge-Tetrees EX.
6. Sebenzisa izinzuzo zobunikazi ezifana nokulanda, i-BYOK, ukukhula okulondoloziwe, nezandiso zeklayenti.

Inqolobane ihlanganisa isibonelo esibhaliwe sokuthola ulwazi nokucaphuna esifundwayo kuphela:

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

Faka esikhundleni sika-incident response omunye umusho wokusesha ukuze uhlole ama-Pack asetshenziswa kwenye injongo.

Engeza Amakhono Endawo Njengomakhi

I-Pack eshicilelwe ingamemezela izandiso zeklayenti eziphumelele i-Agent AVCP. Ukuxhumana kwangempela kwezandiso kanye nemininingwane yokuqinisekisa kuhlala endaweni, ngakho ukusingathwa yi-Tetrees akuwatholi lawo malungelo.

Khetha Iphethini Yokuxhuma

• https_api: Xhuma ku-URL eyisisekelo ye-HTTPS engaguquki usebenzisa izindlela ezimenyezelwe namakhanda asekelwa imvelo.
• mcp: Qalisa iseva ye-MCP esidleke ngaphandle kwe-shell bese uyifanisa namagama amathuluzi amenyezelwe.
• local_skill: Qalisa inqubo yengane engena-shell eyamukela isicelo esisodwa se-JSON futhi ibuyise umphumela owodwa we-JSON.

Sebenzisa examples/extensions/client-extensions.example.json njengendawo yokuqala yokulungiselela. Inqolobane iphinde inikeze examples/extensions/local-skill/issue-summary.mjs njengesibonelo se-local-skill kanye no-docs/BUILDER_GUIDE.md wenkontileka ephelele yomakhi.

Indlela yokubhala idinga umusho oqondile wokuvuma osetshenziswa ngakunye: APPROVE extensionId.methodId. Ungaphathi ukuvuma okuvamile kwengxoxo njengemvume yokwenza ukubhala.

Shicilela I-Pack Njengomthengisi

Indlela yomthengisi iqhutshwa yinkontileka. Qala ngokuhlola ukulungela nemibiko ngaphandle kokushintsha i-Pack:

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

Uma ukukhishwa okusha sekulungile, layisha inguqulo eyodwa ephakeme nengaguquki ngesiqinisekiso esicacile:

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

Ngemva kokulayisha, sebenzisa amathuluzi e-MCP asingathiwe noma ireferensi ye-Tetrees API ukuqedela ukuhamba kokushicilela:

1. Thumela inguqulo elayishiwe.
2. Cela isicaphuno se-Agent AVCP.
3. Qinisekisa inani eliqondile lama-Point ngaphambi kokuqalisa i-Agent AVCP.
4. Hlola umbiko oyimfihlo kanye nempendulo yokulungisa.
5. Shicilela kuphela i-digest ephumelele ukuhlolwa.

Bheka docs/SELLER_GUIDE.md kanye no-examples/seller/pack-listing.example.json lapho ulungiselela uhlu.

Amathiphu Athuthukile Okuphepha Nokwethembeka

Hlukanisa Izimfihlo Ekulungiseleleni Okwabelwana Ngakho

Gcina ithokheni ye-Tetrees kanye nokhiye bomhlinzeki ongazikhethela ezindaweni zemvelo zenqubo yasendaweni. Ungalokothi ufake imininingwane yokuqinisekisa yomhlinzeki ku-Pack, ku-prompt, kufayela lomthombo, noma ekulungiseleleni okungabiwa. Sebenzisa amathokheni angahoxiswa ukuze ukufinyelela kususwe lapho kudingeka.

Ungazami Ngokuzenzakalelayo Futhi Imisebenzi Yokushintsha Isimo

Emisebenzini yokubhala ehlulekile, hlola ikhodi yephutha ye-Tetrees ebikiwe, isimo se-HTTP, kanye nenani le-Retry-After ngaphambi kokunquma okufanele kwenziwe. Ukuzama ngokuzenzakalelayo kungaphinda ukulayisha, ukuthenga, ukusebenzisa, noma eminye imisebenzi eshintsha isimo.

Qinisa Inkontileka Ye-MCP Esingathiwe Ngokuqaphela

Gcina isijobelelo sombuzo esibhaliwe ku-URL yephakheji ye-MCP ukuze ugweme okufakiwe okuphelelwe yisikhathi kunqolobane ye-npx. Sibuyekeze kuphela ngenxa yenguqulo yenkontileka eshicilelwe ngokusemthethweni.

Buyekeza Umngcele Womphakathi

Ngaphambi kokunikela, funda SECURITY.md kanye no-docs/PUBLIC_BOUNDARY.md. Iminikelo kufanele ixhumane kuphela nenkontileka yomphakathi ebhaliwe, eqinisekisiwe, futhi akufanele icabange ukufinyelela ezingxenyeni zangaphakathi ze-Agent, kudatha eyimfihlo ye-Pack, ezinsizeni zokulinganisa, kokhiye bokusayina, kumadathabheyisi, kuma-API omlawuli, noma kungqalasizinda yokusatshalaliswa.

Qinisekisa Inqolobane

Qalisa ukuhlola okunikeziwe ngaphambi kokusabalalisa izinguquko noma ukulungiselela iphakheji:

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

Izinkomba Zomphakathi Eziwusizo

• Umhlahlandlela we-Tetrees MCP
• Imibhalo ye-Tetrees API
• Ukucaciswa kwe-OpenAPI 3.1
• Iqoqo le-Postman
• Ikhathalogi yama-AI Pack

Isiphetho

I-Tetrees Agent EX inikeza inkontileka yomphakathi esobala yokuthola, ukuhlola, ukusebenzisa, ukunweba, nokushicilela ama-Tetrees AI Pack. Qala ngokuhlola okufundwayo kuphela, cela isicaphuno esiqondile ngaphambi komsebenzi oxhaswe ngemodeli, funa isiqinisekiso esicacile sokusebenzisa imali nokubhala, futhi ugcine yonke imininingwane yokuqinisekisa ephethwe ngumsebenzisi kanye nezimvume zezandiso endaweni.