---
title: التهيئة باستخدام الذكاء الاصطناعي
description: دع مساعد AI يهيئ NexCMP ويشغله: AI Chat في لوحة الإدارة، أو عميل AI عبر MCP، أو ملف YAML. تعرّف على إمكاناته وقواعد الأمان الخاصة به.
url: https://nexcmp.com/ar/docs/configure-with-ai/overview/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# التهيئة باستخدام الذكاء الاصطناعي {#configure-with-ai}

> **أين في لوحة المشرف:** AI Chat (`/agent`) و System › Settings › API & AI agents (`/agent/keys`). كل ما في هذه الصفحات مخصص للمشرفين فقط.

## الوظيفة {#what-it-does}

بدءاً من الإصدار NexCMP 1.4.0، يمكنك أن تطلب من مساعد الذكاء الاصطناعي إعداد اللوحة نيابةً عنك: ربط Proxmox VE أو CloudStack، أو إنشاء منطقة، أو بناء جدول خطط بناءً على التكاليف الخاصة بك، أو إعداد البريد الإلكتروني والمدفوعات والعلامة التجارية، أو البحث عن عميل، أو تصدير التكوين بالكامل. يعمل المساعد من خلال مجموعة ثابتة من **أدوات المشرف**. فهو لا يحصل أبداً على صدفة (shell)، ولا يقرأ الملفات على الخادم، ولا يرى أبداً كلمة مرور مخزنة أو مفتاح API.

استخدمه عندما تريد إعداداً اولياً في دقائق بدلاً من النقر عبر عشرات الصفحات، أو عندما تدير عدة تثبيتات وترغب في الاحتفاظ بتكوينها في ملف.

## ثلاث طرق لاستخدامه {#three-ways-to-use-it}

| الطريقة | من يتحدث إلى الذكاء الاصطناعي | أين يعمل | ابدأ من هنا |
|---|---|---|---|
| **AI Chat في لوحة المشرف** | أنت، في لوحة مشرف NexCMP | مصدر الذكاء الاصطناعي الذي تختاره: مفتاح API من OpenAI أو Anthropic أو Gemini أو OpenRouter، أو مزود الذكاء الاصطناعي الخاص بلوحتك، أو واجهة سطر أوامر (CLI) رسمية للذكاء الاصطناعي قمت بتسجيل الدخول إليها | [AI Chat في لوحة المشرف](https://nexcmp.com/ar/docs/configure-with-ai/ai-chat-in-admin/) |
| **عميل الذكاء الاصطناعي الخاص بك عبر MCP** | أنت، في Claude Code أو Codex CLI أو Gemini CLI أو Cursor أو Claude Desktop أو claude.ai أو ChatGPT | على جهازك أو في تطبيق المزود، متصلاً بلوحتك على `https://cloud.example.com/mcp/admin` | [وصّل عميل ذكاء اصطناعي](https://nexcmp.com/ar/docs/configure-with-ai/mcp-admin/) |
| **التكوين كتعليمات برمجية (Configuration as code)** | أنت أو برنامج نصي | ملف YAML وأمر `nexcmp config` على الخادم (أو صفحة الاستيراد/التصدير) | [التكوين كتعليمات برمجية](https://nexcmp.com/ar/docs/configure-with-ai/config-as-code/) |

تستدعي الطرق الثلاث نفس الأدوات وتمر عبر طبقة الأمان نفسها، لذا يمكنك دمجها: صغ تكوينًا بمساعدة مساعد، وقم بتصديره كملف YAML، وراجعه في محرر النصوص الخاص بك ثم قم تطبيقه لاحقاً.

## نموذج الأمان {#safety-model}

| القاعدة | ماذا يعني ذلك بالنسبة لك |
|---|---|
| **النطاقات** | يقتصر المفتاح أو الاتصال على النطاقات التي تحددها (`admin:read`، `catalog:write`، `infra:write`، `billing:write`، `customers:write`، `settings:write`، `ai:write`، `secrets:write`). بدون نطاق، يتم رفض المكالمة. راجع [Admin API keys](https://nexcmp.com/ar/docs/configure-with-ai/admin-api-keys/#scopes). |
| **Expiry** | تنصرم صلاحية كل مفتاح وكل اتصال: من 1 إلى 90 يوماً للمفاتيح التي تنشئها، و30 يوماً بشكل افتراضي. تستمر رمز وصول OAuth لمدة ساعة واحدة. |
| **تقييد عناوين IP وحد المعدل** | يمكن تقييد المفتاح بنطاقات عناوين IP وعدد محدد من الاتصالات في الدقيقة (120 افتراضياً). |
| **التأكيد على خطوتين** | الإجراءات التي تنقل أموالاً، أو تحذف بيانات، أو تغير بيانات اعتماد الدفع، أو تغير أمان تسجيل الدخول تعرض معاينة أولاً ولا تفعل شيئاً حتى توافق عليها. داخل AI Chat، كل تغيير هو بطاقة تأكيد تضغط عليها بنفسك. |
| **أمور لا تستطيع المفاتيح فعلها أبداً** | إنشاء مسؤولين، أو تغيير المصادقة الثنائية (2FA)، أو إنشاء مفاتيح أو إلغاؤها، أو تسجيل الدخول كعميل، أو النسخ الاحتياطي، أو الاستعادة، أو تحديث لوحة التحكم، وما شابه. تتطلب هذه العمليات وجودك كمسؤول. |
| **سجل النشاطات** | يتم تسجيل كل مكالمة، سواء سمح بها أو رفضها، مع المفتاح، العميل، الأداة، عنوان IP والنتيجة. راجع System › Settings › API & AI agents › Activity. |
| **لا يتم إرجاع الأسرار أبداً** | يمكن تعيين كلمات المرور ومفاتيح API والرموز المميزة ولكن لا يمكن قراءتها مرة أخرى أبداً. الإجابات التي تراها الذكاء الاصطناعي تظهر فيها مخفية. |
| **تثبيتات التجربة للقراءة فقط** | في لوحة تجريبية، يتم رفض كل عملية كتابة باستخدام `demo_read_only`. |

::: important ما يمكن للذكاء الاصطناعي قراءته
باستخدام `admin:read`، يمكن للمساعد قراءة أسماء العملاء، وعناوين البريد الإلكتروني، والأرصدة، وسجلات الفوترة. عندما تستخدم مصدر ذكاء اصطناعي يعمل لدى مزود (OpenAI، Anthropic، Google، OpenRouter)، تُرسل تلك البيانات إلى ذلك المزود للإجابة عن سؤالك. امنح المساعد أقل مجموعة ممكنة من الصلاحيات التي يحتاجها، واختر مصدراً تثق به في التعامل مع تلك البيانات.
:::

## البدء السريع {#quick-start}

1. سجل الدخول إلى لوحة التحكم وافتح **AI Chat**. إذا لم يكن هناك أي مصدر ذكاء اصطناعي متصلاً بعد، فافتح **System › Settings › AI accounts** وقم بربط واحد (انظر [AI accounts and subscriptions](https://nexcmp.com/ar/docs/configure-with-ai/ai-accounts-and-subscriptions/)).
2. اكتب "Check my setup progress" واضغط على Enter. يقرأ المساعد [Setup progress checklist](https://nexcmp.com/ar/docs/configure-with-ai/setup-checklist/) ويخبرك بما تبقى.
3. اطلب منه تنفيذ الخطوة التالية. راجع كل بطاقة تأكيد واضغط على **Confirm** لتطبيقها.

لإلقاء نظرة أوليّة على ما يمكنك طلبه، راجع [Example prompts](https://nexcmp.com/ar/docs/configure-with-ai/example-prompts/).

![صفحة AI Chat مع محادثة، ونتيجة أداة، وبطاقة تأكيد](https://nexcmp.com/ar/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## الحدود والملاحظات {#limits-notes}

- **العرض التجريبي وللقراءة فقط.** الصفحات مرئية على اللوحة التجريبية، ولكن لا يمكن حفظ أي شيء هناك.
- **لا يوجد غلاف للأوامر (Shell).** يمكن للمساعد فقط استدعاء أدوات الإدارة المدرجة في [Connect an AI client](https://nexcmp.com/ar/docs/configure-with-ai/mcp-admin/#tools). ولا يمكنه تشغيل الأوامر على الخادم.
- **وحدات الشبكة والتوجيه** (BGP وXDP والواجهات وNAT وما شابه) هي للقراءة فقط بالنسبة للذكاء الاصطناعي، والمناطق الحساسة مثل حسابات المسؤولين والنسخ الاحتياطي والتحديثات مغلقة تماماً أمام المفاتيح.
- **الأسعار** بالدولار الأمريكي: أسعار الخُطط بالدولار في الساعة، والأرصدة بالسنت.
- **التكلفة.** تُدفع تكلفة إجابات الذكاء الاصطناعي لمصدر الذكاء الاصطناعي الذي تتصل به (استخدام API، أو اشتراكك الخاص). يمكنك في AI Chat تعيين حد أقصى للإنفاق اليومي. بالنسبة لنموذج ترخيص NexCMP راجع https://nexcmp.com/pricing.

## استكشاف الأخطاء وإصلاحها {#troubleshooting}

| العَرَض | السبب | الحل |
|---|---|---|
| يقول AI Chat إنه لم يتم توصيل أي مصدر ذكاء اصطناعي | لم يتم إعداد أي مصدر لحساب المسؤول الخاص بك | افتح System › Settings › AI accounts وقم بتوصيل مصدر. |
| يجيب المساعد بـ `insufficient_scope` | يفتقر المفتاح أو الاتصال إلى الصلاحية اللازمة لتلك الأداة | أنشئ مفتاحاً بالصلاحية المطلوبة، أو أعد الاتصال وحددها في شاشة الموافقة. راجع [Admin API keys](https://nexcmp.com/ar/docs/configure-with-ai/admin-api-keys/#errors). |
| يعرض كل تغيير بطاقة تأكيد | متوقع في AI Chat | اضغط على **Confirm** للتطبيق أو **Reject** للإلغاء. |
| تفشل عمليات الكتابة مع `demo_read_only` | اللوحة في وضع التجربة | استخدم تثبيتاً غير تجريبي. |