The official Enterprise AI SDK for Zakkur - Digital C-Suite and Decision Engine.
npm install zakkur-sdkbash
npm install zakkur-sdk
🛠️ التهيئة (Initialization)قم بإنشاء كائن من الفئة Zakkur باستخدام مفتاح الوصول الخاص بمؤسستك.JavaScriptconst Zakkur = require('zakkur-sdk');
const sdk = new Zakkur({
apiKey: 'zk_live_xxxxxxxxxxxxxxxx', // احصل عليه من بوابة المطورين
baseUrl: 'https://zakkur.com/api', // رابط السيرفر الخاص بك
timeout: 30000, // 30 ثانية
retries: 3 // عدد محاولات إعادة الطلب
});
🧠 دليل استخدام الوحدات1️⃣ وحدة مجلس الإدارة (The Board)تُستخدم لاتخاذ القرارات الكبرى التي تتطلب رؤية شاملة.JavaScript// استشارة كامل المجلس في قضية استراتيجية معقدة
const response = await sdk.board.consult("نخطط لتوسيع عملياتنا في السوق العالمي، ما هي المخاطر التقنية والمالية؟");
console.log("القرار التنفيذي:", response.data.final_decision.decision);
console.log("خارطة الطريق:", response.data.final_decision.action_items);
2️⃣ وحدة الوكلاء الديناميكية (Dynamic Agents)يمكنك التحدث مع أي مدير تنفيذي مباشرة بأسلوب برمجي حديث.JavaScript// استشارة المدير المالي (CFO) مباشرة
const financialReport = await sdk.agents.cfo.consult("قم بتحليل ميزانية الربع القادم");
// طلب مهمة تنفيذية من المدير التقني (CTO)
const codeTask = await sdk.agents.cto.execute("اكتب سكربت بايثون لتحليل بيانات العملاء بأمان");
3️⃣ وحدة المعرفة (Knowledge Base)تسمح لك بتغذية ذكاء زكور بملفات شركتك المؤسسية.JavaScript// رفع مستند جديد
const upload = await sdk.knowledge.upload(fileBuffer, 'HR_Policy_2026.pdf');
// عرض قائمة المستندات المتوفرة
const docs = await sdk.knowledge.list();
🔒 إدارة الجلسات (Contextual Threading)للحفاظ على سياق المحادثة وجعل الوكيل يتذكر تاريخ الحوار السابق.JavaScriptlet threadId = null;
// الطلب الأول
const step1 = await sdk.agents.ceo.consult("من هو عميلنا المثالي؟");
threadId = step1.threadId;
// الطلب الثاني (بنفس السياق المستمر)
const step2 = await sdk.agents.ceo.consult("وكيف يمكننا استهدافه بفاعلية؟", { threadId });
⚠️ معالجة الأخطاء (Error Handling)يوفر الـ SDK كلاس خاص ZakkurError لتسهيل عملية التصحيح.JavaScripttry {
const result = await sdk.board.consult("...");
} catch (error) {
if (error.name === 'ZakkurError') {
console.error(Status: ${error.status}); // مثل 403 أو 429
console.error(Code: ${error.code}); // AGENT_RESTRICTED
console.error(Message: ${error.message}`);