ما هي المتغيرات

المتغيرات هي قيم مُسمّاة يُخزِّنها وولفيش في config.json ضمن مصفوفة variables. تحتوي على مفاتيح API والتوكنات والأسرار التي تحتاجها القدرات أثناء التشغيل. أعدّها في الإعدادات > المتغيرات.

الهيكل

كل متغير يحتوي على ثلاثة حقول:

الحقل	النوع	الوصف
`name`	string	المُعرِّف المُستخدم للإشارة إلى المتغير (مثلاً `OPENAI_API_KEY`)
`value`	string	القيمة أو السر الفعلي
`sensitive`	boolean	عندما تكون true، تُخفى القيمة في واجهة المستخدم

{
  "variables": [
    {
      "name": "OPENAI_API_KEY",
      "value": "sk-proj-abc123...",
      "sensitive": true
    },
    {
      "name": "GITHUB_TOKEN",
      "value": "ghp_xxxxxxxxxxxx",
      "sensitive": true
    },
    {
      "name": "BRAVE_API_KEY",
      "value": "BSA-xxxxxxxxxx",
      "sensitive": true
    },
    {
      "name": "NOTION_TOKEN",
      "value": "ntn_xxxxxxxxxx",
      "sensitive": true
    },
    {
      "name": "DEFAULT_BRANCH",
      "value": "main",
      "sensitive": false
    }
  ]
}

علامة الحساسية

عندما تكون sensitive بقيمة true، تُعرَض قيمة المتغير كـ •••••• في واجهة الإعدادات. هذا للراحة في الواجهة فقط — لا يُخفي أو يستبعد القيمة من الوكيل.

علّم أي بيانات اعتماد أو توكن أو مفتاح API كحساس لإخفائه في الواجهة. المتغيرات غير الحساسة مخصصة للإعدادات غير السرية مثل أسماء الفروع ومعرفات المشاريع أو تسميات البيئات.

كيف يستخدم الوكيل المتغيرات

كل متغير — بما فيها المعلّمة كحساسة — يظهر كنص عادي في موجه النظام داخل كتلة <variables> في كل دور:

- OPENAI_API_KEY = sk-proj-abc123... (sensitive)
- GITHUB_TOKEN = ghp_xxxxxxxxxxxx (sensitive)
- BRAVE_API_KEY = BSA-xxxxxxxxxx (sensitive)
- DEFAULT_BRANCH = main

تسمية (sensitive) هي تلميح للوكيل بعدم إظهار القيمة في ردوده — لكنها لا تُخفي أو تحجب القيمة الفعلية. هذا بالتصميم: المتغيرات هي الآلية لإعطاء النموذج اللغوي بيانات الاعتماد التي يحتاج لاستخدامها مباشرة (مثل تمرير مفتاح API كوسيط لأمر shell). الوكيل يستخدمها تلقائياً. إذا احتاجت مهمة مفتاح API ووُجد متغير مطابق، يستخدمه بدون سؤال.

إذا خزّنت سراً كمتغير، فسيراه النموذج اللغوي كنص عادي. هذا مقصود — يحتاج الوكيل القيمة ليعمل بها. استخدم المتغيرات لبيانات الاعتماد التي يحتاج الوكيل للرجوع إليها مباشرة. لبيانات الاعتماد التي تتولاها الإضافات بنفسها (Google OAuth، رمز Notion، إلخ)، استخدم صفحات إعدادات التكاملات بدلاً من ذلك — تلك لا تُرسل أبداً إلى النموذج اللغوي.

القيم مُخزَّنة كنص عادي في config.json. وولفيش يعمل محلياً أولاً ومساحة العمل ملكك. إذا كنت تتحكم في إصدارات مساحة العمل، أضف config.json إلى .gitignore.

المتغيرات مقابل متغيرات البيئة

المتغيرات ليست متغيرات بيئة النظام. تختلف بطرق مهمة:

	متغيرات وولفيش	متغيرات بيئة النظام
النطاق	مساحة عمل وولفيش فقط	جلسة نظام التشغيل بالكامل
قابلة للنقل	نعم، تنتقل مع مساحة العمل	لا، مرتبطة بالجهاز
تُدار بواسطة	واجهة الإعدادات أو config.json	ملف تهيئة الصدفة أو إعدادات النظام
متاحة لـ	الوكيل (عبر موجه النظام)	جميع العمليات

إذا احتجت قيمة متاحة لكل من وولفيش وأدوات أخرى على نظامك، اضبطها كمتغير وولفيش ومتغير بيئة نظام في نفس الوقت. لا يتعارضان.

المتغيرات الشائعة

المتغير	يُستخدم بواسطة
`OPENAI_API_KEY`	مزود OpenAI الاحتياطي
`GITHUB_TOKEN`	قدرة GitHub (طلبات السحب، المشكلات، المستودعات)
`BRAVE_API_KEY`	قدرة البحث في الويب
`NOTION_TOKEN`	تكامل Notion
`GOOGLE_API_KEY`	تكامل Google Workspace
`TELEGRAM_BOT_TOKEN`	قناة Telegram

إضافة متغير

عبر واجهة الإعدادات
عبر config.json

افتح الإعدادات > المتغيرات
انقر إضافة متغير
أدخل الاسم والقيمة وفعّل الحساسية إذا لزم الأمر
انقر حفظ

عدّل brain/config.json مباشرة وأضف إدخالاً إلى مصفوفة variables:

{
  "name": "MY_API_KEY",
  "value": "your-key-here",
  "sensitive": true
}

يلتقط وولفيش التغيير في دورة المحادثة التالية (لا حاجة لإعادة التشغيل).

ابدأ هنا

المفاهيم الأساسية

القدرات

القنوات

النماذج

التكاملات

الذاكرة والتعلم

التكوين

التشخيص

توسيع وولفيش

التطوير

المتغيرات

ما هي المتغيرات

الهيكل

علامة الحساسية

كيف يستخدم الوكيل المتغيرات

المتغيرات مقابل متغيرات البيئة

المتغيرات الشائعة

إضافة متغير

​ما هي المتغيرات

​الهيكل

​علامة الحساسية

​كيف يستخدم الوكيل المتغيرات

​المتغيرات مقابل متغيرات البيئة

​المتغيرات الشائعة

​إضافة متغير

ما هي المتغيرات

الهيكل

علامة الحساسية

كيف يستخدم الوكيل المتغيرات

المتغيرات مقابل متغيرات البيئة

المتغيرات الشائعة

إضافة متغير