عن المشروع

تعد Known Agents SDK عميلاً رسمياً لـ Node.js للتفاعل مع منصة Known Agents. وهي تمكن تطبيقات TypeScript أو JavaScript من جانب الخادم من جمع تحليلات مفصلة حول وكلاء الذكاء الاصطناعي والبوتات الأخرى التي تزور الموقع أو تستدعي نقاط نهاية Model Context Protocol (MCP). الميزات الرئيسية: * **تتبع أحداث الزيارة** – استخدم `trackPageviewOrRESTCall` في البرمجيات الوسيطة (middleware) لتسجيل مشاهدات الصفحات أو استدعاءات REST. يتم وضع الأحداث في قائمة انتظار وتفريغها تلقائياً بناءً على الحجم أو الفاصل الزمني. * **تتبع استدعاءات MCP** – بالنسبة للخدمات المبنية على Model Context Protocol، تقوم `trackMCPCall` بتسجيل تفاصيل الطلب والاستجابة والنقل، مع معالجة تفاعلات Agentic Commerce Protocol (ACP) و Universal Commerce Protocol (UCP) تلقائياً. * **دعم التجارة الوكيلية (Agentic commerce)** – عند التعامل مع استجابات ACP أو UCP REST، قم بتضمين جسم الاستجابة في `trackPageviewOrRESTCall` لالتقاط بيانات تدفق الشراء. * **توليد تلقائي لملف robots.txt** – استدعِ `generateRobotsTXT` مع قائمة من قيم `AgentType` للحصول على ملف robots.txt نصي بسيط يحظر أو يسمح بفئات محددة من الزواحف (crawlers). يمكن إعادة توليد السلسلة النصية وفق جدول زمني (يومياً مثلاً) وتقديمها عبر المسار `/robots.txt`. * **واجهة برمجة تطبيقات تحديد الوكيل (Agent Identification API)** – تحديد والتحقق من الطلبات الواردة باستخدام `identifyAgent` (طلب واحد) أو `identifyAgents` (دفعة). تتضمن الاستجابة حالة التحقق، والبيانات الوصفية للوكيل، ومعلومات ASN، ودرجة الأتمتة التي تشير إلى مدى احتمالية أن يكون الطلب مؤتمتاً. التثبيت بسيط عبر npm: `npm install @knownagents/sdk`. بعد التسجيل في knownagents.com والحصول على رمز وصول (access token)، قم بإنشاء نسخة من العميل باستخدام `new KnownAgents('YOUR_ACCESS_TOKEN')`. تتيح لك الإعدادات الاختيارية تعيين `flushQueueSize` و `flushIntervalInMilliseconds` لتجميع الأحداث في دفعات. تتطلب SDK إصدار TypeScript ≥ 4.7 وتعمل على Node.js 18 LTS أو أحدث. للحصول على المساعدة، يمكنك فتح مشكلة (issue) في مستودع GitHub. بشكل عام، توفر المكتبة حلاً شاملاً من جانب الخادم لتحليلات وكلاء الذكاء الاصطناعي، وإدارة حركة مرور البوتات، والتعامل المؤتمت مع robots.txt، مما يسهل مراقبة والتحكم في التفاعلات التي يقودها الذكاء الاصطناعي مع خدمات الويب الخاصة بك.