الموارد: البيانات التي يقرأها النموذج

بعد الأدوات تأتي الموارد: بيانات للقراءة فقط يقدّمها خادمك إلى النموذج باعتبارها سياقًا، مثل ملف أو سجل أو قيمة إعداد. 📄

لا تغيّر الموارد العالم أبدًا. فهي تعرض فقط معلومات يستطيع النموذج قراءتها، كما يجلب طلب GET صفحةً دون تعديل أي شيء.

يُعنون كل مورد باستخدام URI، مثل file:///notes.txt أو config://app. ويخبر المخطط والمسار العملاء بدقة بما يطلبونه.

في Python، تضع على الدالة المزخرف @mcp.resource() وتمرّر إليه URI الخاص بها. وتُرجع الدالة المحتوى كلما قرأ عميل ذلك URI.

ما يُرجعه موردك يصبح المحتوى الذي يقرؤه النموذج. وتعمل السلاسل النصية العادية جيدًا للملاحظات والإعدادات وأي مستند صغير.

يحمل المورد أيضًا نوع MIME مثل text/plain أو application/json. وهو يخبر العميل بكيفية تفسير وحدات البايت التي يتلقاها.

تكون الموارد عادةً متحكَّمًا بها من التطبيق. إذ يختار تطبيق المضيف أو المستخدم الموارد التي ستُرفق، بدلًا من أن يجلبها النموذج من تلقاء نفسه.

يمكن للعميل أن يطلب من خادمك سرد موارده. وتتيح خطوة الاكتشاف هذه للمضيف عرض المستندات التي يمكنه إدراجها في السياق للمستخدم.

لجلب مورد، يرسل العميل طلب read مع URI. يشغّل خادمك الدالة المطابقة ويُرجع المحتوى الحالي.

الموارد الجيدة هي الأشياء التي تريد من الذكاء الاصطناعي أن يراها دون أن يشغّلها: ملف README، أو صفًا من قاعدة بيانات، أو ناتج سجل، أو أحدث الإعدادات.

اختبار بسيط: إذا كان الشيء ينفّذ شيئًا، فاجعله أداة؛ وإذا كان يقدّم معلومات للقراءة فقط، فاجعله موردًا. إجراء مقابل سياق.

لنتأكد من الغرض من المورد.

رائع! المورد هو سياق للقراءة فقط، له معرّف URI ونوع MIME. يسرد العملاء الموارد ويقرؤونها، ويحصل النموذج على المعلومات من دون تشغيل أي شيء. ✅