إنتقل إلى المحتوى الرئيسي

العمل مع الذكاء الاصطناعي

يمكن الآن استهلاك توثيق Android Macro بطريقة أكثر ملاءمة لنماذج اللغة الكبيرة (LLM).

يمنحك ذلك ثلاثة أنماط مختلفة للوصول:

  1. افتح أي صفحة توثيق كملف Markdown عادي بإضافة .md إلى الرابط
  2. حمّل فهرس التوثيق المنسّق من /llms.txt

مرآة Markdown​

أصبح لكل مسار في التوثيق مرآة بنسخة Markdown.

مثال:

  • صفحة HTML: https://androidmacro.com/docs/basic/how-to-use
  • صفحة Markdown: https://androidmacro.com/docs/basic/how-to-use.md

يكون هذا مفيدًا عندما:

  • تريد لصق صفحة في نموذج لغوي (LLM)
  • تريد من وكيل (agent) جلب النسخة النقية من التوثيق بدلًا من تحليل HTML
  • تريد نصًا ثابتًا لسياق التلقين (prompt)

llms.txt​

يوفّر جذر الموقع فهرس llms.txt:

https://androidmacro.com/llms.txt

هذا الملف عبارة عن خريطة منسّقة للتوثيق مخصصة للاستخدام مع نماذج اللغة. وهو يوجّه النماذج والأدوات نحو أهم الصفحات أولًا، ثم يربطها بنسخ Markdown من التوثيق.

ملفات ذات صلة:

  • https://androidmacro.com/llms-full.txt
  • https://androidmacro.com/llms-sitemap.txt

استخدمها كالتالي:

  • llms.txt كنقطة انطلاق منسّقة
  • llms-full.txt عندما تريد تصديرًا واحدًا كبيرًا لمجموعة التوثيق
  • llms-sitemap.txt عندما تريد قائمة مناسبة للآلة بروابط Markdown

لماذا يساعد ذلك​

صُمّم توثيق HTML للبشر. أمّا نماذج اللغة فعادةً ما تعمل بشكل أفضل مع:

  • Markdown بدلًا من HTML الكامل للصفحة
  • فهرس منسّق بدلًا من الزحف الأعمى إلى كل المسارات

لهذا السبب يعتمد هذا الإعداد كلا الأمرين:

  • مرايا .md للوصول إلى المحتوى الخام
  • اكتشاف بنمط llms.txt

البنية الحالية​

تُولَّد مرايا Markdown وملفات llms.txt داخل مخرجات static الخاصة بـ Docusaurus، لذا يتم نشرها معًا مع موقع التوثيق.

ملاحظات​

  • تحصل صفحات الفئات الرئيسية أيضًا على مرايا Markdown، مثل https://androidmacro.com/docs/reference/storage.md
  • صُمّم Markdown المُولَّد للاستهلاك من قِبل نماذج اللغة، لذا تُستبدل بعض العناصر التفاعلية المدمجة بملاحظات قصيرة
  • أعد بناء موقع التوثيق بعد تغيير المحتوى لتبقى مرايا Markdown وملفات llms.txt متزامنة

صفحات ذات صلة​