اے آئی ٹیوٹوریلز

MCP اور پبلک API کے ذریعے AI کلائنٹس کو Tetrees Agent سے مربوط کریں

میزبان Tetrees Agent MCP کو ترتیب دینے، اس کے عوامی معاہدے کا جائزہ لینے، API CLI استعمال کرنے، کوٹ کیے گئے AI Packs چلانے، مقامی ایکسٹینشنز منسلک کرنے اور اسناد یا نجی صلاحیتوں کو ظاہر کیے بغیر معاون فروخت کنندہ ورک فلو کی پیروی کرنے کا طریقہ سیکھیں۔

31 اگست، 2026تقریباً 20 منٹ کا مطالعہ

MCP اور پبلک API کے ذریعے AI کلائنٹس کو Tetrees Agent سے مربوط کریں

Tetrees Agent EX کیا ہے؟

Tetrees Agent EX ایک عوامی انٹیگریشن کِٹ ہے جو ہوسٹڈ Tetrees Agent MCP سرور اور API کے ذریعے Tetrees AI Packs کے ساتھ کام کرنے کے لیے استعمال ہوتی ہے۔ یہ خریداروں، بلڈرز اور فروخت کنندگان کے لیے کلائنٹس، کنفیگریشن کی مثالیں اور محفوظ توسیعی نمونے فراہم کرتی ہے۔

یہ کِٹ ہوسٹڈ سروس کے اندرونی حصوں کے بجائے ڈویلپرز کے لیے دستیاب معاہدہ فراہم کرتی ہے۔ اس میں Tetrees Agent کی امپلیمنٹیشن کی تفصیلات، نجی Pack انٹیلیجنس، Agent AVCP اسکورنگ کے قواعد، سروس پرامپٹس، موڈریشن سسٹمز، اسٹوریج انفراسٹرکچر یا پروڈکشن کریڈنشلز شامل نہیں ہیں۔

Tetrees کی ہوسٹڈ کارروائیوں کے لیے مقامی GPU درکار نہیں ہوتا۔ ماڈل سے فنڈ کیے گئے رنز کی قیمت عمل درآمد سے پہلے Tetrees Points میں بتائی جاتی ہے۔ Pack حاصل کرنے کے بعد صارفین اپنے مقامی MCP پراسیس کو ایک معاون فراہم کنندہ کی کلید بھی دے سکتے ہیں۔

آپ کیا بنا سکتے ہیں

خریدار اور آپریٹر کے ورک فلو

خریدار اور آپریٹر عوامی معاہدے کو درج ذیل کاموں کے لیے استعمال کر سکتے ہیں:

AI Pack کیٹلاگ تلاش کرنا۔
کسی Pack کی عوامی Agent AVCP رپورٹ اور رَن ٹائم پروفائل کا معائنہ کرنا۔
Tetrees Points خرچ کرنے سے پہلے رَن کی قیمت معلوم کرنا۔
ریاست سے آزاد، Points سے فنڈ کیے گئے پیش نظارہ کے ذریعے Pack آزمانا۔
مفت Pack حاصل کرنا یا Tetrees EX پر معاوضے والا Pack خریدنا۔
اپنے زیرِ ملکیت ناقابلِ تغیر .taip ریلیز ڈاؤن لوڈ کرنا۔

بلڈر کے ورک فلو

بلڈرز کسی آڈیشن شدہ Pack کو صارف کے زیرِ کنٹرول صلاحیتوں سے منسلک کر سکتے ہیں، جبکہ بائنڈنگز اور کریڈنشلز صارف کی مشین پر برقرار رہتے ہیں۔ معاون طریقوں میں ایک مقررہ HTTPS API، ایک نیسٹڈ MCP سرور اور شیل کے بغیر مقامی اسکل شامل ہیں۔

فروخت کنندہ کے ورک فلو

فروخت کنندگان لسٹنگز بنا سکتے ہیں، ناقابلِ تغیر Pack ورژنز اور تصاویر اپ لوڈ کر سکتے ہیں، تیاری کی حالت کا معائنہ کر سکتے ہیں، Agent AVCP چلا سکتے ہیں، نجی مرمتی فیڈبیک کا جائزہ لے سکتے ہیں اور ایسی ریلیز شائع کر سکتے ہیں جو جانچ میں کامیاب ہو۔

ضروریات

ہوسٹڈ MCP انٹیگریشن کنفیگر کرنے سے پہلے درج ذیل تیار کریں:

Node.js 20 یا اس کے بعد کا ورژن۔
Tetrees Account صفحے سے منسوخ کیے جا سکنے والا API ٹوکن۔
اگر آپ ہوسٹڈ MCP سرور استعمال کرنا چاہتے ہیں تو MCP سے مطابقت رکھنے والا کلائنٹ۔
اگر آپ انسپکٹر، CLI، مثالیں یا تصدیقی کمانڈز چلانا چاہتے ہیں تو ریپوزٹری کی مقامی چیک آؤٹ۔

کریڈنشلز کو Packs، پرامپٹس، سورس فائلز اور مشترکہ MCP کنفیگریشنز سے باہر رکھیں۔ اختیاری فراہم کنندہ کی کلیدیں صرف مقامی MCP پراسیس کے ماحول میں موجود ہونی چاہییں۔

ہوسٹڈ MCP سرور کنفیگر کریں

اپنے MCP کلائنٹ کی کنفیگریشن میں درج ذیل سرور تعریف شامل کریں۔ پلیس ہولڈر کو اپنے منسوخ کیے جا سکنے والے Tetrees اکاؤنٹ ٹوکن سے تبدیل کریں۔

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

کنفیگریشن محفوظ کرنے کے بعد MCP کلائنٹ دوبارہ شروع کریں۔ v=2.2.0 لاحقہ npx کو اسی URL کے تحت کیش کیے گئے پرانے ٹار بال کو دوبارہ استعمال کرنے سے روکتا ہے۔ یہ قدر صرف اس وقت تبدیل کریں جب Tetrees نیا MCP معاہدہ شائع کرے۔

محفوظ MCP درخواست آزمائیں

اپنے MCP کلائنٹ سے کہیں کہ وہ کسی Pack کو تلاش کرے اور اس کی قیمت معلوم کرے، بغیر کسی معاوضے والے رَن کو شروع کیے:

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.

یہ درخواست مطلوبہ حفاظتی طریقے پر عمل کرتی ہے: Pack دریافت کریں، اس کی عوامی جانچ اور رَن ٹائم کی ضروریات کا معائنہ کریں، قیمت معلوم کریں، پھر Points خرچ کرنے سے پہلے واضح منظوری کا انتظار کریں۔

عوامی MCP معاہدے کا معائنہ کریں

ریپوزٹری کی ڈائریکٹری سے انحصارات انسٹال کریں، اپنا ٹوکن برآمد کریں اور MCP انسپکٹر چلائیں:

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

انسپکٹر سرکاری ہوسٹڈ MCP پیکیج لانچ کرتا ہے اور اس کے عوامی ٹولز اور وسائل کی فہرست دکھاتا ہے۔ یہ خریدار، بلڈر اور فروخت کنندہ کے متوقع انٹرفیس بھی چیک کرتا ہے۔ معائنہ Points خرچ کیے بغیر یا اکاؤنٹ کی حالت تبدیل کیے بغیر مکمل ہو جاتا ہے۔

عوامی API CLI استعمال کریں

یہ پروجیکٹ جان بوجھ کر خفیہ فائلیں خودکار طور پر لوڈ نہیں کرتا۔ .env.example سے متعلقہ اقدار اپنے شیل کے ماحول میں کاپی کریں؛ CLI سے انہیں خود پڑھنے کی توقع نہ رکھیں۔

export TETREES_TOKEN="txk_..."

صرف پڑھنے والی کمانڈز چلائیں

ایسی کمانڈز سے آغاز کریں جو ماڈل کا کام شروع کیے بغیر سروس اور اپنے اکاؤنٹ کا معائنہ کرتی ہیں:

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 تلاش کرنے کے لیے catalog، اس کے رَن ٹائم پروفائل کا جائزہ لینے کے لیے runtime اور اس کی عوامی Agent AVCP رپورٹ دیکھنے کے لیے report استعمال کریں۔ models اور skills کمانڈز معاون عوامی انتخاب دکھاتی ہیں، جبکہ owned اکاؤنٹ سے وابستہ Packs کی فہرست بناتا ہے۔

چلانے سے پہلے قیمت معلوم کریں

قیمت معلوم کرنے سے ماڈل کی درخواست شروع نہیں ہوتی۔ منتخب Pack اور ماڈل کے شناخت کنندگان فراہم کریں:

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

عمل درآمد کی منظوری دینے سے پہلے درست ماڈل، ٹوکن کی حد، ہوسٹڈ اسکلز، گروتھ چیک پوائنٹ اور بتائی گئی Points وابستگی کا جائزہ لیں۔

Points خرچ کرنے والا رَن شروع کرنے کی تصدیق کریں

رَن شروع کرنے کے لیے درست تصدیقی فلیگ شامل کریں:

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

پوائنٹ سے فنڈ کیے گئے پیش نظارے اسٹیٹ لیس ہوتے ہیں، اور استعمال نہ کیے گئے محفوظ پوائنٹس واپس کر دیے جاتے ہیں۔ CLI خفیہ معلومات سے مشابہ رسپانس فیلڈز کو حذف کرتا ہے اور Tetrees کے ایرر کوڈز، HTTP اسٹیٹس ویلیوز، اور Retry-After کی معلومات رپورٹ کرتا ہے۔ یہ کسی میوٹیشن کو خودکار طور پر دوبارہ کوشش نہیں کرتا۔

خریدار کے عمل کی پیروی کریں

محتاط خریدار کا طریقۂ کار درج ذیل ترتیب سے آگے بڑھتا ہے:

ایسا Pack تلاش کریں جو کام سے مطابقت رکھتا ہو۔
اس کی عوامی Agent AVCP رپورٹ اور رن ٹائم پروفائل کا معائنہ کریں۔
درست ماڈل، ٹوکن کی حد، ہوسٹ کردہ اسکلز، اور گروتھ چیک پوائنٹ کا کوٹ حاصل کریں۔
پوائنٹ سے فنڈ کیے گئے اسٹیٹ لیس پیش نظارے کی منظوری دے کر اسے چلائیں۔
مفت Pack حاصل کریں یا Tetrees EX کے ذریعے ادائیگی والا Pack خریدیں۔
ملکیت کے فوائد، مثلاً ڈاؤن لوڈ، BYOK، محفوظ شدہ گروتھ، اور کلائنٹ ایکسٹینشنز، استعمال کریں۔

ریپوزٹری میں صرف پڑھنے کے لیے دریافت اور کوٹ کی ایک دستاویزی مثال شامل ہے:

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

مختلف استعمال کے معاملے کے لیے Packs تلاش کرنے کی خاطر incident response کی جگہ کوئی دوسرا سرچ فقرہ لکھیں۔

Builder کے طور پر مقامی صلاحیتیں شامل کریں

شائع شدہ Pack ان کلائنٹ ایکسٹینشنز کا اعلان کر سکتا ہے جو Agent AVCP سے گزر چکی ہوں۔ ایکسٹینشن کی اصل بائنڈنگ اور اسناد مقامی رہتی ہیں، اس لیے Tetrees کی ہوسٹنگ کو ان اجازتوں تک رسائی حاصل نہیں ہوتی۔

بائنڈنگ کا نمونہ منتخب کریں

https_api: متعین طریقوں اور ماحول سے حاصل کردہ ہیڈرز کے ساتھ ایک مقررہ HTTPS بنیادی URL سے مربوط ہوں۔
mcp: شیل کے بغیر ایک اندرونی MCP سرور شروع کریں اور اسے متعین ٹول ناموں سے میپ کریں۔
local_skill: بغیر شیل کے ایک چائلڈ پراسیس شروع کریں جو ایک JSON درخواست قبول کرے اور ایک JSON نتیجہ واپس کرے۔

کنفیگریشن کے ابتدائی نقطۂ آغاز کے طور پر examples/extensions/client-extensions.example.json استعمال کریں۔ ریپوزٹری examples/extensions/local-skill/issue-summary.mjs کو local-skill کی مثال اور مکمل builder معاہدے کے لیے docs/BUILDER_GUIDE.md بھی فراہم کرتی ہے۔

رائٹ میتھڈ کے لیے فی کال عین منظوری کا جملہ APPROVE extensionId.methodId درکار ہے۔ عمومی گفتگو میں دی گئی منظوری کو رائٹ انجام دینے کی اجازت نہ سمجھیں۔

Seller کے طور پر Pack شائع کریں

Seller کا راستہ معاہدے پر مبنی ہے۔ پہلے Pack میں تبدیلی کیے بغیر اس کی تیاری اور رپورٹس کا معائنہ کریں:

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

جب نیا ریلیز تیار ہو جائے تو واضح تصدیق کے ساتھ ایک زیادہ بلند ناقابلِ تغیر ورژن اپ لوڈ کریں:

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

اپ لوڈ کے بعد اشاعت کا عمل مکمل کرنے کے لیے ہوسٹ کردہ MCP ٹولز یا Tetrees API حوالہ استعمال کریں:

اپ لوڈ کیے گئے ورژن کو جمع کریں۔
Agent AVCP کوٹ کی درخواست کریں۔
Agent AVCP چلانے سے پہلے درست پوائنٹ مقدار کی تصدیق کریں۔
نجی رپورٹ اور اصلاحی فیڈبیک کا معائنہ کریں۔
صرف اس ڈائجسٹ کو شائع کریں جو جانچ میں کامیاب ہو۔

لسٹنگ تیار کرتے وقت docs/SELLER_GUIDE.md اور examples/seller/pack-listing.example.json سے رجوع کریں۔

حفاظت اور قابلِ اعتماد کارکردگی کے جدید نکات

رازوں کو مشترکہ کنفیگریشن سے الگ رکھیں

Tetrees ٹوکن اور اختیاری فراہم کنندہ کیز کو مقامی پراسیس ماحول میں محفوظ کریں۔ فراہم کنندہ کی اسناد کو کبھی بھی Pack، پرامپٹ، سورس فائل، یا ایسی کنفیگریشن میں شامل نہ کریں جو شیئر کی جا سکتی ہو۔ قابلِ تنسیخ ٹوکنز استعمال کریں تاکہ ضرورت پڑنے پر رسائی واپس لی جا سکے۔

میوٹیشنز کو خودکار طور پر دوبارہ کوشش نہ کریں

ناکام رائٹ آپریشنز کے لیے فیصلہ کرنے سے پہلے رپورٹ کردہ Tetrees ایرر کوڈ، HTTP اسٹیٹس، اور Retry-After ویلیو کا معائنہ کریں۔ خودکار دوبارہ کوششیں اپ لوڈز، خریداریوں، رنز، یا دیگر اسٹیٹ تبدیل کرنے والی کارروائیوں کو دہرا سکتی ہیں۔

ہوسٹ کردہ MCP معاہدے کو دانستہ طور پر پن کریں

پرانے npx کیش اندراجات سے بچنے کے لیے MCP پیکیج URL میں دستاویزی کوئری لاحقہ برقرار رکھیں۔ اسے صرف باضابطہ طور پر شائع شدہ معاہدے کے ورژن کے جواب میں اپ ڈیٹ کریں۔

عوامی حدود کا جائزہ لیں

شراکت دینے سے پہلے SECURITY.md اور docs/PUBLIC_BOUNDARY.md پڑھیں۔ شراکتوں کو صرف دستاویزی عوامی تصدیق شدہ معاہدے کے ساتھ تعامل کرنا چاہیے اور Agent کے اندرونی حصوں، نجی Pack ڈیٹا، اسکورنگ فکسچرز، دستخطی کیز، ڈیٹا بیسز، ایڈمن APIs، یا تعیناتی کے بنیادی ڈھانچے تک رسائی فرض نہیں کرنی چاہیے۔

ریپوزٹری کی تصدیق کریں

تبدیلیاں تقسیم کرنے یا پیکیج تیار کرنے سے پہلے فراہم کردہ چیکس چلائیں:

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

مفید عوامی حوالہ جات

نتیجہ

Tetrees Agent EX، Tetrees AI Packs کو دریافت کرنے، جانچنے، چلانے، وسعت دینے، اور شائع کرنے کے لیے ایک شفاف عوامی معاہدہ فراہم کرتا ہے۔ صرف پڑھنے والے معائنے سے آغاز کریں، ماڈل سے فنڈ کیے گئے کام سے پہلے درست کوٹ طلب کریں، اخراجات اور رائٹس کے لیے واضح تصدیق لازم کریں، اور صارف کی ملکیت والی تمام اسناد اور ایکسٹینشن کی اجازتیں مقامی رکھیں۔