ما هو معامل guidelines في Grok API؟ تعديل المحتوى المخصص، موضحاً

أضافت xAI معامل guidelines إلى Grok text API، مما يتيح لك إخبار النموذج بتعديل فئات محتوى محددة بشكل أكثر صرامة أثناء الكتابة. إذا كنت تبني على Grok وتحتاج إلى تحكم أكثر دقة في المخرجات الحساسة، فهذا هو أول ضابط تعديل محتوى داخل الطلب تُطلقه xAI للنصوص. إليك بالضبط ما يفعله معامل guidelines في Grok API، والفئات التي يغطيها، وكيفية ضبطه، وحدود الطلبات والأخطاء التي يجب التخطيط لها.

ما الذي يفعله معامل guidelines

معامل guidelines هو مصفوفة تضيفها إلى طلب Grok text API لتغيير كيفية تعامل النموذج مع فئات محتوى معينة. لكل فئة تدرجها، تختار سلوكاً محسّناً؛ يتبع Grok بعد ذلك التوجيهات أثناء كتابة استجابته، بأسلوبه الخاص. تأتي الاستجابة بنفس شكل الاستجابة العادية — لا يوجد غلاف إضافي لتحليله.

أمران مهمان هنا:

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

تم توثيق هذه الميزة في ملاحظات إصدار Grok API في أكتوبر، وبحسب إعلان xAI، فهي متاحة لجميع عملاء الـ API.

الفئات والسلوكيات المدعومة

كل إدخال في guidelines يحتوي على ثلاثة حقول: type (دائماً "policy")، وcategory، والسلوك behavior الذي تريده. حالياً السلوك الوحيد المتاح هو decline.

تصف الوثائق هذه السلوكيات على مستوى عالٍ وتشير إلى أن xAI قد تُنقّح التفاصيل بمرور الوقت. الخلاصة العملية: decline هو توجيه ناعم داخل الاستجابة، وليس مصنّفاً صارماً يُعيد خطأً — يُعيد Grok صياغة إجابته للبقاء ضمن الفئة التي حددتها.

كيفية ضبط guidelines على طلب

تمرر guidelines كمصفوفة على المستوى الأعلى. في Responses API تجلس جانب معاملاتك الأخرى؛ في Chat Completions تذهب على نفس مستوى messages. إليك طلب يضبط كلاً من violence وnsfw على decline:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Write a short story about a knight.",
    "guidelines": [
      { "type": "policy", "category": "violence", "behavior": "decline" },
      { "type": "policy", "category": "nsfw", "behavior": "decline" }
    ]
  }'

ملاحظات SDK التي تُربك المطورين:

• OpenAI Python SDK: الحقل غير معرّف، لذا مرره في extra_body.
• OpenAI JavaScript SDK: أرسل guidelines مع معاملات طلبك الأخرى.
• xAI Python SDK: يخزّن chat.create التوجيهات على المحادثة، لذا كل استدعاء sample() يرسلها تلقائياً — لا تحتاج إلى تكرارها بنفسك.

واجهات الـ API التي تدعمه — وتلك التي لا تدعمه

يُقبل guidelines في Chat Completions وResponses API وchat.create في xAI Python SDK. إلا أنه لا يعمل في بعض الحالات، ويرفض الـ API تلك الطلبات بخطأ 400 قبل تشغيل النموذج:

• النماذج متعددة الوكلاء، مثل grok-4.20-multi-agent.
• الإكمالات المؤجلة.
• طلب بلا أدوات من جانب الخادم ولا مرفقات ملفات يضبط أيضاً stop، أو يضبط n أكبر من 1.

نظراً لأن الفحص يحدث مسبقاً، فإن الطلب المرفوض لا يكلفك أي استنتاج نموذجي — لكنه يعني أنك بحاجة إلى التقاط هذه الأخطاء في الكود.

الأخطاء المتوقعة

يتحقق الـ API من صحة guidelines قبل تشغيل النموذج ويُعيد خطأً إذا لم يتمكن من تطبيقها:

في xAI Python SDK، تُثير فئة أو سلوك غير معروف خطأ ValueError قبل إرسال الطلب؛ تعود الأخطاء الأخرى كحالة gRPC INVALID_ARGUMENT.

لماذا يهم هذا المطورين

تم تموضع Grok تاريخياً كنموذج أكثر تساهلاً، وكانت استدعاءات text API تفتقر سابقاً إلى أي ضوابط تعديل داخل الطلب — كنت تأخذ السلوك الافتراضي للنموذج أو تُصفّي المخرجات بنفسك. معامل guidelines هو مسار وسط: توجيه على مستوى الفئة تُعلنه مباشرة، دون استدعاء تعديل منفصل ودون منطق حدود في كودك الخاص.

إنه ضيّق عمداً الآن — ثلاث فئات، سلوك واحد (decline)، نصوص فقط. لروبوت محادثة يواجه العملاء حيث لا يمكنك المخاطرة بمخرجات جنسية أو عنيفة بشكل صريح، فإن الإعلان عن nsfw وviolence كـdecline هو حاجز حماية بسطر واحد. لأي شيء أكثر صرامة أو قابلية للتدقيق، ستظل بحاجة إلى فحوصات مخرجات خاصة بك، إذ يُعيد decline صياغة الاستجابة بدلاً من حجبها بشكل صارم — ولا يزال يتعين عليك التعامل مع رفضات 400/422 المذكورة أعلاه.

بناء سير عمل ذكاء اصطناعي معدَّل مع وكلائك الخاصين

ضوابط المحتوى مثل معامل guidelines في Grok هي قطعة واحدة من تشغيل الذكاء الاصطناعي بأمان في بيئة الإنتاج — الجزء الأصعب هو ربط مخرجات النموذج بمهام حقيقية وموافقات وأدوات. Eigent هو تطبيق "Cowork" متعدد الوكلاء مفتوح المصدر يُشغّل قوة عمل ذكاء اصطناعي محلياً، حتى تتمكن من الاحتفاظ بالمطالبات والبيانات الحساسة على جهازك الخاص بينما يتعامل الوكلاء مع سير العمل مع نقاط تفتيش يشارك فيها الإنسان. اطّلع على كيفية ملاءمة ذلك لفريق صغير في إدارة شركة من شخص واحد مع وكلاء الذكاء الاصطناعي، أو نزّل Eigent لتجربته.