প্রকল্প সম্পর্কে

Known Agents SDK একটি অফিসিয়াল Node.js ক্লায়েন্ট যা Known Agents প্ল্যাটফর্মের সাথে ইন্টারঅ্যাক্ট করার জন্য। এটি সার্ভার‑সাইড TypeScript বা JavaScript অ্যাপ্লিকেশনকে সাইটে ভিজিট করা AI এজেন্ট এবং অন্যান্য বট বা Model Context Protocol (MCP) এন্ডপয়েন্ট কল করার সময় বিস্তারিত বিশ্লেষণ সংগ্রহ করতে সক্ষম করে।\n\nমुख্য বৈশিষ্ট্য:\n\n* **ভিজিট ইভেন্ট ট্র্যাকিং** – মিডলওয়্যারে `trackPageviewOrRESTCall` ব্যবহার করে পেজভিউ বা REST কল রেকর্ড করুন। ইভেন্টগুলো কিউতে রাখা হয় এবং আকার বা সময় ইন্টারভাল অনুযায়ী স্বয়ংক্রিয়ভাবে ফ্লাশ হয়।\n* **MCP কল ট্র্যাকিং** – Model Context Protocol (MCP) ভিত্তিক সেবাগুলোর জন্য, `trackMCPCall` অনুরোধ, প্রতিক্রিয়া এবং ট্রান্সপোর্ট ডেটা রেকর্ড করে, Agentic Commerce Protocol (ACP) এবং Universal Commerce Protocol (UCP) ইন্টারঅ্যাকশনকে স্বয়ংক্রিয়ভাবে পরিচালনা করে।\n* **Agentic commerce সমর্থন** – ACP বা UCP REST প্রতিক্রিয়া হ্যান্ডল করার সময়, ক্রয়‑ফ্লো ডেটা ক্যাপচার করতে `trackPageviewOrRESTCall`‑এ প্রতিক্রিয়া শরীর অন্তর্ভুক্ত করুন।\n* **স্বয়ংক্রিয় robots.txt জেনারেশন** – `AgentType`‑এর একটি তালিকা সহ `generateRobotsTXT` কল করে একটি প্লain‑text robots.txt পান যা নির্দিষ্ট ক্রালার কেটেগরি ব্লক বা অনুমতি দেয়। এই স্ট্রিংকে একটি শিডিউলে (উদাহরণস্বরূপ, দৈনিক) পুনরুত্পন্ন করা যায় এবং `/robots.txt`‑এ সার্ভ করা যায়।\n* **Agent Identification API** – `identifyAgent` (একক অনুরোধ) বা `identifyAgents` (ব্যাচ) ব্যবহার করে incoming অনুরোধগুলো চিহ্নিত এবং যাচাই করুন। প্রতিক্রিয়া যাচাইের স্ট্যাটাস, এজেন্ট মেটাডেটা, ASN তথ্য এবং একটি অটোমেশন স্কোর অন্তর্ভুক্ত করে যা অনুরোধের কতটুকু অটোমেটেড হওয়ার সম্ভাবনা নির্দেশ করে।\n\nইনস্টলেশন npm‑ের মাধ্যমে সরল: `npm install @knownagents/sdk`। knownagents.com‑এ সাইন‑আপ করে একটি অ্যাক্সেস টোকেন পেলে, `new KnownAgents('YOUR_ACCESS_TOKEN')`‑ দিয়ে ক্লায়েন্ট ইনস্ট্যান্সিয়েট করুন। ঐচ্ছিক কনফিগারেশন আপনাকে `flushQueueSize` এবং `flushIntervalInMilliseconds` সেট করতে দেয় ইভেন্ট ব্যাচিং জন্য।\n\nSDK‑এ TypeScript ≥ 4.7 প্রয়োজন এবং Node.js 18 LTS বা তার নতুন সংস্করণে চালায়। সাহায্যের জন্য GitHub রেপোজিটরিতে একটি ইস্যু খুলুন।\n\nসামগ্রিকভাবে, এই লাইব্রেরি AI‑এজেন্ট বিশ্লেষণ, বট ট্রাফিক ম্যানেজমেন্ট এবং স্বয়ংক্রিয় robots.txt হ্যান্ডলিং এর জন্য একটি সম্পূর্ণ সার্ভার‑সাইড সমাধান প্রদান করে, যা আপনার ওয়েব সেবাগুলোর সাথে AI‑চালিত ইন্টারঅ্যাকশন নিরীক্ষণ ও নিয়ন্ত্রণকে সহজ করে।