أمثلة على التوجيهات

الموقع في لوحة الإدارة: AI Chat (/agent) أو زر Ask AI العائم في أي صفحة إدارة. تعمل المطالبات نفسها في أي عميل ذكاء اصطناعي متصل عبر MCP.

الوظيفة

توضح هذه التوجيهات طريقة الاستعلام. يوضح كل منها ما يفعله المساعد خلف الكواليس، والنطاقات التي يحتاجها (لعميل خارجي أو مفتاح)، والأماكن التي يُطلب منك فيها الموافقة. استبدل قيم الأمثلة بقيمك الخاصة.

لا تقم أبداً كتابة سر في نص الدردشة

بالنسبة لكلمات المرور ومفاتيح API والرموز، استخدم حقل Secret بجوار إدخال AI Chat (التفاصيل). لا يرى الذكاء الاصطناعي سوى عنصر نائب يمثل السر، وليس القيمة. مع عميل ذكاء اصطناعي خارجي يمر السر عبر ذلك العميل، لذا يُفضل إدخاله في لوحة الإدارة.

تحقق من موقعك الحالي

Check my setup progress and tell me the next three things to do, in order.

يستدعي المساعد setup_checklist وsystem_health (النطاق admin:read) ويجيب بناءً على الحالة الفعلية. انظر Setup progress checklist.

الإعداد الأول

Help me finish the initial setup. Go through the checklist, explain each open step
in one sentence, ask me for what you need, and show me every change before it is applied.

هذا يماثل مطالبة MCP initial-setup. يتطلب admin:read بالإضافة إلى نطاقات الخطوات التي تقبلها. توقع ظهور بطاقة تأكيد لكل تغيير في AI Chat.

إضافة مجموعة Proxmox VE

I want to sell servers from my Proxmox VE cluster at https://pve.example.com:8006.
Add it, test the connection, create a zone called "New York" in the US, attach the cluster
to it, and then propose starter plans.

ماذا يحدث:

1. يطلب المساعد معرف رمز API (user@realm!tokenid) وسره. ضع السر في حقل Secret. أنشئ رمزاً محدوداً أولاً: Proxmox VE.
2. يستدعي proxmox_add وproxmox_test وzone_create وproxmox_attach_zone.
3. يقترح خططاً مع plans_from_offerings وينتظر موافقتك (انظر المثال التالي).

النطاقات: infra:write، secrets:write، catalog:write، admin:read.

إنشاء جدول خطط بهامش ربح 40%

Suggest a starter plan table from my CloudStack offerings. My costs are $4 per vCPU per month,
$2 per GB of RAM per month and $0.08 per GB of disk per month. Use a 40% margin, show me the
table with cost, price per month and price per hour, and create the plans only after I approve.

يستدعي المساعد plans_from_offerings باستخدام margin_pct 40 وتكاليفك. الهامش هو نسبة سعر البيع التي تمثل ربحاً: عند نسبة 40%، الخطة التي تبتلعك $60 تباع بـ $100. الاستدعاء الأول يعيد معاينة فقط. عندما توافق، فإنه يستدعي الأداة مرة أخرى باستخدام apply=true، مما ينشئ الخطط في خطوة واحدة ويطلب تأكيداً واحداً لأن الأسعار متضمنة. بالنسبة لـ Proxmox، فإنه يستخدم backend_id وقائمة أحجام افتراضية (1، 2، 2 و 4 vCPU). النطاقات: catalog:write، admin:read. راجع Plans.

تكوين البريد الإلكتروني وإرسال رسالة اختبار

Configure outgoing email with smtp.example.com, port 587, STARTTLS, user "mailer@example.com",
sender name "Example Cloud", sender address "no-reply@example.com". Use my Secret field for the
password "smtp_password". Then send a test email to admin@example.com.

يستدعي المساعد smtp_get و smtp_configure و smtp_test ويخبرك ما إذا تم قبول الرسالة. النطاقات: settings:write، secrets:write. راجع SMTP and e-mail templates.

إعداد Stripe

Set up Stripe in test mode. My publishable key is pk_test_XXXX. Use the secret key and the
webhook secret from my Secret field (names stripe_secret_key and stripe_webhook_secret).
Then test the credentials and tell me which webhook URL I must add in Stripe.

payment_configure هو دائماً إجراء من خطوتين: ترى معاينة مع إخفاء القيم السرية وتوافق عليها. ثم يتحقق payment_test من بيانات الاعتماد مع Stripe. النطاقات (Scopes): billing:write، secrets:write. انتقل إلى وضع التشغيل المباشر (live mode) فقط بعد إجراء دفعة اختبارية. راجع Stripe.

تفعيل تنبيهات تيليجرام

Add my Telegram chat 123456789 for admin alerts. The bot token is in my Secret field as
telegram_bot_token. Send a test message.

يستدعي المساعد telegram_configure وtelegram_test. النطاقات (Scopes): settings:write، secrets:write. راجع Telegram notifications.

العثور على عميل وإضافة رصيد

Find the customer with e-mail customer@example.com, show me their balance and servers,
and add $10.00 of credit because of the outage on Monday.

يستدعي المساعد customers_search وcustomer_get (للقراءة فقط)، ثم customer_adjust_balance مع delta_cents 1000 وسبب محدد. يتطلب هذا دائماً موافقتك: تقول بطاقة التأكيد "changes a customer balance" وتُظهر المبلغ والسبب الذي سيتم تسجيله في سجل التدقيق (audit log). النطاقات (Scopes): admin:read، billing:write.

تصدير إعداداتي

Export my whole configuration as YAML. Do not include secrets. Then tell me which settings
differ from a typical new installation.

يستدعي المساعد config_export. يتم استبدال الأسرار بمراجع secret://. احفظ النتيجة كـ nexcmp.yaml واحتفظ بها في نظام التحكم الإصداري. راجع Configuration as code. النطاق (Scope): admin:read.

كتابة موجّهات (Prompts) جيدة

• اعرض الهدف والوقائع: الأسماء، الأسعار، عناوين البريد الإلكتروني. لا تقم بلصق الأسرار.
• اطلب معاينة أولاً لأي شيء يكلف مالاً أو يحذف بيانات.
• اطلب من المساعد "قراءة القيمة الحالية قبل تغييرها". التعليمات المدمجة تفعل ذلك بالفعل.
• إذا بدا رد ما خاطئاً، فاسأل "ما هي الأداة التي استدعيتها وبأي وسائط؟". تُظهر بطاقات الأدوات في AI Chat كليهما.

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

العَرَض	السبب	الحل
يقول المساعد إنه لا يملك أداة لشيء ما	نطاق (Scope) هذه الأداة غير ممنوح، أو أن الإجراء مغلق أمام الذكاء الاصطناعي	تحقق من Admin API keys، أو قم بذلك في لوحة المشرف.
يطلب منك لصق كلمة مرور	تجاهل النموذج التعليمات	ارفض؛ استخدم حقل السر (Secret) أو أدخل القيمة في لوحة المشرف.
لا شيء يتغير بعد "تنفيذ ذلك" (do it)	التغييرات في انتظار تأكيدك	قم بالتمرير إلى بطاقة التأكيد واضغط على Confirm.
تم إنشاء الخطط بسعر لم تكن تتوقعه	كانت التكاليف أو الهامش في الموجه (prompt) خاطئة	قم بتعديل الخطط على صفحة الخطط أو اطلب من المساعد إعادة تسعيرها؛ تتطلب تغييرات الأسعار تأكيداً.