Unganisha Wateja wa AI na Tetrees Agent kwa MCP na API ya Umma

Tetrees Agent EX Ni Nini?

Tetrees Agent EX ni kifurushi cha umma cha ujumuishaji kwa ajili ya kufanya kazi na Tetrees AI Packs kupitia seva na API ya Tetrees Agent MCP inayopangishwa. Hutoa wateja, mifano ya usanidi, na sampuli salama za upanuzi kwa wanunuzi, wajenzi, na wauzaji.

Kifurushi hiki kinaonyesha mkataba unaotumiwa na wasanidi badala ya mambo ya ndani ya huduma inayopangishwa. Hakijumuishi maelezo ya utekelezaji wa Tetrees Agent, akili binafsi ya Pack, kanuni za ukadiriaji za Agent AVCP, vidokezo vya huduma, mifumo ya udhibiti wa maudhui, miundombinu ya hifadhi, au vitambulisho vya uzalishaji.

Uendeshaji unaopangishwa na Tetrees hauhitaji GPU ya ndani. Uendeshaji unaofadhiliwa na modeli hukadiriwa kwa Tetrees Points kabla ya kutekelezwa. Baada ya kupata Pack, watumiaji wanaweza pia kutoa ufunguo wa mtoa huduma anayeungwa mkono kwa mchakato wao wa ndani wa MCP.

Unachoweza Kujenga

Mtiririko wa Kazi wa Mnunuzi na Mwendeshaji

Wanunuzi na waendeshaji wanaweza kutumia mkataba wa umma kufanya yafuatayo:

• Kutafuta katalogi ya AI Packs.
• Kukagua ripoti ya umma ya Agent AVCP na wasifu wa uendeshaji wa Pack.
• Kukadiria uendeshaji kabla ya kutumia Tetrees Points.
• Kujaribu Pack kupitia onyesho la kukagua lisilo na hali, linalofadhiliwa na Points.
• Kupata Pack ya bure au kununua Pack ya kulipia kwenye Tetrees EX.
• Kupakua toleo lisilobadilika la .taip linalomilikiwa.

Mtiririko wa Kazi wa Mjenzi

Wajenzi wanaweza kuunganisha Pack iliyokaguliwa na uwezo unaodhibitiwa na mtumiaji, huku miunganisho na vitambulisho vikibaki kwenye mashine ya mtumiaji. Miundo inayoungwa mkono inajumuisha API ya HTTPS isiyobadilika, seva ya MCP iliyopachikwa, na ujuzi wa ndani usiotumia shell.

Mtiririko wa Kazi wa Muuzaji

Wauzaji wanaweza kuunda matangazo, kupakia matoleo na picha za Pack zisizobadilika, kukagua utayari, kuendesha Agent AVCP, kukagua mrejesho binafsi wa marekebisho, na kuchapisha toleo linalofaulu tathmini.

Mahitaji ya Awali

Kabla ya kusanidi ujumuishaji wa MCP inayopangishwa, andaa yafuatayo:

• Node.js 20 au mpya zaidi.
• Tokeni ya API inayoweza kubatilishwa kutoka ukurasa wa Akaunti ya Tetrees.
• Mteja anayeendana na MCP ikiwa unapanga kutumia seva ya MCP inayopangishwa.
• Nakala ya ndani ya hazina ikiwa unataka kuendesha kikagua, CLI, mifano, au amri za uthibitishaji.

Weka vitambulisho mbali na Packs, vidokezo, faili za chanzo, na usanidi wa MCP unaoshirikiwa. Vifunguo vya hiari vya watoa huduma vinapaswa kuwepo tu katika mazingira ya mchakato wa ndani wa MCP.

Sanidi Seva ya MCP Inayopangishwa

Ongeza ufafanuzi wa seva ufuatao kwenye usanidi wa mteja wako wa MCP. Badilisha kishikilia nafasi kwa tokeni yako ya akaunti ya Tetrees inayoweza kubatilishwa.

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

Anzisha upya mteja wa MCP baada ya kuhifadhi usanidi. Kiambishi v=2.2.0 huzuia npx kutumia tena tarball ya zamani iliyohifadhiwa kwenye akiba chini ya URL hiyo hiyo. Badilisha thamani hii tu Tetrees inapochapisha mkataba mpya wa MCP.

Jaribu Ombi Salama la MCP

Omba mteja wako wa MCP atafute na kukadiria Pack bila kuanzisha uendeshaji wa kulipia:

Tafuta Tetrees AI Packs kwa ajili ya kupanga masuala ya hazina. Onyesha ripoti ya umma ya Agent AVCP
na wasifu wa uendeshaji wa inayolingana vizuri zaidi, kisha kadiria
uendeshaji unaofadhiliwa na Points wa 8k/2k. Usiuendeshe hadi nikubali kiwango cha juu kilichokadiriwa.

Ombi hili linafuata muundo uliokusudiwa wa usalama: gundua Pack, kagua tathmini yake ya umma na mahitaji ya uendeshaji, omba makadirio, na usubiri idhini ya wazi kabla ya kutumia Points.

Kagua Mkataba wa Umma wa MCP

Kutoka kwenye saraka ya hazina, sakinisha vitegemezi, hamisha tokeni yako, na uendeshe kikagua MCP:

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

Kikagua huanzisha kifurushi rasmi cha MCP kinachopangishwa na kuorodhesha zana na rasilimali zake za umma. Pia hukagua violesura vinavyotarajiwa vya mnunuzi, mjenzi, na muuzaji. Ukaguzi hukamilika bila kutumia Points au kubadilisha hali ya akaunti.

Tumia CLI ya API ya Umma

Mradi huu haupakii faili za siri kiotomatiki kwa makusudi. Nakili thamani husika kutoka .env.example hadi kwenye mazingira ya shell yako badala ya kutarajia CLI izisome.

export TETREES_TOKEN="txk_..."

Endesha Amri za Kusoma Pekee

Anza na amri zinazokagua huduma na akaunti yako bila kuanzisha kazi ya modeli:

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>

Tumia catalog kupata Pack, runtime kukagua wasifu wake wa uendeshaji, na report kukagua ripoti yake ya umma ya Agent AVCP. Amri za models na skills zinaonyesha chaguo za umma zinazoungwa mkono, huku owned ikiorodhesha Packs zinazohusishwa na akaunti.

Kadiria Kabla ya Kuendesha

Makadirio hayaanzishi ombi la modeli. Toa Pack na vitambulisho vya modeli vilivyochaguliwa:

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

Kagua modeli halisi, kikomo cha tokeni, ujuzi unaopangishwa, kituo cha ukaguzi wa ukuaji, na ahadi ya Points iliyokadiriwa kabla ya kuidhinisha utekelezaji.

Thibitisha Uendeshaji Unaotumia Points

Ili kuanzisha uendeshaji, jumuisha alama kamili ya uthibitisho:

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

Onyesho la kukagua linalofadhiliwa kwa Pointi halina hali, na Pointi zilizotengwa ambazo hazijatumika hurejeshwa. CLI huondoa sehemu za majibu zinazoonekana kuwa na siri na huripoti misimbo ya hitilafu ya Tetrees, thamani za hali ya HTTP, pamoja na maelezo ya Retry-After. Haijaribu tena kiotomatiki mabadiliko.

Fuata Mtiririko wa Mnunuzi

Mchakato wa tahadhari wa mnunuzi hufuata mpangilio ufuatao:

1. Tafuta Pack inayolingana na kazi.
2. Kagua ripoti yake ya umma ya Agent AVCP na wasifu wa wakati wa utekelezaji.
3. Nukuu kwa usahihi modeli, kikomo cha tokeni, ujuzi uliopangishwa, na kituo cha ukaguzi wa ukuaji.
4. Idhinisha na utekeleze onyesho la kukagua lisilo na hali, linalofadhiliwa kwa Pointi.
5. Pata Pack ya bure au nunua Pack ya kulipia kupitia Tetrees EX.
6. Tumia manufaa ya umiliki kama vile kupakua, BYOK, ukuaji uliohifadhiwa, na viendelezi vya mteja.

Hazina hii inajumuisha mfano wa ugunduzi na nukuu wa kusoma tu ulioandikwa:

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

Badilisha incident response kwa kauli nyingine ya utafutaji ili kuchunguza Pack za matumizi tofauti.

Ongeza Uwezo wa Ndani kama Mjenzi

Pack iliyochapishwa inaweza kutangaza viendelezi vya mteja ambavyo vimepitisha Agent AVCP. Ufungaji na vitambulisho halisi vya kiendelezi hubaki ndani, kwa hiyo upangishaji wa Tetrees haupati ruhusa hizo.

Chagua Muundo wa Ufungaji

• https_api: Unganisha kwenye URL msingi ya HTTPS isiyobadilika yenye mbinu zilizotangazwa na vichwa vinavyotegemea mazingira.
• mcp: Anzisha seva ya MCP iliyopachikwa bila shell na uipangie kwenye majina ya zana yaliyotangazwa.
• local_skill: Anzisha mchakato mtoto usiotumia shell unaopokea ombi moja la JSON na kurudisha matokeo moja ya JSON.

Tumia examples/extensions/client-extensions.example.json kama mahali pa kuanzia usanidi. Hazina pia hutoa examples/extensions/local-skill/issue-summary.mjs kama mfano wa local-skill na docs/BUILDER_GUIDE.md kwa mkataba kamili wa mjenzi.

Mbinu ya kuandika inahitaji kauli halisi ya idhini ya kila ombi APPROVE extensionId.methodId. Usichukulie idhini ya jumla katika mazungumzo kama ruhusa ya kufanya uandishi.

Chapisha Pack kama Muuzaji

Njia ya muuzaji inaongozwa na mkataba. Kwanza kagua utayari na ripoti bila kubadilisha Pack:

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

Toleo jipya linapokuwa tayari, pakia toleo moja lisilobadilika lililo juu zaidi kwa uthibitisho wa wazi:

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

Baada ya kupakia, tumia zana za MCP zilizopangishwa au marejeleo ya API ya Tetrees kukamilisha mchakato wa uchapishaji:

1. Wasilisha toleo lililopakiwa.
2. Omba nukuu ya Agent AVCP.
3. Thibitisha kiasi halisi cha Pointi kabla ya kuendesha Agent AVCP.
4. Kagua ripoti ya faragha na maoni ya marekebisho.
5. Chapisha digest pekee iliyofaulu tathmini.

Rejelea docs/SELLER_GUIDE.md na examples/seller/pack-listing.example.json unapotayarisha tangazo.

Vidokezo vya Juu vya Usalama na Kuegemea

Tenganisha Siri na Usanidi Unaoshirikiwa

Hifadhi tokeni ya Tetrees na funguo za hiari za watoa huduma katika mazingira ya michakato ya ndani. Usipachike kamwe vitambulisho vya mtoa huduma kwenye Pack, kidokezo, faili ya chanzo, au usanidi unaoweza kushirikiwa. Tumia tokeni zinazoweza kubatilishwa ili ufikiaji uweze kuondolewa inapohitajika.

Usijaribu Tena Kiotomatiki Mabadiliko

Kwa shughuli za kuandika zilizoshindwa, kagua msimbo wa hitilafu wa Tetrees ulioripotiwa, hali ya HTTP, na thamani ya Retry-After kabla ya kuamua cha kufanya. Majaribio ya kiotomatiki yanaweza kurudia upakiaji, ununuzi, utekelezaji, au shughuli nyingine zinazobadilisha hali.

Weka Mkataba wa MCP Iliyopangishwa kwa Makusudi

Hifadhi kiambishi tamati cha swali kilichoandikwa kwenye URL ya kifurushi cha MCP ili kuepuka maingizo ya zamani ya akiba ya npx. Isasishe tu kwa kuitikia toleo la mkataba lililochapishwa rasmi.

Kagua Mpaka wa Umma

Kabla ya kuchangia, soma SECURITY.md na docs/PUBLIC_BOUNDARY.md. Michango inapaswa kuingiliana tu na mkataba wa umma uliothibitishwa ulioandikwa, na haipaswi kudhani kuwa ina ufikiaji wa ndani wa Agent, data ya faragha ya Pack, vifaa vya alama, funguo za kusaini, hifadhidata, API za msimamizi, au miundombinu ya uwekaji.

Thibitisha Hazina

Endesha ukaguzi uliotolewa kabla ya kusambaza mabadiliko au kuandaa kifurushi:

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

Marejeleo Muhimu ya Umma

• Mwongozo wa Tetrees MCP
• Nyaraka za API ya Tetrees
• Vipimo vya OpenAPI 3.1
• Mkusanyiko wa Postman
• Katalogi ya AI Pack

Hitimisho

Tetrees Agent EX hutoa mkataba wa umma wenye uwazi wa kugundua, kutathmini, kuendesha, kupanua, na kuchapisha Tetrees AI Packs. Anza kwa ukaguzi wa kusoma tu, omba nukuu halisi kabla ya kazi inayofadhiliwa na modeli, hitaji uthibitisho wa wazi kwa matumizi na uandishi, na weka vitambulisho vyote vinavyomilikiwa na mtumiaji pamoja na ruhusa za viendelezi ndani.