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 খরচ করার আগে কোনো রান-এর কোট নিতে পারেন।
- স্টেটলেস Point-অর্থায়িত প্রিভিউয়ের মাধ্যমে কোনো Pack পরীক্ষা করতে পারেন।
- বিনামূল্যের Pack সংগ্রহ করতে বা Tetrees EX-এ পেইড Pack কিনতে পারেন।
- নিজস্ব অপরিবর্তনীয়
.taipরিলিজ ডাউনলোড করতে পারেন।
নির্মাতা ওয়ার্কফ্লো
নির্মাতারা ব্যবহারকারীর নিয়ন্ত্রিত সক্ষমতার সঙ্গে একটি অডিশন করা Pack সংযুক্ত করতে পারেন, একই সঙ্গে বাইন্ডিং ও ক্রেডেনশিয়াল ব্যবহারকারীর মেশিনেই রাখতে পারেন। সমর্থিত প্যাটার্নের মধ্যে রয়েছে একটি নির্দিষ্ট HTTPS API, একটি নেস্টেড MCP সার্ভার এবং শেল-বিহীন স্থানীয় স্কিল।
বিক্রেতা ওয়ার্কফ্লো
বিক্রেতারা লিস্টিং তৈরি করতে, অপরিবর্তনীয় Pack সংস্করণ ও ছবি আপলোড করতে, প্রস্তুতি যাচাই করতে, Agent AVCP চালাতে, ব্যক্তিগত মেরামত-সংক্রান্ত ফিডব্যাক পর্যালোচনা করতে এবং মূল্যায়নে উত্তীর্ণ একটি রিলিজ প্রকাশ করতে পারেন।
পূর্বশর্ত
হোস্ট করা MCP ইন্টিগ্রেশন কনফিগার করার আগে নিম্নলিখিত বিষয়গুলো প্রস্তুত করুন:
- Node.js 20 বা তার পরের সংস্করণ।
- Tetrees Account পৃষ্ঠা থেকে প্রত্যাহারযোগ্য একটি API টোকেন।
- হোস্ট করা MCP সার্ভার ব্যবহার করার পরিকল্পনা থাকলে একটি MCP-সামঞ্জস্যপূর্ণ ক্লায়েন্ট।
- ইন্সপেক্টর, CLI, উদাহরণ বা যাচাইকরণ কমান্ড চালাতে চাইলে রিপোজিটরির একটি স্থানীয় চেকআউট।
ক্রেডেনশিয়াল Pack, প্রম্পট, সোর্স ফাইল এবং শেয়ার করা 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 সাফিক্সটি একই URL-এর অধীনে ক্যাশ করা পুরোনো টারবল পুনরায় ব্যবহার করা থেকে npx-কে বিরত রাখে। Tetrees নতুন MCP চুক্তি প্রকাশ করলেই কেবল এই মান পরিবর্তন করুন।
নিরাপদ MCP অনুরোধ চেষ্টা করুন
পেইড রান শুরু না করে কোনো Pack অনুসন্ধান ও কোট নিতে আপনার MCP ক্লায়েন্টকে বলুন:
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 ব্যবহার করুন
প্রকল্পটি ইচ্ছাকৃতভাবে গোপন ফাইল স্বয়ংক্রিয়ভাবে লোড করে না। CLI সেগুলো পড়বে এমনটি ধরে না নিয়ে .env.example থেকে প্রাসঙ্গিক মানগুলো আপনার শেল পরিবেশে কপি করুন।
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 অ্যাকাউন্টের সঙ্গে যুক্ত Pack-এর তালিকা দেখায়।
চালানোর আগে কোট নিন
কোট কোনো মডেল অনুরোধ শুরু করে না। নির্বাচিত Pack ও মডেল আইডেন্টিফায়ার দিন:
npm run tetrees -- quote <pack-id> <model-id>এক্সিকিউশন অনুমোদনের আগে সঠিক মডেল, টোকেন সীমা, হোস্ট করা স্কিল, গ্রোথ চেকপয়েন্ট এবং কোট করা Point প্রতিশ্রুতি পর্যালোচনা করুন।
Point-খরচকারী রান নিশ্চিত করুন
কোনো রান শুরু করতে সঠিক কনফার্মেশন ফ্ল্যাগ অন্তর্ভুক্ত করুন:
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"ভিন্ন ব্যবহারের ক্ষেত্রের জন্য Pack খুঁজতে incident response-এর পরিবর্তে অন্য কোনো অনুসন্ধান বাক্য ব্যবহার করুন।
বিল্ডার হিসেবে স্থানীয় সক্ষমতা যোগ করুন
প্রকাশিত কোনো 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 উদাহরণ হিসেবে এবং সম্পূর্ণ বিল্ডার চুক্তির জন্য docs/BUILDER_GUIDE.md দেওয়া আছে।
কোনো write method-এর জন্য প্রতি কলের সঠিক অনুমোদন বাক্য
APPROVE extensionId.methodIdপ্রয়োজন। সাধারণ কথোপকথনমূলক অনুমোদনকে write সম্পাদনের অনুমতি হিসেবে বিবেচনা করবেন না।
বিক্রেতা হিসেবে একটি 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 টুল অথবা Tetrees API রেফারেন্স ব্যবহার করে প্রকাশনা কর্মপ্রবাহ সম্পন্ন করুন:
- আপলোড করা সংস্করণ জমা দিন।
- Agent AVCP কোটের অনুরোধ করুন।
- Agent AVCP চালানোর আগে সঠিক পয়েন্টের পরিমাণ নিশ্চিত করুন।
- ব্যক্তিগত রিপোর্ট এবং মেরামতের প্রতিক্রিয়া পরিদর্শন করুন।
- শুধু মূল্যায়নে উত্তীর্ণ ডাইজেস্টটি প্রকাশ করুন।
লিস্টিং প্রস্তুত করার সময় docs/SELLER_GUIDE.md এবং examples/seller/pack-listing.example.json দেখুন।
উন্নত নিরাপত্তা ও নির্ভরযোগ্যতার পরামর্শ
শেয়ার করা কনফিগারেশন থেকে গোপনীয় তথ্য আলাদা রাখুন
Tetrees টোকেন এবং ঐচ্ছিক প্রোভাইডার কী স্থানীয় প্রসেস এনভায়রনমেন্টে সংরক্ষণ করুন। কোনো Pack, প্রম্পট, সোর্স ফাইল বা শেয়ার করা হতে পারে এমন কনফিগারেশনে কখনও প্রোভাইডারের শংসাপত্র সংযুক্ত করবেন না। প্রয়োজনে অ্যাক্সেস প্রত্যাহার করা যায় এমন প্রত্যাহারযোগ্য টোকেন ব্যবহার করুন।
মিউটেশন স্বয়ংক্রিয়ভাবে পুনরায় চেষ্টা করবেন না
ব্যর্থ write operation-এর ক্ষেত্রে কী করবেন তা নির্ধারণের আগে দেখানো Tetrees ত্রুটি কোড, HTTP স্ট্যাটাস এবং Retry-After মান পরীক্ষা করুন। স্বয়ংক্রিয় পুনরায় চেষ্টা আপলোড, ক্রয়, রান বা অন্যান্য স্টেট পরিবর্তনকারী অপারেশন পুনরাবৃত্তি করতে পারে।
হোস্ট করা MCP চুক্তি সচেতনভাবে পিন করুন
পুরোনো npx ক্যাশ এন্ট্রি এড়াতে MCP প্যাকেজ URL-এ নথিভুক্ত query suffix রেখে দিন। আনুষ্ঠানিকভাবে প্রকাশিত চুক্তির সংস্করণের প্রতিক্রিয়াতেই কেবল এটি আপডেট করুন।
সর্বজনীন সীমারেখা পর্যালোচনা করুন
অবদান রাখার আগে SECURITY.md এবং docs/PUBLIC_BOUNDARY.md পড়ুন। অবদানগুলো কেবল নথিভুক্ত সর্বজনীন প্রমাণীকৃত চুক্তির সঙ্গে কাজ করা উচিত এবং Agent-এর অভ্যন্তরীণ অংশ, ব্যক্তিগত Pack ডেটা, স্কোরিং ফিক্সচার, সাইনিং কী, ডেটাবেস, অ্যাডমিন API বা ডিপ্লয়মেন্ট অবকাঠামোতে প্রবেশাধিকার ধরে নেওয়া উচিত নয়।
রিপোজিটরি যাচাই করুন
পরিবর্তন বিতরণ বা প্যাকেজ প্রস্তুত করার আগে সরবরাহ করা যাচাইগুলো চালান:
npm test
npm run check:public-boundary
npm pack --dry-runউপযোগী সর্বজনীন রেফারেন্স
উপসংহার
Tetrees Agent EX Tetrees AI Pack আবিষ্কার, মূল্যায়ন, চালানো, সম্প্রসারণ এবং প্রকাশের জন্য একটি স্বচ্ছ সর্বজনীন চুক্তি সরবরাহ করে। শুধুমাত্র-পঠনযোগ্য পরিদর্শন দিয়ে শুরু করুন, মডেল-অর্থায়িত কাজের আগে সঠিক কোটের অনুরোধ করুন, ব্যয় ও write-এর জন্য স্পষ্ট নিশ্চিতকরণ আবশ্যক করুন এবং ব্যবহারকারীর মালিকানাধীন সব শংসাপত্র ও এক্সটেনশনের অনুমতি স্থানীয় রাখুন।