تكامل وكيل الذكاء الاصطناعي
صُممت هذه الوثائق ليقرأها وكلاء الذكاء الاصطناعي والأدوات المعتمدة على LLM ومساعدو المطورين، وليس البشر فقط. ثلاثة موارد تجعل ذلك ممكنًا:
- نسخة Markdown عادية من كل صفحة.
- فهرس
llms.txtلكل لغة، يرسم خريطة الموقع بالكامل. - شريط إجراءات أعلى كل صفحة، يرسل الصفحة إلى مساعد بنقرة واحدة.
نسخة Markdown من كل صفحة
أضف .md إلى نهاية أي رابط صفحة في متصفحك أو عميل HTTP:
| رابط الصفحة | رابط Markdown |
|---|---|
/developers/api-reference/post-processes | /developers/api-reference/post-processes.md |
/products/sign-up/multi-accounts | /products/sign-up/multi-accounts.md |
/capabilities/liveness | /capabilities/liveness.md |
/pt-BR/capabilities/liveness | /pt-BR/capabilities/liveness.md |
الاستجابة هي محتوى Markdown للصفحة، بدون تنقل أو شريط جانبي أو غلاف HTML. لكل لغة نسختها الخاصة من Markdown، تحت بادئة اللغة نفسها التي تستخدمها الصفحة.
فهرس llms.txt
لكل لغة ملف llms.txt بتنسيق llms.txt:
| اللغة | رابط الفهرس |
|---|---|
| الإنجليزية | /llms.txt |
| البرتغالية (البرازيل) | /pt-BR/llms.txt |
| الإسبانية | /es/llms.txt |
تتبع جميع اللغات الأخرى النمط نفسه: بادئة اللغة الخاصة بصفحاتها، يليها /llms.txt.
يعكس الملف تنقل الموقع:
- قسم لكل تبويب في شريط التنقل العلوي. تأتي بعدها تبويبات Dual API، ويحمل كل منها اسم التبويب متبوعًا بـ
(Dual API). - الشريط الجانبي لكل تبويب في صورة قوائم متداخلة، بالترتيب نفسه الموجود في الموقع.
- رابط إلى نسخة Markdown من كل صفحة، يليه وصف الصفحة عندما يكون لها وصف.
يمكن للوكيل أن يبدأ من م لف llms.txt بلغة القارئ ليفهم كيف تنتظم الوثائق. ثم يفتح صفحات Markdown التي يحتاجها فقط.
إجراءات الصفحة
تحتوي كل صفحة من صفحات الوثائق، باستثناء الصفحة الرئيسية، على شريط إجراءات أسفل عنوانها:
- نسخ الصفحة — ينسخ Markdown الصفحة إلى الحافظة.
- Markdown — يفتح نسخة Markdown من الصفحة في تبويب جديد.
- فتح في — يفتح الصفحة في مساعد ذكاء اصطناعي: ChatGPT أو Claude أو Gemini أو Perplexity أو Grok أو Copilot. يتلقى المساعد موجِّهًا يحتوي على رابط Markdown للصفحة. في Gemini وCopilot، يُنسخ الموجِّه إلى الحافظة، ثم تلصقه أنت في المحادثة.
- نسخ رابط Markdown — ينسخ الرابط المطلق لنسخة Markdown، للصقه في وكلاء البرمجة مثل Cursor أو Codex أو Claude Code.
على سطح المكتب، تكون نسخ الصفحة وMarkdown وChatGPT وClaude أزرارًا في الشريط، وتوجد الإجراءات الأخرى ضمن المزيد. على الجوال، توجد الإجراءات الأخرى في القائمة التي يفتحها السهم المجاور لـ نسخ الصفحة.
الاكتشاف التلقائي
يعلن HTML كل صفحة عن المورِدين في <head> الخاص به، لذا يستطيع أي وكيل يزور أي صفحة العثور عليهما دون تعليمات:
<link rel="alternate" type="text/markdown" href="/capabilities/liveness.md">
<link rel="llms-txt" href="/llms.txt">
- يشير
rel="alternate"إلى نسخة Markdown من الصفحة الحالية. - يشير
rel="llms-txt"إلى ملفllms.txtبلغة الصفحة.
حالات الاستخدام
- مساعدو البرمجة بالذكاء الاصطناعي — أعطِ مساعدك ملف
llms.txtأو رابط.md، ليعمل بسياق دقيق ومحدَّث حول نقطة نهاية أو قدرة أو حالة استخدام. - موجِّهات LLM — اجلب صفحة بتنسيق Markdown وأدرجها في موجِّه للتلخيص أو الترجمة أو توليد الكود.
- مسارات RAG — استخدم ملف
llms.txtكقائمة مصادر، وروابط.mdكمصدر استيعاب لأنظمة التوليد المعزز بالاسترجاع. - السكريبتات الآلية — حلِّل محتوى الوثائق دون الحاجة إلى برنامج تجريف HTML.
أمثلة
اجلب فهرس الوثائق باللغة الإنجليزية:
curl https://developer.unico.io/llms.txt
اجلب نسخة Markdown من صفحة المصادقة:
curl https://developer.unico.io/dual-api/developers/api-reference/authentication.md
كلتا الاستجابتين نص عادي، جاهز للإدخال في أي LLM أو مسار معالجة.