ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارتحليل · على الرادارHabr AI→ المصدر

خريطة موقع لوكيل الذكاء الاصطناعي خفّضت النص المنزَّل بنسبة 58%، لكن الرموز زادت 3,5%

اسأل وكيلاً عن سعر البطاطس المقلية، وسيسلّمه الموقع القائمة كاملة. ابتكر فريق Deckard مولّداً باسم agent-sitemap يقسّم الموقع إلى ملاحظات Markdown مترابطة بروابط، تشبه جدول المحتويات. مع هذه الخريطة أجرى Claude Code 6 طلبات بدلاً من 9، ونزّل نصاً أقل بنسبة 58%، لكن الرموز المُدخلة زادت بنسبة 3,5%. لذلك ينبغي قياس التوفير بالرموز والذاكرة المؤقتة (الكاش)، لا بحجم الصفحات.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
خريطة موقع لوكيل الذكاء الاصطناعي خفّضت النص المنزَّل بنسبة 58%، لكن الرموز زادت 3,5%
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1حجم النص المنزَّل 24 627 حرفاً مقابل 58 439 بدون الخريطة
الرموز المُدخلة 64 987 مقابل 62 811العدّاد يجمع الكاش أيضاً
الكود مفتوح بترخيص MITnpx agent-sitemap https://example.com

عندما تطلب من وكيل ذكاء اصطناعي دخول موقع مطعم ومعرفة سعر حصة صغيرة من البطاطس المقلية، يفتح الإنسان قسم «القائمة» ويجد السطر المطلوب مباشرة. أما الوكيل فيعمل بطريقة مختلفة: تمنحه الأداة صفحة HTML أو نصاً منقّى أو لقطة شاشة، وتعرض عليه القائمة كاملة، فتدخل البرغر والمشروبات في السياق مع البطاطس. جرّب فريق Deckard حل هذه المشكلة بفهرس موجّه للوكلاء، ونشر مولّداً مفتوح المصدر باسم agent-sitemap. في قياس تجريبي، نزّل Claude Code مع هذه الخريطة نصاً أقل بنسبة 58% (24 627 حرفاً بدلاً من 58 439)، لكن الرموز المُدخلة، أي الحجم الذي قرأه النموذج وتدفع مقابله، زادت بنسبة 3,5%. والخلاصة للمطوّر: تقليص حجم الصفحات المنزَّلة لا يعني بالضرورة توفيراً في تكلفة الطلبات إلى النموذج.

كيف تعمل الخريطة

يخبر ملف sitemap.xml بالصفحات الموجودة في الموقع، لكنه لا يُظهر مكان البطاطس داخل القائمة. أما ملف llms.txt فيمكنه وصف الروابط وتقديم نسخ Markdown من الصفحات، غير أن القائمة الطويلة تبقى طويلة بعد الانتقال إليها، وكل ما تغيّر أنها بلا HTML.

يعمل المولّد بطريقة مختلفة: ينشئ ملف Markdown منفصلاً لكل قسم. يقود الفهرس (index.md) إلى بطاقة الصفحة، وتقود البطاقة، وفيها مقدمة وقائمة بالأقسام، إلى ملاحظة القسم، وتقود الملاحظة إلى المواد المجاورة. يفتح الوكيل الفهرس، ويدخل «القائمة»، ثم يختار «البطاطس والمقبلات» بحسب الوصف، ولا يقرأ البرغر والمشروبات. وتحتفظ الملاحظة بعنوان الصفحة الأصلية، ليستشهد الوكيل به ويتحقق من السعر. ويكتب المولّد الروابط نفسها في graph.json لمن يقرأ الخريطة من كوده الخاص.

المدخلات هي ملفات HTML وMarkdown محلية، أو موقع له sitemap.xml خاص به. ويُقسَّم النص بحسب العناوين من المستوى الثاني (##). بعض الروابط موجود أصلاً في المستند: الصفحة تحتوي على أقسام، وقسم يليه قسم آخر، وربما أشار المؤلف بنفسه إلى صفحة مجاورة. أما الروابط الناقصة فتُستنتج بمقارنة الكلمات بين الصفحات (TF-IDF والتشابه الجيبي). وهنا قد تظهر تطابقات خاطئة: فكلمة «التوصيل» تتكرر بالقدر نفسه في التعرفة وفي قواعد الإرجاع. لذلك يمكن تفعيل مرحلة تستخدم LLM تكتب شروحاً قصيرة للملاحظات وتستبعد جزءاً من الروابط التي وُجدت بالكلمات. وتبقى الروابط التي وضعها المؤلف كما هي.

ماذا أظهر القياس

يتضمن README الخاص بالمشروع تشغيلاً تجريبياً: سؤالان عن موقع Deckard، إجابتاهما مدفونتان داخل مقالات طويلة. بدأ Claude Code إما من الصفحة الرئيسية أو من فهرس الخريطة، وكان بإمكانه استخدام curl، وكان يعلم أن الموقع يقدّم Markdown. وتحقق نموذج من صحة الإجابات بالمقارنة مع إجابات مرجعية محددة مسبقاً، واحتُسبت الإجابات الأربع كلها صحيحة.

مع الخريطة أجرى الوكيل 6 طلبات HTTP بدلاً من 9، ونزّل 24 627 حرفاً بدلاً من 58 439. في سؤال developer بلغت الرموز 33 029 مقابل 31 828 بدون الخريطة، وفي سؤال ship بلغت 31 958 مقابل 30 983. المجموع 64 987 مقابل 62 811، أي زيادة بنحو 3,5%.

يفسّر المؤلف هذا التباين بنفسه. فعدّاد الأحرف يحسب محتوى ردود HTTP فقط، بينما يشمل عدّاد الرموز المُدخلة كل السياق الآخر الذي يتلقاه النموذج في كل خطوة. كذلك يجمع الاختبار الرموز المُدخلة العادية والكتابة في الكاش والقراءة منه، مع أن أسعارها مختلفة. لذلك يُظهر الجدول كمية النص التي قدّمها الموقع، لكنه لا يُظهر تكلفة الإجابة. ولفهم التكلفة ينبغي النظر في مسارات الوكيل وفي تقرير الرموز بحسب الفئات كلٌّ على حدة.

وثمة تحفظ آخر: التسمية «نحو N رمز» بجوار الرابط تُحسب بعدد الأحرف، بمعاملات مختلفة للأبجدية السيريلية وللنص الآخر، ودون استخدام المُرمِّز (tokenizer) الخاص بنموذج بعينه. ويشمل التقدير النص الأساسي فقط، مع أن الملف يحتوي أيضاً على عناوين وبيانات وصفية وروابط، وقد تكون هذه في الملاحظة القصيرة أطول من القسم نفسه.

ماذا تفعل عملياً

ينبغي استخلاص النتائج بحذر: فهذا تشغيل واحد، وسؤالان، ووكيل واحد. وقد يسلك مساعد مزوّد ببحث ويب عادي ومتصفح مساراً مختلفاً. ويفتقر القياس إلى حالتي مقارنة: llms.txt بصفحات Markdown كاملة (لرؤية أثر تنظيف HTML وحده)، والصفحة الصحيحة مباشرة. فإذا كانت الصفحة تتألف من فقرتين، فالمسار عبر الفهرس والبطاقة شبه مؤكد أنه أطول من قراءتها كاملة.

ولإجراء اختبار خاص بك، ينصح المؤلف بأخذ 10–30 سؤالاً حقيقياً وتكرار كل سؤال عدة مرات في ظروف متطابقة. على أن تكون إجابات بعضها في قسم واحد، وبعضها يتطلب عدة صفحات، وبعضها لا جواب له في الموقع أصلاً. والمطلوب قياسه: صحة الإجابة ووجود رابط المصدر، وعدد الطلبات، وحجم النص المنزَّل، والزمن، والتكلفة المالية. ويُفضَّل تسجيل زمن تحقق النموذج من الإجابات بشكل منفصل.

التشغيل بسيط: الأمر npx agent-sitemap https://example.com ينشئ دليل ai. يُنشر هذا الدليل بجوار الموقع، ويُتحقق من أن /ai/index.md يُفتح، ثم يُمرَّر هذا العنوان إلى الوكيل صراحةً. عندها لا تختلط نتيجة التنقل عبر الخريطة بسؤال هل عثر الوكيل على الخريطة أصلاً.

والمخاطر معروفة أيضاً. فقد تقع القاعدة والاستثناء في ملاحظتين مختلفتين، فيجيب الوكيل إجابة صحيحة نصفها فقط. وعنوان «معلومات إضافية» لا يقول شيئاً عن المحتوى. وقد تتأخر نسخة Markdown عن الموقع، ولذلك من الأفضل الرجوع في الأسعار إلى الصفحة الحية أو API. كما أن نص الملاحظات يأتي من الخارج، مثل أي صفحة ويب، ولا يجوز اعتبار التعليمات داخله أوامر من المستخدم. الكود مفتوح بترخيص MIT، واسم المستودع agent-sitemap.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول كيف تعمل الخريطة؟

يخبر ملف sitemap.xml بالصفحات الموجودة في الموقع، لكنه لا يُظهر مكان البطاطس داخل القائمة. أما ملف llms.txt فيمكنه وصف الروابط وتقديم نسخ Markdown من الصفحات، غير أن القائمة الطويلة تبقى طويلة بعد الانتقال إليها، وكل ما تغيّر أنها بلا HTML. يعمل المولّد بطريقة مختلفة: ينشئ ملف Markdown منفصلاً لكل قسم. يقود الفهرس (index.md) إلى بطاقة الصفحة، وتقود البطاقة، وفيها مقدمة وقائمة بالأقسام، إلى ملاحظة القسم، وتقود الملاحظة إلى المواد المجاورة.

ما أبرز التفاصيل حول ماذا أظهر القياس؟

يتضمن README الخاص بالمشروع تشغيلاً تجريبياً: سؤالان عن موقع Deckard، إجابتاهما مدفونتان داخل مقالات طويلة. بدأ Claude Code إما من الصفحة الرئيسية أو من فهرس الخريطة، وكان بإمكانه استخدام curl، وكان يعلم أن الموقع يقدّم Markdown. وتحقق نموذج من صحة الإجابات بالمقارنة مع إجابات مرجعية محددة مسبقاً، واحتُسبت الإجابات الأربع كلها صحيحة. مع الخريطة أجرى الوكيل 6 طلبات HTTP بدلاً من 9، ونزّل 24 627 حرفاً بدلاً من 58 439.

ما أبرز التفاصيل حول ماذا تفعل عملياً؟

ينبغي استخلاص النتائج بحذر: فهذا تشغيل واحد، وسؤالان، ووكيل واحد. وقد يسلك مساعد مزوّد ببحث ويب عادي ومتصفح مساراً مختلفاً. ويفتقر القياس إلى حالتي مقارنة: llms.txt بصفحات Markdown كاملة (لرؤية أثر تنظيف HTML وحده)، والصفحة الصحيحة مباشرة. فإذا كانت الصفحة تتألف من فقرتين، فالمسار عبر الفهرس والبطاقة شبه مؤكد أنه أطول من قراءتها كاملة. ولإجراء اختبار خاص بك، ينصح المؤلف بأخذ 10–30 سؤالاً حقيقياً وتكرار كل سؤال عدة مرات في ظروف متطابقة.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…