إضافة تفاصيل ملموسة
الأرقام والأسماء والتنسيقات والأمثلة التي تجعل مخرجات الذكاء الاصطناعي أكثر تحديدًا
إضافة تفاصيل ملموسة درس مجاني في AI Prompt Engineering على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Prompt Engineering، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Prompt Engineering 4 دروس في المجموع.
التفاصيل الملموسة هي نقاط ارتكاز
التفاصيل الملموسة هي معلومات محددة وقابلة للقياس والتحقق. وهي تثبت مخرجات النموذج في وضعكم الفعلي بدلًا من تفسير عام.
من دون نقاط ارتكاز، يُنشئ النموذج مخرجات للمستخدم المتوسط التخيلي. أما مع نقاط الارتكاز، فيُنشئ مخرجات لكم.
عدد الكلمات كقيد ملموس
يُعد عدد الكلمات أحد أبسط التفاصيل الملموسة وأكثرها فعالية التي يمكنكم إضافتها. قارنوا بين المثالين:
- غامض: 'اكتب وصفًا قصيرًا'
- ملموس: 'اكتب وصفًا من 75 كلمة'
سيعدّ النموذج الرموز المميزة ويستهدف العدد الذي حددتموه. وإذا أخطأ قليلًا، يمكنكم مطالبته بإعادة العد بدقة. ويزيل تحديد عدد الكلمات فئات كاملة من عمليات إعادة الكتابة.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write a product description for a noise-cancelling travel pillow in exactly 60 words. '
'After the description, output the word count in parentheses on a new line.'
)
}]
)
print(response.content[0].text)الجمهور المستهدف كتفصيل ملموس
يؤدي تحديد جمهور ملموس ومحدد إلى تغيير مفردات المخرجات وأمثلتها وعمقها تغييرًا كبيرًا.
- غامض: 'اشرح الشبكات العصبية'
- ملموس: 'اشرح الشبكات العصبية لمدير تسويق في شركة مدرجة على قائمة Fortune 500، ليست لديه خلفية في البرمجة لكنه يفهم الجداول المحورية في Excel'
تمنح المطالبة الثانية النموذج صورة ذهنية لقارئ حقيقي، وتتيح له معايرة مستوى التعقيد بدقة.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
concrete_audience_prompt = (
'Explain what a REST API is.\n\n'
'Audience: a non-technical product manager who uses Salesforce daily '
'and understands the concept of a form submission on a website. '
'They will use this explanation to brief their engineering team tomorrow. '
'Use one real-world analogy. Max 100 words.'
)
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': concrete_audience_prompt}]
)
print(response.choices[0].message.content)الكيانات المسماة بدلًا من التعميمات
يُخرج استخدام الكيانات المسماة — مثل أسماء المنتجات والشركات والأشخاص والتقنيات والتواريخ الحقيقية — النموذج من نطاق العموميات.
- غامض: 'اكتب تحليلًا تنافسيًا'
- ملموس: 'اكتب تحليلًا تنافسيًا لـ Notion مقابل Obsidian مقابل Roam Research، لمستخدم محترف يدير فريقًا موزعًا من 10 أشخاص، ويكتب يوميًا، ويحتاج إلى الوصول دون اتصال بالإنترنت'
تثبت الكيانات المسماة النموذج في المعرفة الواقعية التي اكتسبها من بيانات التدريب.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Compare FastAPI vs Flask vs Django REST Framework '
'for building a production API that will serve a React frontend. '
'Context: 2-person startup team, Python 3.11, needs async support, '
'expects < 50 ms response time, and will deploy on AWS Lambda. '
'Format: 3-column markdown table with rows: setup complexity, '
'async support, performance, learning curve, community size.'
)
}]
)
print(response.content[0].text)القيود الكمية
الأرقام واضحة ولا لبس فيها. وكلما كان لديكم متطلب رقمي، أدرجوه في المطالبة:
- اذكروا عددًا محددًا من العناصر بالضبط (لا تستخدموا 'بضعة' أو 'عدة')
- حد أقصى أو أدنى لعدد الكلمات أو الأحرف
- نسب أو معدلات محددة ('70% عملي، 30% نظري')
- قيود زمنية ('اشرحه كما لو كان لدي 3 دقائق لقراءة هذا')
- أهداف الأداء ('اقترح أساليب تحقق تعقيدًا زمنيًا قدره O(n)')
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Generate exactly 8 onboarding email subject lines for a B2B SaaS product. '
'Requirements:\n'
'- Exactly 8 lines, no more, no fewer\n'
'- Each subject line between 40 and 60 characters\n'
'- 4 must emphasize value, 4 must create urgency\n'
'- Label each line: [VALUE] or [URGENCY]\n'
'- No emojis\n'
'- No duplicate words across all 8 lines'
)
}]
)
print(response.choices[0].message.content)تحديد الموعد النهائي والإطار الزمني
يؤدي توفير سياق زمني إلى تغيير عمق المخرجات وتركيزها. أخبروا النموذج بموعد استخدام هذا المحتوى والقيود التي يفرضها ذلك:
- 'سيُرسل هذا البريد الإلكتروني بعد ساعتين — اجعله موجزًا'
- 'هذا مخصص لعرض أمام مجلس الإدارة يوم الاثنين — استخدم لغة على مستوى الإدارة التنفيذية'
- 'يجب أن ينجح هذا الشرح ضمن اجتماع يومي مدته 5 دقائق'
- 'اكتب هذا لفريق لديه 10 دقائق لمراجعته قبل مكالمة العميل'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=256,
messages=[{
'role': 'user',
'content': (
'Write a project status update for our AI chatbot project. '
'This will be read aloud at a 5-minute Monday morning stand-up. '
'The audience has zero technical background. '
'Talking time: max 2 minutes (approximately 300 words). '
'Cover: what we shipped last week, one current blocker, one upcoming milestone. '
'Tone: confident and factual. No jargon.'
)
}]
)
print(response.content[0].text)أمثلة محددة في الموجّه
يُعدّ إدراج أمثلة محددة على ما تريده أو ما لا تريده من أكثر الأساليب تأثيرًا. فالأمثلة توضّح للنموذج التنسيق والنبرة والأسلوب في آن واحد.
يمكنك تضمين:
- مثال على المخرجات المثالية (one-shot)
- أمثلة متعددة مع تسميات (few-shot)
- مثال على ما حدث بشكل خاطئ سابقًا (مثال سلبي)
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
prompt = '''
Write 3 feature announcement tweets for a new developer tool.
Here is an example of the style I want:
"We just shipped inline type errors in the editor. No more tab-switching to find
what broke. Your flow stays unbroken. Try it now: [link]"
Characteristics of this style:
- Opens with what shipped, not with excitement words
- Describes the user benefit in the second sentence
- Ends with a CTA
- No hashtags. No emojis. Under 200 characters.
New feature: autocomplete that learns from your codebase.
'''
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': prompt}]
)
print(response.choices[0].message.content)المفردات الخاصة بالمجال
يشير تضمين المصطلحات الخاصة بالمجال إلى مستوى الخبرة المتوقع في المخرجات.
- 'اشرح التخزين المؤقت' → استجابة عامة
- 'اشرح سياسة LRU لإخلاء البيانات في Redis لمهندس backend ينتقل من Memcached إلى Redis 7.x' → استجابة بمستوى الخبراء ومرتكزة إلى المجال
استخدم مفردات مجالك في الموجّه، وسيعكسها النموذج في المخرجات.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# Generic prompt vs domain-vocabulary prompt
generic = 'Explain caching strategies.'
domain_anchored = (
'Compare write-through, write-behind, and cache-aside patterns '
'for a microservices architecture using Redis 7.x as the cache layer and '
'PostgreSQL 15 as the source of truth. '
'Focus on consistency guarantees, latency tradeoffs, and failure modes. '
'Audience: senior backend engineers familiar with CAP theorem.'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{'role': 'user', 'content': domain_anchored}]
)
print(response.content[0].text)القيود على ما يجب استبعاده
تمنع القيود السلبية الملموسة (الاستبعادات) النموذج من التوجه إلى إجابات عامة متوقعة:
- 'لا تقترح حلولًا تتطلب مفتاح API مدفوعًا'
- 'لا تذكر المنافسين بأسمائهم'
- 'لا تستخدم الكلمتين leverage أو synergy'
- 'لا تُضمّن محتوى نظريًا — عملي فقط'
- 'استبعد الأساليب التي تتطلب أكثر من 5 دقائق للتنفيذ'
يزيد كل استبعاد من دقة المخرجات، لأنه يلغي مسارًا إضافيًا قد يؤدي إلى محتوى عام.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Suggest 5 ways to speed up a slow Python script. '
'EXCLUDE:\n'
'- Suggestions requiring third-party libraries (stdlib only)\n'
'- Suggestions about hardware upgrades\n'
'- Rewrites of the entire script\n'
'- Suggestions that take more than 30 minutes to implement\n'
'Each suggestion: one sentence describing what to do, one sentence on expected speedup.'
)
}]
)
print(response.choices[0].message.content)جمع العناصر كلها
لننشئ موجّهًا ملموسًا بالكامل خطوة بخطوة، بدءًا من: 'اكتب وصفًا وظيفيًا.'
- أضف الدور: 'لمهندس تعلّم آلي أول'
- أضف كيانًا مُسمّى: 'في شركة ناشئة للذكاء الاصطناعي من الفئة Series B في لندن'
- أضف عدد الكلمات: '350-400 كلمة'
- أضف الجمهور: 'للمرشحين الذين لديهم أكثر من 5 سنوات من الخبرة'
- أضف البنية: 'التنسيق: مقدمة، المسؤوليات (8 نقاط)، المتطلبات (5 نقاط)، المزايا الإضافية (3 نقاط)'
- أضف استبعادًا: 'لا تستخدم عبارات مبتذلة مثل fast-paced أو passionate'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
concrete_prompt = (
'Write a job description for a Senior ML Engineer position '
'at a Series B AI startup in London. '
'Target candidate: 5+ years ML experience, strong Python, familiar with LLMs. '
'Length: 350-400 words. '
'Structure:\n'
'1. 3-sentence company intro (no fluff — focus on product and mission)\n'
'2. Responsibilities: exactly 8 bullet points\n'
'3. Requirements: exactly 5 bullet points\n'
'4. Nice-to-haves: exactly 3 bullet points\n'
'EXCLUDE: phrases like "fast-paced", "passionate", "ninja", "rockstar", "self-starter".'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=600,
messages=[{'role': 'user', 'content': concrete_prompt}]
)
print(response.content[0].text)عادة إثراء الموجّه
طوّر عادة إثراء كل موجّه قبل إرساله. أجرِ جولة إثراء ذهنية سريعة:
- هل يمكنني استبدال أي كلمة مبهمة برقم؟
- هل يمكنني تسمية أداة أو تقنية أو شخص محدد؟
- هل يمكنني تحديد الجمهور بدقة أكبر؟
- هل يمكنني إضافة مثال على ما أريده؟
- هل يمكنني إضافة قيد واحد على الأقل يحدد ما لا ينبغي تضمينه؟
- هل يمكنني تحديد تنسيق المخرجات بدقة أكبر؟
حتى إثراء الموجّه بتفصيلين أو ثلاثة يحسّن جودة المخرجات بدرجة كبيرة.
# Prompt enrichment in code form: before/after comparison
before = 'Give me ideas for my presentation.'
after = (
'Generate 6 opening hook ideas for a 15-minute conference talk '
'titled "Why Your AI Prompts Are Failing You" at PyCon 2025. '
'Audience: Python developers, mostly backend, some ML experience. '
'Each hook: 2 sentences max. '
'Mix: 2 provocative statistics, 2 counterintuitive questions, 2 short stories. '
'EXCLUDE: "Did you know..." openers and rhetorical questions about the future of AI.'
)
print('BEFORE:', before)
print()
print('AFTER:', after)اختبار المعرفة
يرسل مؤسس شركة ناشئة الموجّه التالي: 'ساعدني في كتابة نص تسويقي.' أيّ موجّه مُعدّل يستخدم أكثر التفاصيل الملموسة فاعلية؟
إضافة التفاصيل الملموسة — مراجعة
تحوّل التفاصيل الملموسة الموجّهات المبهمة إلى تعليمات دقيقة. استخدم أساليب التحديد التالية:
- عدد الكلمات: استبدل «قصير/طويل» بأرقام دقيقة
- الكيانات المُسمّاة: منتجات وأدوات وشركات وأشخاص محددون
- الجمهور: الدور ومستوى الخبرة وما يعرفه مسبقًا
- القيود الكمية: عدد العناصر يساوي N تمامًا، أو نسبة N% من كل نوع
- مفردات المجال: استخدم مصطلحات المجال نفسه لتحديد العمق المتوقع
- الأمثلة: أوضح شكل المخرجات الجيدة
- الاستبعادات: سمِّ ما ينبغي للنموذج تجنبه
الأسئلة الشائعة
هل درس «إضافة تفاصيل ملموسة» مجاني؟
نعم — نص درس «إضافة تفاصيل ملموسة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Prompt Engineering، انتقل إلى CoddyKit PRO. تتضمن دورة AI Prompt Engineering 4 دروس في المجموع.
ماذا ستتعلم في «إضافة تفاصيل ملموسة»؟
الأرقام والأسماء والتنسيقات والأمثلة التي تجعل مخرجات الذكاء الاصطناعي أكثر تحديدًا تتمرن على AI Prompt Engineering مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ AI Prompt Engineering؟
لا تُشترط خبرة سابقة. AI Prompt Engineering على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «إضافة تفاصيل ملموسة»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس AI Prompt Engineering هذا؟
نعم. كل درس في AI Prompt Engineering يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- أهمية التحديد
- إزالة الغموض من المطالبات
- إضافة تفاصيل ملموسة
- مقارنة المطالبات الغامضة والمحددة