بناء المطالبات بوسوم XML
- لماذا تمنح الوسوم على طراز XML نموذج Claude حدوداً واضحة بين أجزاء المطالبة
- كيف تغلّف التعليمات والمستندات والأمثلة وقواعد التنسيق في وسوم مسمّاة
- كيف تطلب من Claude مخرجات موسومة يمكنك تحليلها بموثوقية
- متى تستخدم الوسوم — ومتى لا تفرط في استخدامها
عندما تخلط المطالبة بين التعليمات ومستند وأمثلة وسؤال، قد يمزجها النموذج معاً. الوسوم على طراز XML طريقة نظيفة لتسمية كل جزء — وClaude يتجاوب معها بشكل جيد بصورة خاصة.
الفكرة
غلّف كل قسم في وسم مسمّى حتى يكون واضحاً ما هو كل شيء:
بنية مطالبة موسومة
<instructions>
Summarize the document for a busy executive. Use only the document; if a fact
isn't there, say so.
</instructions>
<document>
{paste the long document here}
</document>
<format>
3 bullet points, then a one-line "decision needed".
</format>الوسوم مجرد نص تخترعه أنت — <document> و<example> و<context> و<rules> — لكنها تمنح النموذج حدوداً واضحة.
لماذا تساعد
- تفصل البيانات عن التعليمات — يصبح النموذج أقل ميلاً لإطاعة نص دخيل داخل مستند ملصوق (دفاع خفيف ضد حقن المطالبات — انظر /docs/security/prompt-injection).
- تقلل من "لقد تجاهل جزءاً من مطالبتي". كل جزء محدّد بوضوح.
- تجعل المخرجات أسهل في التحليل — يمكنك أن تطلب من Claude وضع إجابته في وسوم <answer> واستخراجها بموثوقية.
- تتكامل مع الأمثلة القليلة (/docs/prompting/few-shot) — غلّف كل مثال في <example>.
العوائد الأربعة بالتفصيل:
- تفصل البيانات عن التعليمات — يصبح النموذج أقل ميلاً لإطاعة نص دخيل داخل مستند ملصوق (دفاع خفيف ضد حقن المطالبات).
- تقلل من "لقد تجاهل جزءاً من مطالبتي". كل جزء محدّد بوضوح.
- تجعل المخرجات أسهل في التحليل — يمكنك أن تطلب من Claude وضع إجابته في وسوم
<answer>واستخراجها بموثوقية. - تتكامل مع الأمثلة القليلة — غلّف كل مثال في
<example>.
طلب مخرجات موسومة
Guided walkthrough1 of 3
- أخبر النموذج بالضبط أي وسوم يستخدم للاستدلال مقابل الإجابة النهائية.
- يمكن لشيفرتك التقاط محتوى <answer> فقط، متجاهلةً الاستدلال.
- تتناسب جيداً مع المخرجات المنظّمة (/docs/api/structured-output) عندما تحتاج إلى نتائج قابلة للقراءة آلياً.
طلب مخرجات موسومة
Put your reasoning in <thinking> tags and your final answer in <answer> tags.
عندها يمكن لشيفرتك التقاط محتوى <answer> فقط. يتناسب جيداً مع المخرجات المنظّمة عندما تحتاج إلى نتائج قابلة للقراءة آلياً.
نصائح
- كن متسقاً — افتح وأغلق كل وسم؛ وأعد استخدام الأسماء نفسها.
- سمِّ الوسوم بشكل ذي معنى (<contract> وليس <x>).
- لا تفرط في الوسم في المطالبات البسيطة — استخدم هذا عندما تكون هناك أجزاء متعددة متمايزة فعلاً.
- كن متسقاً — افتح وأغلق كل وسم؛ وأعد استخدام الأسماء نفسها.
- سمِّ الوسوم بشكل ذي معنى (
<contract>وليس<x>). - لا تفرط في الوسم في المطالبات البسيطة — استخدم هذا عندما تكون هناك أجزاء متعددة متمايزة فعلاً.