دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

ربط عملاء الذكاء الاصطناعي بوكيل Tetrees باستعمال MCP والواجهة البرمجية العمومية

تعلّم كيفاش تهيّأ MCP ديال وكيل Tetrees المستضاف، وتعاين العقد العمومي ديالو، وتستعمل أداة CLI ديال الواجهة البرمجية، وتشغّل AI Packs المقتبسة، وتربط الإضافات المحلية، وتتبع مسار البائع المدعوم بلا ما تكشف بيانات الدخول ولا القدرات الخاصة.

حوالي 18 دقايق ديال القراية
ربط عملاء الذكاء الاصطناعي بوكيل Tetrees باستعمال MCP والواجهة البرمجية العمومية

شنو هو Tetrees Agent EX؟

Tetrees Agent EX هو كيت عمومي للتكامل مع Tetrees AI Packs عبر خادم MCP وواجهة API المستضافين ديال Tetrees Agent. كيوفّر كلاينتات، أمثلة ديال الإعداد، ونماذج آمنة للتوسيع، للمشترين والبنّاية والبائعين.

تكامل Tetrees Agent AI Pack

هاد الكيت كيكشف العقد الموجّه للمطوّرين، ماشي التفاصيل الداخلية ديال الخدمة المستضافة. ما فيهش تفاصيل تنفيذ Tetrees Agent، ولا الذكاء الخاص ديال Packs، ولا قواعد التنقيط ديال Agent AVCP، ولا برومبتات الخدمة، ولا أنظمة المراقبة، ولا البنية التحتية ديال التخزين، ولا بيانات الاعتماد ديال الإنتاج.

العمليات المستضافة من طرف Tetrees ما كتحتاجش GPU محلي. التشغيلات المموّلة بالنماذج كيتحسب ثمنها بنقاط Tetrees قبل التنفيذ. من بعد ما يشري المستخدم Pack، يقدر حتى يزوّد العملية المحلية ديال MCP بمفتاح ديال مزوّد مدعوم.

شنو تقدر تبني

مسارات عمل المشترين والمشغّلين

المشترين والمشغّلين يقدرو يستعملو العقد العمومي باش:

  • يقلبو فكتالوغ AI Pack.
  • يطلّعو على التقرير العمومي ديال Agent AVCP والبروفايل ديال التشغيل ديال Pack.
  • يحسبو ثمن التشغيل قبل ما يصرفو نقاط Tetrees.
  • يجرّبو Pack عبر معاينة ممولة بالنقاط وبدون حالة.
  • يحصلو على Pack مجاني ولا يشريو Pack مؤدى عليه فـ Tetrees EX.
  • يحمّلو إصدار .taip ثابت وما كيتبدلش ديال Pack اللي مالكينو.

مسارات عمل البنّاية

البنّاية يقدرو يربطو Pack تجرّب مزيان مع القدرات اللي كيتحكّم فيها المستخدم، مع بقاء الربط وبيانات الاعتماد فالجهاز ديال المستخدم. الأنماط المدعومة كتشمل API ثابت عبر HTTPS، وخادم MCP متداخل، ومهارة محلية بلا shell.

مسارات عمل البائعين

البائعين يقدرو ينشئو الإعلانات، يطلّعو إصدارات وصور Packs ثابتة، يتأكدو من الجاهزية، يديرو Agent AVCP، يراجعو ملاحظات الإصلاح الخاصة، وينشرو إصدار داز التقييم.

المتطلبات القبلية

قبل ما تهيّأ تكامل MCP المستضاف، وجد هاد الحوايج:

  • Node.js 20 ولا أحدث.
  • توكن API قابل للإلغاء من صفحة حساب Tetrees.
  • كلاينت متوافق مع 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 من يعاود يستعمل tarball قديم مخزّن بنفس الرابط. بدّل هاد القيمة غير ملي تنشر 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، راجع التقييم العمومي ومتطلبات التشغيل ديالو، طلب حساب الثمن، وتسنى الموافقة الصريحة قبل صرف النقاط.

فحص عقد MCP العمومي

من مجلد المستودع، ثبّت التبعيات، صدّر التوكن ديالك، وشغّل مفتّش MCP:

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

المفتّش كيطلق حزمة MCP الرسمية المستضافة وكيعرض الأدوات والموارد العمومية ديالها. وكيشيّك حتى على الواجهات المتوقعة ديال المشتري والبنّاء والبائع. الفحص كيسالي بلا ما يصرف نقاط ولا يبدّل حالة الحساب.

استعمل CLI ديال API العمومي

المشروع عن قصد ما كيقراش الملفات السرية أوتوماتيكياً. نسخ القيم المناسبة من .env.example لبيئة shell ديالك، وما تعتمدش على أن 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>

استعمل catalog باش تلقى Pack، وruntime باش تراجع بروفايل التشغيل ديالو، وreport باش تفحص التقرير العمومي ديال Agent AVCP. الأوامر models وskills كتعرض الاختيارات العمومية المدعومة، بينما owned كيعرض Packs المرتابطة بالحساب.

حسب الثمن قبل التشغيل

الحساب ما كيبداش طلب ديال النموذج. زوّد معرّفات Pack والنموذج المختارين:

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

راجع النموذج بالضبط، والحد الأقصى ديال التوكنات، والمهارات المستضافة، ونقطة التحقق ديال النمو، والتزام النقاط المحسوب قبل ما توافق على التنفيذ.

أكد تشغيل كيصرف النقاط

باش تبدا التشغيل، دخل علامة التأكيد بالضبط:

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

المعاينات المموّلة بالنقط ما كتحتافظش بالحالة، والنقط المحجوزة اللي ما تستعملاتش كترجع. الـCLI كيحيد الحقول من الردود اللي كتشبه للأسرار، وكيبلّغ على رموز أخطاء Tetrees، وقيم حالة HTTP، ومعلومات Retry-After. ما كيعيدش المحاولة أوتوماتيكياً فعمليات التغيير.

تبع مسار الشاري

سيرورة الشاري الحذر كتمشي بالترتيب التالي:

  1. قلّب على Pack مناسب للمهمة.
  2. عاين التقرير العمومي ديال Agent AVCP والبروفايل ديال وقت التشغيل.
  3. حدّد بالضبط الموديل، والسقف ديال التوكنات، والمهارات المستضافة، ونقطة التحقق ديال النمو.
  4. وافق وشغّل معاينة بلا حالة مموّلة بالنقط.
  5. خد Pack مجاني ولا شري Pack مؤدى عليه عبر Tetrees EX.
  6. استافد من مزايا الملكية بحال التحميل، وBYOK، والنمو المحفوظ، وإضافات الكليان.

المستودع فيه مثال موثّق للاكتشاف والاقتباس غير القابل للكتابة:

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

بدّل incident response بعبارة بحث أخرى باش تستكشف Packs لاستعمال مختلف.

زيد القدرات المحلية بصفتك باني

الـPack المنشور يقدر يعلن على إضافات للكليان دازو Agent AVCP. الربط الفعلي ديال الإضافة وبيانات الولوج كيبقاو محليين، وبهذا الاستضافة ديال Tetrees ما كتورثش هاد الصلاحيات.

اختار نمط الربط

  • https_api: ربط بقاعدة HTTPS ثابتة، مع طرق معلنة وترويسات جاية من البيئة.
  • mcp: شغّل سيرفر MCP متداخل بلا shell وربطو بأسماء الأدوات المعلنة.
  • local_skill: شغّل process فرعي بلا shell كيقبل طلب JSON واحد وكيرجع نتيجة JSON وحدة.

استعمل examples/extensions/client-extensions.example.json كنقطة بداية للإعدادات. والمستودع كيوفّر حتى examples/extensions/local-skill/issue-summary.mjs كمثال على local-skill، وdocs/BUILDER_GUIDE.md للعقد الكامل ديال الباني.

طريقة الكتابة كتحتاج عبارة الموافقة الدقيقة لكل استدعاء: APPROVE extensionId.methodId. ما تعتبرش الموافقة العامة فالمحادثة إذناً لتنفيذ عملية كتابة.

نشر Pack بصفتك بائع

مسار البائع مبني على العقد. فالأول عاين الجاهزية والتقارير بلا ما تبدّل الـ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 المستضافة ولا مرجع API ديال Tetrees باش تكمل مسار النشر:

  1. صيفط الإصدار اللي تحمّل.
  2. طلب اقتباس Agent AVCP.
  3. أكد المبلغ الدقيق ديال النقط قبل تشغيل Agent AVCP.
  4. عاين التقرير الخاص وملاحظات الإصلاح.
  5. نشر غير الـdigest اللي داز التقييم.

رجع لـdocs/SELLER_GUIDE.md وexamples/seller/pack-listing.example.json ملي كتوجد لائحة العرض.

نصائح متقدمة للسلامة والموثوقية

فرّق بين الأسرار والإعدادات المشتركة

خزّن توكن Tetrees ومفاتيح المزوّد الاختيارية فبيئات العمليات المحلية. عمرك تضمّن بيانات اعتماد المزوّد داخل Pack، ولا prompt، ولا ملف مصدر، ولا إعدادات ممكن تتشارك. استعمل توكنات قابلة للسحب باش تقدر توقف الولوج وقت الحاجة.

ما تعاودش المحاولة أوتوماتيكياً فعمليات التغيير

إلى فشلات عمليات الكتابة، عاين رمز خطأ Tetrees، وحالة HTTP، وقيمة Retry-After اللي تبلّغ عليها قبل ما تقرر شنو تدير. إعادة المحاولة الأوتوماتيكية تقدر تعاود التحميل، والشراء، والتشغيل، ولا عمليات أخرى كتبدّل الحالة.

ثبّت عقد MCP المستضاف بوعي

خلي لاحقة الاستعلام الموثّقة فـURL ديال حزمة MCP باش تتفادى إدخالات cache قديمة ديال npx. حدّثها غير استجابةً لإصدار عقد منشور رسمياً.

راجع الحدود العمومية

قبل ما تساهم، قرا SECURITY.md وdocs/PUBLIC_BOUNDARY.md. خاص المساهمات تتفاعل غير مع العقد العمومي الموثّق والمصادق عليه، وما تفترضش الولوج لداخليات Agent، ولا بيانات Pack الخاصة، ولا تجهيزات التنقيط، ولا مفاتيح التوقيع، ولا قواعد البيانات، ولا واجهات admin API، ولا البنية التحتية ديال النشر.

تحقق من المستودع

شغّل الاختبارات الموفّرة قبل توزيع التغييرات ولا تحضير حزمة:

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

مراجع عمومية مفيدة

الخلاصة

Tetrees Agent EX كيوفّر عقداً عمومياً وشفافاً لاكتشاف، وتقييم، وتشغيل، وتوسيع، ونشر Tetrees AI Packs. بدا بالمعاينة غير القابلة للكتابة، وطلب اقتباس دقيق قبل الخدمة المموّلة بالموديل، واشترط تأكيداً صريحاً على الصرف والكتابة، وخلي جميع بيانات اعتماد المستخدم وصلاحيات إضافات الكليان محلية.