عن المشروع

يعتبر Vocion (@vocion/core) إطار عمل مفتوح لتشغيل أعمال وكلاء الذكاء الاصطناعي في بيئات الإنتاج بدلاً من مجرد بناء النماذج الأولية. يحدد ملف README المستخدم المستهدف بأنه مهندس أو قائد تقني ينقل فريقاً من الوكلاء إلى الإنتاج، ويشير صراحةً إلى الحالات التي لا يكون فيها المشروع مناسباً: مثل روبوت دردشة واحد، أو نص برمجي لمرة واحدة، أو أداة بناء بدون كود مستضافة. يفترض المشروع أنك تقوم بتشغيل Postgres، وتحتفظ بالتكوينات في git، وترغب في وجود عنصر بشري في الحلقة (human in the loop) للإجراءات الهامة. الحزمة الأساسية غير منشورة على npm؛ بل يتم استنساخ المستودع وتشغيله ذاتياً. ما تجمعه المنصة يتم وصف Vocion بأنه تطبيق Next.js بالإضافة إلى مخطط Postgres وخادم MCP ومشغل سير عمل. يمكنك تأليف المصادر (Sources)، والكائنات (Objects)، والمهارات (Skills)، وكتيبات التشغيل (Playbooks)، وسير العمل (Workflows)، والمهام (Missions)، والأتمتة (Automations)، والوكلاء (Agents)، والفرق (Teams) كملفات YAML وmarkdown في git، وتطبيقها على قاعدة البيانات، والحصول على بيئة تشغيل ذات أنواع محددة (typed runtime) مع طابور مراجعة بشرية موحد، وقابلية للملاحظة، ونظام بيئي للإضافات. تتشارك ثلاثة أنماط عمل في بيئة تشغيل واحدة: - سير العمل (Workflows): خطوات حتمية مع بوابات للموافقة والاستفسار. - المهام (Missions): مسؤوليات قائمة ومفتوحة، حيث يقوم فريق من الوكلاء بالتخطيط والعمل وإنتاج مخرجات تخضع للمراجعة. - الفرق (Teams): وكلاء متعددون مجمعون تحت قيادة قائد مع وجود إنسان مسؤول. تشمل القدرات الأخرى المذكورة حزمة موصلات مدمجة لـ Google Ads وGA4 وHubSpot وGmail وSlack وGoogle Drive عبر خط أنابيب استيعاب تدريجي ونطاق عميل؛ ولوحة تحكم متعددة المستأجرين مع رموز Bearer tokens للمستأجرين التي يتم تحليلها إلى أصيل أذونات؛ وواجهة برمجة تطبيقات (API) للكتابة تعرض طابور المراجعة عبر REST (نقاط نهاية لسرد المراجعات واتخاذ القرار)؛ وMCP عبر HTTP كطبقة للوكلاء والأدوات. يتم فصل أذونات الاكتشاف والتعديل، وتحكم "سلم الاستقلالية" مع بوابات الموافقة في التنفيذ، ويتم فرض العزل بين العملاء على مستوى الاستعلام بدلاً من المطالبات (prompts). تنفيذ الوكيل قابل للتكوين من خلال إعداد واحد، harness.runsOn. الخيارات الموثقة هي تشغيل حلقة الوكيل داخل عملية التطبيق، أو في حاوية المشروع الخاصة على AWS Bedrock AgentCore Runtime، أو تسليمها إلى harness المدار من AWS، مع توضيح التوثيق لأي حساب AWS يدفع ثمن الرموز (tokens) في كل حالة. الحزم الطبقية وعقد الإضافات المستودع هو الطبقة الأساسية لمنصة أكبر. تحدد حزمة SDK عقد الإضافة المستقر، بما في ذلك أنواع Skill وPluginManifest وأنواع عميل LLM. يتم شحن الموصلات والمهارات كحزم npm منفصلة للإضافات، ومن المخطط توفير تثبيت بدائي قابل للتفرع في مستودع منفصل. الإضافة هي حزمة npm تصدر ماني فيست (manifest)؛ حيث تقوم النواة بتحميل الماني فيست عند بدء التشغيل عبر SDK. يعرض ملف README نموذجاً لتعريف مهارة مبني باستخدام مكتبة تحقق من المخطط، يحدد الـ slug والاسم والإصدار والمزود ومتطلبات الموافقة ومخططات الإدخال والإخراج ودالة التشغيل، ويتم تصديرها كـ PluginManifest. توجد إضافة مرجعية لـ transcript-highlights في دليل packages/plugins. مساحة العمل ككود (Workspace as code) تعيش جميع سياقات المستأجرين في مساحة عمل: وهي دليل يتتبع عبر git يحتوي على ملفات YAML وmarkdown يقع خارج استنساخ المستودع، وعادة ما يكون مستودعاً خاصاً به، بحيث يمكن مراجعة سياق العميل في طلبات السحب (pull requests) وعدم خلطه أبداً مع النواة. يشير متغير بيئي التطبيق إليها؛ وبدونه لا يتم تكوين أي مساحة عمل. تشمل أنواع الكيانات الموثقة ومواقعها: ماني فيست مساحة العمل، الوكلاء (ملف YAML بالإضافة إلى ملف markdown للمطالبة النظامية)، الفرق، المهارات، كتيبات التشغيل، المهام، عمليات تشغيل سير العمل التي يتم إنشاؤها بواسطة API، سير العمل، الأتمتة (المكان الوحيد الذي تعيش فيه الأوقات والأحداث)، أنواع الكائنات مع أوزان المصدر ومطالبة التصنيف، المصادر مع نوع الموصل وتواتر المزامنة، قواعد الثقة للإجراءات التي قد تنفذ تلقائياً، خطوات التعلم كحاويات مسماة من القواعد المتراكمة، مجموعات بيانات التقييم لحالات اختبار كل وكيل، وصفحات لوحة التحكم المحددة من قبل المستأجر. يتم شحن حزمة أساسية داخل النواة وتوضع كطبقة أسفل مساحة العمل: يمكنك تثبيتها بتوجيه extends، وتفعيل الوكلاء بقائمة use، وتجاوز الإعدادات الافتراضية بملفات ذات slug مماثل. تسجيل تطبيق مساحة عمل على قاعدة البيانات يوثق صف تدقيق مع إصدار مساحة العمل، وتختم استدعاءات الأدوات بـ hash لمساحة العمل بحيث يمكن تتبع المخرجات وصولاً إلى المطالبات التي أنتجتها. الإعداد والعمليات يتم توثيق بدء التشغيل كعملية استنساخ وتثبيت، نسخ ملف مثال البيئة وتعيين URL لقاعدة البيانات، وسر مصادقة ومفتاح مزود LLM واحد على الأقل، وبدء الخدمات الداعمة باستخدام نص dev:up (Postgres وLangfuse وTemporal)، وتشغيل التهجيرات (migrations)، وإنشاء هيكل لمساحة عمل، وتوجيه WORKSPACE_PATH إليها، وتطبيقها، ثم بدء خادم التطوير على المنفذ 3000 في localhost. تغطي نصوص المشروع أيضاً التدقيق اللغوي (linting)، والتحقق من الأنواع، والاختبارات، وتطبيق مساحة العمل وعمليات التقييم. بالنسبة لعملاء MCP مثل Claude Code أو Cursor أو Zed، يوجد أمر stdio محلي لتثبيت مطور واحد، بالإضافة إلى نقطة نهاية HTTP عن بُعد حيث يتم اشتقاق المنظمة من رمز Bearer token للمستأجر، ويكون كل استدعاء أداة محصوراً في تلك المنظمة تحت نفس نموذج الأذونات الخاص بالبشر. يتم التعامل مع بيانات الاعتماد في كلا الاتجاهين وإدارتها من صفحة لوحة التحكم. يتم إصدار الرموز الواردة بواسطة Vocion، وتخزن فقط كـ SHA-256 hash، وتظهر بنص صريح مرة واحدة. يمكن توفير مفاتيح الموردين الصادرة لكل مساحة عمل، وتشفيرها أثناء السكون باستخدام AES-256-GCM تحت مفتاح تشفير بيانات لكل منظمة، بحيث يتم فوترة حساب المورد الخاص بمساحة العمل؛ مفتاح حي واحد لكل منصة لكل منظمة. كل استدعاء مورد صادر يحل أولاً المفتاح المخزن في مساحة العمل ثم متغير بيئة الخادم، وهو ما يغطي نماذج الدردشة، والتضمينات (embeddings) عند الاستيعاب والاستعلام، وإعادة التصنيف (reranking)، والرؤية وتوليد الصور، مع بقاء مسارين داخليين على مفتاح الخادم عن قصد. يوفر تكوين التشفير وضع vault محلي مخصص للتطوير ووضع KMS الموصى به للتثبيتات التي تحمل مفاتيح عملاء حقيقية. الاسترجاع (Retrieval) هو ميزة أساسية: pgvector مع HNSW cosine بالإضافة إلى بحث Postgres بالنص الكامل، مدمجين عبر reciprocal rank fusion بين الذراعين، مع إعادة تصنيف اختيارية بواسطة LLM. نماذج التضمين وإعادة التصنيف هي إعدادات على مستوى البيئة، بينما يتم تأليف أوزان الاسترجاع لكل نوع وكل وكيل في مساحة العمل دون تغييرات في الكود. المجموعة التقنية والتكاملات المجموعة التقنية المذكورة هي Next.js 16 مع App Router، وReact 19 وTypeScript صارم، وPostgreSQL 16 مع ORM، وAuth.js / NextAuth v5 للتعددية المستأجرة من الدرجة الأولى مع وصول قائم على الأدوار من خلال عضوية الحساب والمشروع، وOpenAI وAnthropic كمزودي LLM قابلين للتبديل لكل مهارة، وLangfuse لتتبع LLM وOpenTelemetry للـ spans والمقاييس، ومشغل خطوات سير عمل متين داخل العملية على Postgres، وأسطح دردشة Slack حيث يؤدي ذكر وكيل إلى رد في سلسلة محادثات بينما يظل طابور المراجعة هو المكان الوحيد الذي يتم فيه الموافقة على أي شيء (خلف علم ميزة)، ولوحة تحكم عامل خارجي للعمليات التي تستغرق ساعات مع عقود إيجار (leases) ونبضات قلب (heartbeats) وتكلفة لكل عملية تشغيل وأداة تنظيف (reaper) (أيضاً خلف علم ميزة). الترخيص المشروع متاح المصدر بموجب رخصة Mozilla Public License 2.0، الموصوفة بأنها معتمدة من OSI وcopyleft على مستوى الملف: يمكنك استخدامه، واستضافته ذاتياً، وفحصه، وتعديله ودمجه في نظام ملكية أكبر، وتظل ملفات Vocion المعدلة مفتوحة بموجب MPL عند توزيعها بينما يظل كود التطبيق المحيط ملكاً لك. ينص ملف README على أن البيانات، وسياق الأعمال، وتكوينات الوكلاء، وسير العمل، وتاريخ التقييم، والمخرجات التشغيلية تظل ملكاً لك، وأن المشروع قابل للنشر في بيئتك الخاصة. تتطلب بعض الاستخدامات، مثل إعادة تسمية Vocion (white-labelling)، أو توزيعه بموجب رخصة ملكية، أو خدمة مدارة مدعومة من مورد، أو وحدات مؤسسية ملكية، أو ضمانات ومستويات خدمة تجارية، اتفاقية منفصلة. الاسم والشعارات هي علامات تجارية لشركة Metacto, Inc.، ولا تمنح MPL حقوق العلامات التجارية. إشارات التوثيق يربط ملف README بدليل بدء التشغيل الذي ينتقل من دليل فارغ إلى قوة عاملة من الوكلاء دون كود، وملف مكتوب لوكلاء البرمجة الذين يعملون في المستودع، وفهرس توثيق قابل للقراءة آلياً، ودليل تأليف مساحة العمل، ومراجع الحقول لكل كيان، وصفحة نموذج الكائنات التي تصف أين يتم تأليف كل كائن وتخزينه وتنفيذه وعرضه، ودليل صفحات لوحة التحكم، وتوثيق النشر الذي يغطي بيئات متعددة ونمط المشروع الأب. تغطي إرشادات المساهمة الالتزامات التقليدية (conventional commits) المفروضة بواسطة الأدوات، وتوقيع DCO، وتشغيل التحقق من الأنواع والاختبارات والتدقيق اللغوي قبل الالتزام.