# توليد نص

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

## المدخلات

### المدخلات العامة

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
| --- | --- | --- | --- | --- |
| `وضع العينة` | يتحكم في ما إذا كان يتم استخدام أخذ عينات عشوائي أثناء توليد النص. عند ضبطه على "on"، تصبح معاملات أخذ عينات إضافية متاحة. عند ضبطه على "off"، تولّد العقدة النص دون أخذ عينات عشوائي. | DYNAMIC_COMBO | نعم | `"on"`<br>`"off"` |
| `clip` | نموذج CLIP المستخدم لتقطيع المطالبة إلى وحدات رمزية وتوليد النص. | CLIP | نعم | N/A |
| `الموجه` | المطالبة النصية التي توجّه التوليد. يدعم هذا الحقل أسطرًا متعددة والمطالبات الديناميكية. القيمة الافتراضية سلسلة فارغة. | STRING | نعم | N/A |
| `صورة` | صورة اختيارية يمكن استخدامها إلى جانب المطالبة النصية للتأثير على النص المولّد. | IMAGE | لا | N/A |
| `فيديو` | إطارات الفيديو كدفعة صور. يُفترض أن تكون بمعدل 24 إطارًا في الثانية؛ ويُؤخذ منها عينات فرعية بمعدل 1 إطار في الثانية داخليًا. | IMAGE | لا | N/A |
| `صوت` | إدخال صوتي اختياري يمكن استخدامه إلى جانب المطالبة النصية للتأثير على النص المولّد. | AUDIO | لا | N/A |
| `الحد الأقصى للطول` | الحد الأقصى لعدد الرموز التي سيولّدها النموذج. القيمة الافتراضية 512. | INT | نعم | 1 إلى 32768 |
| `التفكير` | التشغيل في وضع التفكير إذا كان النموذج يدعم ذلك. القيمة الافتراضية False. | BOOLEAN | لا | True or False |
| `استخدام القالب الافتراضي` | استخدام المطالبة النظامية/القالب المدمج إذا كان النموذج يمتلك واحدًا. القيمة الافتراضية True. هذا معامل متقدم. | BOOLEAN | لا | True or False |
| `mtp` | فك ترميز تخميني باستخدام رأس التنبؤ متعدد الرموز الخاص بنقطة الحفظ. ليس له تأثير بدون أوزان MTP. `"auto"` تكيّف عمق المسودة وعرضها وفق تطابقات الرموز الملاحظة وتكلفة التنفيذ، و`"2"` إلى `"5"` تثبت عمقًا ثابتًا، وأوضاع `tree` تثبت العرض والعمق معًا. يبقى الناتج المُعين بعينات موزعًا بشكل صحيح لكنه يختلف عن ناتج غير MTP لنفس البذرة (الافتراضي: `"auto"`). | COMBO | لا | `"auto"`<br>`"off"`<br>`"2"`<br>`"3"`<br>`"4"`<br>`"5"`<br>`"tree2s1"`<br>`"tree2s2"`<br>`"tree3s1"`<br>`"tree4s1m8"` |
| `system_prompt` | يستبدل المطالبة النظامية في قالب المحادثة الخاص بالنموذج. يُتجاهل عند عدم استخدام القالب الافتراضي. وصّل إدخال STRING بدلًا من كتابته في العقدة (القيمة الافتراضية: فارغ). | STRING | لا | N/A |

### معاملات أخذ العينات (عندما تكون `sampling_mode` على "on")

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
| --- | --- | --- | --- | --- |
| `temperature` | يتحكم في عشوائية المخرجات. القيم الأقل تجعل المخرجات أكثر قابلية للتنبؤ، والقيم الأعلى تجعلها أكثر إبداعًا. القيمة الافتراضية 0.7. | FLOAT | نعم | 0.01 إلى 2.0 |
| `top_k` | يحدّ مجموعة أخذ العينات بأفضل K من الرموز التالية الأكثر احتمالًا. القيمة 0 تعطّل هذا الفلتر. القيمة الافتراضية 64. | INT | نعم | 0 إلى 1000 |
| `top_p` | يستخدم أخذ عينات النواة: يحتفظ بأصغر مجموعة من الرموز الأكثر احتمالًا التي يصل احتمالها التراكمي إلى هذه القيمة. القيمة الافتراضية 0.95. | FLOAT | نعم | 0.0 إلى 1.0 |
| `min_p` | يحدّد حدًا أدنى للاحتمال كي تُعتبر الرموز. القيمة الافتراضية 0.05. | FLOAT | نعم | 0.0 إلى 1.0 |
| `repetition_penalty` | يعاقب الرموز التي جرى توليدها بالفعل لتقليل التكرار. القيمة 1.0 لا تطبّق أي عقوبة. القيمة الافتراضية 1.05. | FLOAT | نعم | 0.0 إلى 5.0 |
| `seed` | رقم يُستخدم لتهيئة مولّد الأرقام العشوائية للحصول على نتائج قابلة للتكرار. القيمة الافتراضية 0. | INT | نعم | 0 إلى 18446744073709551615 |
| `presence_penalty` | يعاقب الرموز الجديدة بناءً على ما إذا كانت قد ظهرت في النص حتى الآن، مما يشجّع النموذج على الحديث عن موضوعات جديدة. القيمة الافتراضية 0.0. | FLOAT | لا | 0.0 إلى 5.0 |

**ملاحظة:** تكون معاملات أخذ العينات أعلاه نشطة ومرئية في واجهة العقدة فقط عندما تكون `sampling_mode` مضبوطة على "on". وعندما تكون `sampling_mode` مضبوطة على "off"، لا تتوفر أي معاملات لأخذ العينات وتولّد العقدة النص دون أخذ عينات عشوائي.

**ملاحظة:** عندما يحتوي النص المولّد على كتلة استدلال (يبدأ بـ `<think>` أو تنتهي المطالبة به)، تُعاد الاستدلال بشكل منفصل: يحمل `generated_text` الإجابة، ويحمل `thinking` الاستدلال بعد إزالة وسم البداية. وإلا فإن `generated_text` يحمل كل ما أنتجه النموذج ويكون `thinking` فارغًا.

## المخرجات

| اسم المخرجات | الوصف | نوع البيانات |
| --- | --- | --- |
| `generated_text` | النص الذي يولّده النموذج بناءً على المطالبة المدخلة والصورة أو الفيديو أو الصوت الاختياري، مع فصل أي كتلة استدلال في مخرَج `thinking`. | STRING |
| `thinking` | كتلة الاستدلال التي أنتجها النموذج، بعد إزالة وسم البداية `<think>`. تكون فارغة عندما لا ينتج النموذج أي كتلة استدلال. | STRING |

> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextGenerate/ar.md)

---
**Source fingerprint (SHA-256):** `e0854b0ce5a41e195a2634f4739c22c7dd0df1f2309cb8a02b506b8791bf3bee`
