كيف تكتب طلباً ينجح من أول مرة

مقال مجاني 6 دقيقة

مقدمة

في أربعة دروس عملنا أربعة أشياء مختلفة تماماً: مسح أخبار من الإنترنت، ولوحة بيانات (Dashboard) تفاعلية من ملف مبيعات، وأجوبة من ملفات PDF، وشرح مبسّط لموضوع صعب محفوظ في ملف HTML.

أربع مهام، وأربعة مجالات، ونفس الـ Agent بدون أي إعدادات إضافية.

هناك شيء مشترك بينها كلها، وهو مش الـ Agent ولا الأدوات. المشترك هو شكل الطلب. عندما ترجع إلى الطلبات التي كتبناها في الدروس الأربعة، ستجدها كلها مبنية على نفس الهيكل.

هذا الدرس يفكّك هذا الهيكل، حتى تتوقف عن التخمين وتبدأ بكتابة طلبات تعمل من أول مرة. وبعدها سنفتح قائمة أفكار أبعد بكثير من الأربعة التي رأيناها.

الأهداف التعليمية

بنهاية هذا الدرس، ستكون قادراً على:

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

أولاً: في كل طلب ناجح خمسة عناصر

خذ الطلب الذي كتبناه في درس لوحة البيانات وفكّكه. كتبناه هناك بالإنجليزية، وهذه ترجمته:

اقرأ الملف Sales 2025.csv، وابنِ لي لوحة بيانات تفاعلية بصيغة HTML فيها الإيرادات لكل شهر وأكثر المنتجات مبيعاً وفلاتر، واحفظها باسم dashboard.html.

العنصر من المثال
1. المصدر — من وين يأخذ المعلومة الملف Sales 2025.csv
2. المهمة — ماذا يعمل بها «اقرأ» و«ابنِ»
3. الشكل — شكل النتيجة لوحة بيانات تفاعلية بصيغة HTML
4. التفاصيل — ماذا تريد أن ترى بالضبط الإيرادات لكل شهر، وأكثر المنتجات مبيعاً، والفلاتر
5. المكان — وين يحفظ النتيجة الملف dashboard.html

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

نصيحة
لا تحتاج أن تكتب العناصر بترتيب معيّن أو بصيغة معيّنة. الـ Agent يفهم العربية والإنجليزية بنفس الدرجة، فاكتب بالأسهل عليك. اكتب جملة عادية، ثم راجعها بعينك واسأل: هل العناصر الخمسة موجودة؟

ثانياً: المصدر — أربع طرق تدلّه على الشغل

هذا العنصر هو الذي يقصّر فيه أغلب الناس، مع أنه أسهلها:

1. الرمز @. اكتب @ في الـ Terminal (الشاشة التي تكتب فيها طلباتك للـ Agent)، فتظهر لك قائمة ملفاتك. رأينا هذا في درس الـ PDF مع @Zaytoun Documents. هذه أسرع وأدق طريقة، لأنه لا مجال فيها للتخمين الخاطئ.

2. المجلد كله. طول ما فتحت الـ Agent داخل مجلد، فهو يصل إلى كل ما فيه. طلب مثل «اقرأ كل ملفات الـ PDF في هذا المجلد» يعمل بدون أن تسمّي أي ملف.

3. صورة بالسحب والإفلات. خذ لقطة شاشة واسحبها إلى الـ Terminal، زي ما عملنا مع صفحة كتاب الـ PMP. الـ Agent يقرأ الصورة.

4. الإنترنت. عندما لا تعطيه ملفاً، يذهب إلى الإنترنت، زي درس مسح الأخبار. ويمكنك أن تحدد له المواقع والشركات التي تريدها بالضبط.


ثالثاً: الشكل — لا تقبل بأول شيء يظهر

هذه أكثر نقطة تفرق بين نتيجة تستخدمها، ونتيجة تقرأها ثم تنساها.

  • تقرير على الشاشة — سريع، للأسئلة العابرة
  • ملف HTML — الأفضل في عصر الـ Agents زي ما رأينا. تفتحه في المتصفح، ويقبل التعديل المباشر، ولا يحتاج أي برنامج
  • جدول — للمقارنات
  • ملف صوتي — لما تسمعه في الطريق
  • لوحة بيانات — عندما تكون الأرقام أهم من الكلام

والأهم من هيك: قل له الشكل الذي تريده من أول طلب. طلب مثل «اشرح لي الـ Agentic Loop» يعطيك فقرة على الشاشة. أما هذا الطلب فيعطيك شيئاً تحتفظ به:

اشرح لي الـ Agentic Loop بأسلوب مبسّط، واحفظ الشرح في الملف explain.html.


رابعاً: التعديل جزء من الشغل، مش فشل

في درس الشرح رأينا الفكرة بوضوح: ظهرت النتيجة ولم تعجبنا، فطلبنا ألواناً فاتحة، ثم طلبنا لغة أبسط، واستمررنا لحد ما صارت مضبوطة.

الـ Agent لا يملّ. لا داعي أن تكتب طلباً مثالياً من أول مرة. اكتب طلباً معقولاً، وانظر إلى النتيجة، ثم عدّل.

وهناك ثلاث حركات توفّر عليك وقتاً كثيراً:

اشتغل على أكثر من شيء في نفس الوقت. افتح Terminal ثانياً في نفس المجلد، وابدأ فيه جلسة جديدة. لن يحدث تعارض: كل Terminal زي موظف مستقل، والاثنان يصلان إلى نفس الملفات.

ارجع إلى شغل قديم. اكتب / واختر Resume، فترى كل الجلسات التي عملتها في هذا المجلد، وتكمل من حيث توقفت.

أغلق الجلسة وافتح جلسة جديدة لكل مهمة جديدة. خلط مهمتين في جلسة واحدة يخلط الـ Context، ويضعف الجوابين.

تحذير
إذا صحّحت للـ Agent شيئاً وتريده أن يتذكره في كل المرات القادمة مش فقط هسا، قل له صراحة: «حدّث الـ Memory الخاصة بك». والـ Memory هي التعليمات الدائمة التي يتذكرها بين جلسة وأخرى. بدون هذا الطلب، يبقى التصحيح داخل الجلسة الحالية فقط.

خامساً: أفكار أبعد من الدروس الأربعة

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

للمكتب والشغل اليومي

  • قارن نسختين من عقد، واطلب منه جدولاً بالفروقات فقط. شغل يأخذ ساعة، وينتهي في دقيقة.
  • مجلد صور فواتير ← جدول فيه التاريخ والمبلغ والمورّد، جاهز للمحاسب.
  • قارن ثلاثة عروض أسعار من ثلاثة موردين في جدول واحد، مع توصية مبنية على الأرقام.
  • رتّب مجلداً فوضوياً: أسماء منطقية للملفات، وتصنيفها في مجلدات فرعية.

للتوظيف والمسار المهني

  • سيرتك الذاتية مقابل إعلان وظيفة: وين تتطابق، ووين الفجوة، وماذا لازم تعدّل.
  • عشرون سيرة ذاتية مقابل وصف وظيفة ← ترتيب مع سبب لكل ترتيب.
  • رسالة تغطية مبنية على سيرتك وعلى الإعلان، مش قالب جاهز.

للدراسة والمعرفة

  • فصل من كتاب ← ملخص + بطاقات مراجعة + أسئلة تختبر فهمك.
  • بحث أو ورقة علمية ← اشرحها لطالب ثانوي، ثم اشرحها لمختص. نفس المصدر، بمستويين.
  • صفحة قوانين أو شروط ← لقطة شاشة ← شرح بالعربية بلغة واضحة.

للأعمال والمتابعة

  • راقب منافسيك: مواقعهم وأسعارهم وإعلاناتهم، مع تقرير أسبوعي بالفروقات.
  • مراجعات عملائك ← تصنيف للشكاوى المتكررة، مرتبة حسب عدد تكرارها.
  • بيانات مبيعاتك ← مش فقط لوحة بيانات، بل سؤال مباشر أيضاً: «ليش كان شهر آذار أقل من شباط؟»
مهم
القاعدة التي تجمع كل هذا: قوّة الـ Agent في الملفات، مش في المحادثة. أي شات يتحدث معك، لكن الفرق أن الـ Agent يقرأ ملفاتك الحقيقية ويكتب ملفات حقيقية على جهازك. أول سؤال تسأله في أي مهمة جديدة: وين الملفات؟

خلاصة الدرس

  1. في كل طلب ناجح خمسة عناصر: المصدر، والمهمة، والشكل، والتفاصيل، والمكان. عندما تكون النتيجة خاطئة، ابحث عن العنصر الناقص.

  2. الرمز @ هو أسرع وأدق طريقة لتحديد المصدر. ويمكنك أيضاً أن تسحب صورة، أو تعطيه المجلد كله، أو تتركه يبحث في الإنترنت.

  3. حدّد شكل النتيجة من أول طلب. ملف HTML غالباً أنفع من فقرة على الشاشة: تفتحه، وتعدّله، ويبقى معك.

  4. التعديل جزء طبيعي من الشغل. الـ Agent لا يملّ، وأول نتيجة نادراً ما تكون الأخيرة.

  5. شغّل أكثر من Terminal، وارجع إلى الشغل القديم عبر Resume. كل جلسة زي موظف مستقل، وكلها تصل إلى نفس الملفات.

  6. إذا أردت أن يبقى التصحيح معك، اطلب منه تحديث الـ Memory. بدون ذلك، يضيع التصحيح مع نهاية الجلسة.

  7. أول سؤال في أي مهمة: وين الملفات؟ هنا بالضبط الفرق بين الـ Agent والشات.


في القسم الجاي: لاحظت أنك في كل درس كنت تعيد نفس التفاصيل والتفضيلات؟ رح نوقف هذا التكرار: نعلّم الـ Agent أسلوبك مرة واحدة، ونحفظه كـ Skill يستدعيها بكلمة.

يلا، نلتقي بالقسم الجاي!