इस प्रोजेक्ट के बारे में

Known Agents SDK Known Agents प्लेटफ़ॉर्म के साथ इंटरैक्ट करने का आधिकारिक Node.js क्लाइंट है। यह सर्वर‑साइड TypeScript या JavaScript एप्लिकेशन को साइट पर आने वाले AI एजेंट्स और अन्य बॉट्स, या Model Context Protocol (MCP) एंडपॉइंट्स को कॉल करने वाले विस्तृत विश्लेषण एकत्र करने में सक्षम बनाता है。 मुख्य विशेषताएं: * Visit इवेंट ट्रैकिंग – मिडलवेयर में `trackPageviewOrRESTCall` का उपयोग करके पेजव्यू या REST कॉल रिकॉर्ड करें। इवेंट्स क्यू में रखे जाते हैं और आकार या समय अंतराल के आधार पर स्वचालित रूप से फ्लश हो जाते हैं। * MCP कॉल ट्रैकिंग – Model Context Protocol पर बनी सेवाओं के लिए, `trackMCPCall` अनुरोध, प्रतिक्रिया और परिवहन विवरण रिकॉर्ड करता है, जो Agentic Commerce Protocol (ACP) और Universal Commerce Protocol (UCP) इंटरैक्शन को स्वचालित रूप से हैंडल करता है। * Agentic कॉमर्स सपोर्ट – जब ACP या UCP REST प्रतिक्रियाओं को हैंडल किया जाता है, तो खरीद‑फ़्लो डेटा कैप्चर करने के लिए प्रतिक्रिया शरीर को `trackPageviewOrRESTCall` में शामिल करें। * स्वचालित robots.txt जनरेशन – `AgentType` मानों की सूची के साथ `generateRobotsTXT` कॉल करके एक साधन‑पाठ robots.txt प्राप्त करें जो विशिष्ट क्रॉलर श्रेणियों को ब्लॉक या अनुमति देता है। इस स्ट्रिंग को शेड्यूल पर (उदाहरण के लिए, दैनिक) पुनः जनरेट किया जा सकता है और `/robots.txt` पर परोसा जा सकता है। * Agent Identification API – `identifyAgent` (एकल अनुरोध) या `identifyAgents` (बैच) का उपयोग करके आने वाले अनुरोधों की पहचान और सत्यापन करें। प्रतिक्रिया में सत्यापन स्थिति, एजेंट मेटाडेटा, ASN जानकारी, और एक ऑटोमेशन स्कोर शामिल होता है जो दर्शाता है कि अनुरोध कितना स्वचालित होने की संभावना है। स्थापना npm के माध्यम से सीधी है: `npm install @knownagents/sdk`। knownagents.com पर साइन अप करने और एक एक्सेस टोकन प्राप्त करने के बाद, क्लाइंट को `new KnownAgents('YOUR_ACCESS_TOKEN')` से इनिशियलाइज़ करें। वैकल्पिक कॉन्फ़िगरेशन से आप इवेंट बैचिंग के लिए `flushQueueSize` और `flushIntervalInMilliseconds` सेट कर सकते हैं। SDK को TypeScript ≥ 4.7 की आवश्यकता होती है और यह Node.js 18 LTS या नए पर चलता है। मदद के लिए, GitHub रिपॉज़िटरी पर एक इश्यू खोलें। समग्र रूप से, यह लाइब्रेरी AI‑एजेंट एनालिटिक्स, बॉट ट्रैफ़िक प्रबंधन, और स्वचालित robots.txt हैंडलिंग के लिए एक व्यापक सर्वर‑साइड समाधान प्रदान करती है, जिससे आपके वेब सेवाओं के साथ AI‑चालित इंटरैक्शन की निगरानी और नियंत्रण आसान हो जाता है।