تثبيت AI Connect
افتح صفحة التنزيلات وتحقق من توفر إصدار لنظام التشغيل لديك. نزّل ملف التثبيت المناسب لجهازك وشغّله، ثم افتح AI Connect.
توفر الإصدارات: لا توجد ملفات تثبيت عامة مدرجة حالياً. ستظهر روابط التنزيل عند توفر إصدار. توضح الخطوات التالية كيفية استخدام التطبيق بعد تثبيته.
لا تحتاج إلى حساب سحابي لاستخدام AI Connect أو تنزيل أدوات الذكاء الاصطناعي العامة.
فتح لوحة التحكم
إذا كان الخادم متوقفاً، شغّله من سطر الأوامر باستخدام ai-connect start، ثم افتح التطبيق وسجّل الدخول.
سجّل الدخول إلى لوحة التحكم المحلية باسم المستخدم الأولي admin وكلمة المرور 1234. استخدم Change login لحفظ بياناتك الخاصة.
هذا الحساب المحلي منفصل عن حساب SyraIO السحابي. تتحكم لوحة التحكم بالخادم الذي يعمل على جهازك.
إضافة أدوات {#AI Tools}
- افتح AI Tool store / Browse واختر أداة ذكاء اصطناعي وإصداراً، ثم اختر Install on this device.
- أو نزّل ZIP من دليل أدوات الذكاء الاصطناعي، ثم اختر AI Tools / Install from ZIP داخل التطبيق.
- افتح Resources وثبّت أو اختر بيئة Node.js أو Python التي تحتاجها أداة الذكاء الاصطناعي.
- فعّل أداة الذكاء الاصطن اعي من AI Tools. تبدأ أدوات الذكاء الاصطناعي الجديدة معطلة.
- افتح Dashboard وانسخ عنوان MCP. يتم تحديث الأدوات تلقائياً بعد تفعيل أداة الذكاء الاصطناعي.
تُشغّل أدوات الذكاء الاصطناعي الشفرة على جهازك. اقرأ وصف الناشر وملف README قبل تفعيلها.
ربط عميل الذكاء الاصطناعي
أضف خادماً في إعدادات MCP لدى عميل الذكاء الاصطناعي، واختر Streamable HTTP. استخدم عنوان MCP المعروض في لوحة تحكم AI Connect. العنوان الافتراضي:
http://127.0.0.1:3010/mcp
استخدم عنوان لوحة التحكم إذا غيّرت المنفذ. في هذا الإعداد المحلي يعمل العميل وAI Connect على الجهاز نفسه.
VS Code مع GitHub Copilot
أضف هذا الإعداد إلى ملف .vscode/mcp.json في مساحة عملك:
{
"servers": {
"ai-connect": {
"type": "http",
"url": "http://127.0.0.1:3010/mcp"
}
}
}
افتح لوحة الأوامر وشغّل MCP: List Servers، واختر ai-connect وابدأ تشغيله. وافق على طلب الثقة إن ظهر. في وضع Agent داخل Copilot Chat فعّل الأدوات المطلوبة.
للعملاء الآخرين شاشات إعداد خاصة بهم. استخدم نوع الاتصال نفسه والعنوان المعروض في لوحة التحكم.
استخدام الأدوات
اطلب من العميل تنفيذ مهمة تدعمها إحدى أدوات الذكاء الاصطناعي المفعّلة. مثلاً، إذا ثبّت أداة ذكاء اصطناعي للبحث عن الملفات فاطلب منه العثور على ملف باسمه.
راجع اسم الأداة والإجراء المطلوب عندما يطلب العميل موافقتك. تعتمد الإجراءات المتاحة على أدوات الذكاء الاصطناعي المثبتة والمفعّلة.
إبقاء الخادم في الخلفية
إغلاق نافذة سطح المكتب لا يوقف الخادم الخلفي. أعد فتح التطبيق لإدارة أدوات الذكاء الاصطناعي وبيئات التشغيل.
التشغيل والإيقاف متاحان من سطر الأوامر باستخدام ai-connect start وai-connect stop. تحفظ إعدادات المنفذ للتشغيل القادم. يطبّق زر Restart AI Connect الإعدادات المحفوظة فوراً، ثم يلزم تسجيل الدخول مجدداً في العنوان الجديد.
استخدام سطر الأوامر
إذا كان الإصدار المثبت يتضمن CLI، يمكنك التحكم به من الطرفية أو عبر SSH:
ai-connect tools install ./my-tools.zip
ai-connect tools enable my-tools
ai-connect start
ai-connect status
استبدل my-tools بمعرّف أداة الذكاء الاصطناعي. قد تحتاج أيضاً إلى اختيار بيئة التشغيل من Resources. يحتاج العميل البعيد إلى اتصال بالجهاز الذي يشغّل AI Connect؛ يشير 127.0.0.1 دائماً إلى جهاز العميل نفسه.
حل المشكلات
العميل لا يكتشف أدوات
تأكد من تفعيل أداة الذكاء الاصطناعي وتوفر بيئة التشغيل وبدء أدوات MCP. أعد اتصال العميل بعد تغيير أدوات الذكاء الاصطناعي. راجع Logs لأخطاء بدء التشغيل.
لوحة التحكم لا تفتح
افتح التطبيق وتحقق من تشغيل الخادم الخلفي. عنوان لوحة التحكم الافتراضي في المتصفح هو http://127.0.0.1:3010/. استخدم المنفذ الذي أعددته إذا كان مختلفاً.
أداة الذكاء الاصطناعي لا تبدأ
راجع ملف README لمعرفة متطلبات نظام التشغيل وبيئة التشغيل، ثم راجع السجلات. يجب أن تتوافق حزمة أداة ذكاء اصطناعي Python مع المنصة وإصدار Python المدعومين.
هل تريد إنشاء أدوات ذكاء اصطناعي؟
انتقل إلى دليل مطوري أدوات الذكاء الاصطناعي للتعرّف على تعريف الأدوات وتجميع أدوات الذكاء الاصطناعي ونشرها.
أدوات المساعدة المدمجة
يوفّر AI Connect ثلاث أدوات MCP للقراءة فقط، حتى عند عدم تثبيت أي حزمة أدوات. لا تحتاج هذه الأدوات إلى Node.js أو Python:
ai_connect_server_info: إصدار الخادم ومدة تشغيله ونظام التشغيل وبنيته وعناوين الاتصال.ai_connect_tool_counts: أعداد حزم الأدوات المثبتة والمفعّلة والعاملة، وعدد الدوال المتاحة.ai_connect_capabilities: بيئات التشغيل المدعومة ووسيلة النقل وإمكانات MCP المعلنة.
اطلب من عميل الذكاء الاصطناعي استدعاء هذه الأدوات دون معام لات. لا تعرض كلمات المرور أو الرموز السرية أو مسارات التخزين الخاصة. تظهر أدواتك المثبتة معها في قائمة MCP.
إدارة الأدوات والتحديثات
افتح AI Tools في لوحة التحكم. استخدم All tools (كل الأدوات)، أو Built-in (المدمجة)، أو Installed (المثبتة) لتصفية القائمة، أو ابحث بالاسم.
أدوات المساعدة المدمجة مفعّلة افتراضياً. يمكنك تفعيل كل أداة أو تعطيلها، لكن لا يمكنك حذفها. تُحفظ اختياراتك بعد إعادة التشغيل. لا تظهر الأدوات المعطّلة في اكتشاف MCP ولا يمكن استدعاؤها. أعد اتصال عميل الذكاء الاصطناعي لتحديث قائمة أدواته بعد أي تغيير.
للأدوات المثبتة، اضغط Check for updates (التحقق من التحديثات) بجانب Refresh (تحديث القائمة). لكل أداة مثبتة زر Update يصبح متاحاً عند العثور على إصدار أحدث. أكّد التحديث لاستبدال الحزمة مع الاحتفاظ بحالة تفعيلها. تُحدّث الأدوات المدمجة ضمن تحديث AI Connect نفسه.