كيف تكتب طلب بيشتغل من أول مرة

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

مقدمة

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

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

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

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

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

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

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

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

خذ الطلب اللي كتبناه بدرس الـ Dashboard وفكّكه:

scan the file Sales 2025.csv and build for me an interactive HTML dashboard
with revenue per month, top products and filters, and save it as dashboard.html
العنصر بالمثال
1. المصدر — من وين ياخذ المعلومة Sales 2025.csv
2. المهمة — شو يعمل فيها scan و build
3. الشكل — شكل الناتج interactive HTML dashboard
4. التفاصيل — شو بدك تشوف بالضبط revenue per month, top products, filters
5. المكان — وين يحفظه dashboard.html

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

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

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

هاد العنصر اللي أغلب الناس بتقصّر فيه، مع إنه أسهلهم:

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

2. المجلد كله. طول ما فتحت الوكيل جوّا مجلد، هو بيوصل لكل اللي جوّاته. «اقرأ كل ملفات الـ PDF بهاد المجلد» بتشتغل بدون ما تسمّي ولا ملف.

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

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


ثالثاً: الشكل — لا تقبل بأول شي بيطلع

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

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

وأهم من هيك: قول له الشكل اللي بدك ياه من أول طلب. «اشرحلي الـ Agentic Loop» بتعطيك فقرة بالشاشة. «اشرحلي الـ Agentic Loop بأسلوب مبسّط واحفظه بملف explain.html» بتعطيك شي بتحتفظ فيه.


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

بدرس الشرح شفنا الفكرة بوضوح: طلعت النتيجة، ما عجبتنا، طلبنا Light Theme، طلبنا لغة أبسط، وضلّينا لحد ما ظبطت.

الوكيل ما بيمل. ما في داعي تكتب طلب مثالي من أول مرة — اكتب طلب معقول، شوف الناتج، وعدّل.

وثلاث حركات بتوفّر عليك وقت كثير:

اشتغل على أكثر من شي بنفس الوقت. افتح Terminal ثاني بنفس المجلد وشغّل Session جديدة. ما بيصير تعارض — كل Terminal زي موظف مستقل، والاثنين بيوصلوا لنفس الملفات.

ارجع لشغل قديم. اكتب / واختار Resume، وبتشوف كل الـ Sessions اللي عملتها بهاد المجلد وبترجع من وين ما وقفت.

سكّر وافتح Session جديدة لمهمة جديدة. خلط مهمتين بجلسة وحدة بيخلط السياق ويضعّف الجوابين.

تحذير
إذا صحّحت للوكيل شي وبدك يتذكّره لكل المرات الجاية مش بس هلأ، قوله صراحة «حدّث الـ Memory تبعك». غير هيك، التصحيح بيضل بحدود الجلسة الحالية.

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

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

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

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

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

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

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

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

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

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

خلاصة الدرس

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

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

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

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

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

  6. إذا بدك تصحيح يضل معك، قوله يحدّث الـ Memory — غير هيك بيروح مع الجلسة.

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


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

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