دليل إعداد LangSmith Tool Gateway: بيانات الاعتماد ومجموعات الأدوات والسياسات والموافقات للوكلاء
دخل LangSmith Tool Gateway مرحلة الإصدار التجريبي العام في 19 نوفمبر 2026. وهو ينقل بيانات الاعتماد والهوية والوصول الخاصة باستدعاءات أدوات الوكلاء إلى طبقة مُدارة واحدة. يعتمد هذا الدليل نموذج «يرى / يعمل بصفة / يسمح» (See / Act As / Allow) لشرح تسجيل خوادم MCP، وبناء مجموعات الأدوات، والاختيار بين الهوية لكل مستخدم وهوية مفتاح الخدمة، وإضافة سياسات الحظر والموافقة. كما يتناول الحدود الموثّقة والمواضع التي تتوقف عندها هذه الضوابط عن حمايتك.
ما هو LangSmith Tool Gateway ولماذا وُجد
LangSmith Tool Gateway طبقة أدوات مُدارة تتولى بيانات الاعتماد والهوية والوصول لكل استدعاء أداة يجريه الوكيل، وفق وصف LangChain نفسها. وهي تقع بين وكلائك وخوادم MCP التي يستدعونها، فلم يعد على كل وكيل أن يحسم هذه المسائل بنفسه.
أطلقت LangChain أداة Tool Gateway في إصدار تجريبي عام في 19 نوفمبر 2026، كما أفاد موقع Unite.AI. يتوفر الإصدار التجريبي ضمن خطتي LangSmith Plus وEnterprise. وعلى LangSmith Cloud يغطي مناطق GCP US وGCP EU وGCP APAC وAWS US، مع استبعاد Azure US.
خذ مثال شركة التجزئة الأمريكية الكبيرة التي تصفها LangChain في منشور الإطلاق: بنى فريقها الهندسي أكثر من 50 خادم MCP تكشف أكثر من ألف أداة. ولا ينبغي لأي وكيل منفرد أن يصل إلا إلى شريحة صغيرة معتمدة من هذا الفهرس، ببيانات اعتماد تلائم سياقه. هذا النوع من التشتت، حيث تتوزع الأدوات وبيانات الاعتماد على خوادم ووكلاء كثيرين، هو ما صُممت البوابة لإخضاعه لمجموعة واحدة من الضوابط.
ملاحظة قبل الدخول في التفاصيل. المنتجات التجريبية تتغير، وثمة تفاصيل تنفيذية عدة تهم الشيفرة العاملة: أسماء حقول الاستجابة، وإعدادات التهيئة، وصيغ نقاط النهاية، وترويسات المصادقة، ومتطلبات النقل، وتغطية الخطط للميزات الفردية. تستخدم الأمثلة أدناه عناصر نائبة لهذه التفاصيل. تحقّق من كل واحد منها في الوثائق الحالية وفي الاستجابات الفعلية أثناء الاختبار، وانسخ القيم كما هي بدلًا من التخمين.
نموذج الحوكمة «يرى / يعمل بصفة / يسمح» (See / Act As / Allow)
الصلاحية المفرطة (Excessive Agency)، وفق التعريف الذي يعتمده مشروع OWASP Gen AI Security، هي الثغرة التي تتيح لنموذج لغوي كبير اتخاذ إجراءات ضارة استجابةً لمخرجات غير متوقعة أو غامضة أو متلاعَب بها. وأسبابها الجذرية المعتادة ثلاثة: الوظائف المفرطة، والأذونات المفرطة، والاستقلالية المفرطة.
نربط كل سبب من هذه الأسباب الجذرية بأحد ضوابط البوابة، ونسمّي النتيجة See / Act As / Allow:
- يرى (See) (الوظائف المفرطة): ما الأدوات التي يراها هذا الوكيل؟ مجموعات الأدوات.
- يعمل بصفة (Act As) (الأذونات المفرطة): بيانات اعتماد مَن يحملها الاستدعاء؟ إعدادات الهوية.
- يسمح (Allow) (الاستقلالية المفرطة): هل ينبغي أن يُنفَّذ هذا الاستدعاء بعينه؟ سياسات الحظر والموافقة.
لا تعوّض أي طبقة عن الأخرى. فوكيل الاسترداد الذي يملك مجموعة من أداتين يظل يحمل كل ما تسمح به بيانات اعتماده. وإذا كانت بيانات الاعتماد هذه هي مفتاح خدمة الواجهة الخلفية، ولم تحظر أي سياسة أداةً مدمّرة، فإن المجموعة الصغيرة تكون قد ضيّقت القائمة دون أن تضيّق المخاطر.
كيف يمر استدعاء الأداة عبر البوابة
يتضمن استدعاء الأداة ثلاث خطوات مصادقة منفصلة، مشروحة بالكامل في صفحة How Tool Gateway works. ولأغراض التصميم تهم اثنتان منها أكثر من غيرهما. فالجهة المستدعية لا تصادق إلا مع LangSmith. ثم يختار Tool Gateway بيانات اعتماد مخزّنة ويستخدمها للمصادقة مع خادم MCP. ونتيجةً لذلك لا تحمل الجهة المستدعية رمز الخادم أو مفتاح API الخاص به أبدًا. إنه النمط نفسه الذي يتبعه وكيل بيانات الاعتماد الذي يُبقي مفاتيح API بعيدًا عن وكلاء الذكاء الاصطناعي: الوكيل يطلب، والوسيط يحتفظ بالسر.
يتوافق هذا التصميم مع إرشادات التفويض في مواصفة MCP. فعندما يستدعي خادم MCP واجهات API في المنبع، يستخدم رمزًا منفصلًا يصدره خادم التفويض في المنبع، ويجب ألا يمرّر الرمز الذي تلقاه من عميل MCP. كما ينبغي لخوادم التفويض أن تصدر رموز وصول قصيرة العمر للحد من أثر الرموز المسرّبة.
عندما لا يكون المستخدم قد ربط حسابه
إذا احتاج استدعاء ما إلى بيانات اعتماد مستخدم لم يربط حسابه بعد، فإن الاستدعاء يعيد رابط تسجيل دخول. العميل الذي يدعم استنباط عنوان URL في MCP يعرض الرابط على المستخدم. أما العملاء الآخرون فيتلقون استجابة HTTP 428 مع الرابط. وبعد أن يربط المستخدم حسابه، تستخدم الاستدعاءات اللاحقة بيانات الاعتماد المخزّنة.
نقترح أن يتعامل عميلك مع هذه الاستجابة بوصفها خطوة تسجيل دخول متوقعة لا خطأً. اعرض الرابط، وانتظر المستخدم، ثم أعد المحاولة مرة واحدة:
resp = call_tool(req)
if resp.status == 428:
link = sign_in_link_from(resp.body) # placeholder field name
show_sign_in(link)
await user_confirms_sign_in()
resp = call_tool(req) # retry once, never loopما لا تفعله البوابة بالاستجابات
تصل استجابة كل خادم إلى الجهة المستدعية دون تغيير. ونصيحة LangChain هي معاملة مخرجات الأدوات بوصفها مدخلات غير موثوقة لوكيلك. فالبوابة ليست مرشّحًا للمحتوى. وتظل وسائل الدفاع مثل الفصل بين التعليمات والبيانات في مواجهة حقن الأوامر من مسؤوليتك، ومكانها تصميم الوكيل.
خطوات الإعداد: الخوادم والمجموعات ووضع البحث وأول طلب
قد تتغير الشاشات ومسارات API خلال المرحلة التجريبية. لذلك تتبع هذه الخطوات المفاهيم الموثّقة لا النقرات.
- سجّل كل خادم MCP. أضف الخادم بحيث تصادق البوابة معه بدلًا من وكيلك، وراجع وثائق الهوية قبل أن تقرر بيانات اعتماد مَن ينبغي أن تحملها استدعاءاته.
- أنشئ مجموعة لكل دور من أدوار الوكلاء. اختر أدوات من خوادمك المسجّلة، وسمِّ المجموعة باسم الدور الذي تخدمه، وأبقِها صغيرة. تغطي وثائق مجموعات الأدوات إنشاء المجموعات وتحديثها.
- استخدم وضع البحث مع الفهارس الكبيرة. إذا كان دور ما يحتاج فعلًا إلى أدوات كثيرة، فإن وضع البحث يغنيك عن تحميل كل الأدوات دفعة واحدة.
- أرسل أول طلب من واجهتك الخلفية. ترسل الجهة المستدعية في الواجهة الخلفية مفتاح الخدمة إلى جانب ترويسة X-LangSmith-Identity تسمّي المستخدم الذي يعمل الاستدعاء نيابةً عنه:
POST <your kit's MCP endpoint, as shown in LangSmith>
<auth header carrying the service key>
X-LangSmith-Identity: <user this call acts for>
<standard MCP tool call payload>سطرا نقطة النهاية والمصادقة عنصران نائبان، كما نبّهت الملاحظة في أعلى الدليل. خذ القيم الدقيقة من LangSmith ومن الوثائق الحالية.
يرى (See): بناء مجموعات أدوات منتقاة دون الخلط بينها وبين الأمان
المجموعة (kit) هي طقم منتقى من الأدوات مأخوذ من الخوادم المسجّلة في البوابة. والغاية هي التركيز: فالوكيل الذي يتولى عمليات الاسترداد لا شأن له برؤية أداة تقويم أو أداة نشر. كما تساعد المجموعات الأصغر على الجودة، إذ تشير LangChain إلى أنه عندما يملك الوكيل مئات الأدوات أو آلافها، فإن تحميلها كلها دفعة واحدة يزيد زمن الاستجابة ويصعّب اختيار الأداة المناسبة. يُسمح بما يصل إلى 10,000 أداة في كل مجموعة، لكن تعامل مع هذا الرقم بوصفه سقفًا لا هدفًا.
المجموعات ليست أداة للتحكم في الوصول
الجهة المستدعية نفسها التي تستخدم مجموعة ما تستطيع أيضًا استخدام kits/me/mcp، الذي يقدّم كل أداة يحق لها استخدامها. ولهذا تنص وثائق LangChain صراحةً على أن المجموعة ليست أداة للتحكم في الوصول. فإزالة أداة من مجموعة لا تمنع استدعاءً تسمح به هوية الوكيل. يجب أن يقع الإنفاذ في طبقتي «يعمل بصفة» و«يسمح».
حافظ على تحديث المجموعات
يخزّن Tool Gateway قائمة أدوات كل خادم مؤقتًا لمدة ساعتين، وفق وثائق مجموعات الأدوات. اجعل تحديث المجموعات جزءًا من كل إصدار لخادم MCP، أو تقبّل أن الوكلاء قد يرون قائمة أدوات متأخرة بما يصل إلى ساعتين بعد أي تغيير. ويكون ذلك أهم ما يكون عندما يزيل إصدارٌ ما أداةً لم تعد تريد أن يصل إليها الوكلاء.
يعمل بصفة (Act As): اختيار الهوية للمستخدمين والوكلاء المستقلين
تحدد الهوية أذونات مَن يحملها استدعاء الأداة. وفي ربطنا ضمن نموذج See / Act As / Allow، هذه هي الطبقة التي تعالج الأذونات المفرطة. وقبل اختيار نمط ما، نقترح قراءة وثائق الهوية إلى جانب النهجين التاليين.
بيانات الاعتماد لكل مستخدم
يربط كل مستخدم حسابه الخاص عبر مسار تسجيل الدخول الموضّح أعلاه. ويناسب ذلك المساعدين الذين يعملون نيابةً عن شخص ما، لأن الوكيل لا يستطيع إلا ما يستطيعه ذلك الشخص أصلًا في المنبع.
مفتاح الخدمة مع ترويسة X-LangSmith-Identity
تستخدم أنظمة الواجهة الخلفية مفتاح خدمة مع ترويسة X-LangSmith-Identity. ويثق Tool Gateway بالقيمة الواردة في تلك الترويسة كما أُرسلت. لذا فإن أي جهة مستدعية تحمل مفتاح الخدمة تستطيع العمل بصفة أي مستخدم. لا ترسل الترويسة إلا من واجهة خلفية تتحكم فيها، ولا تكشف مفتاح الخدمة أبدًا لمتصفح أو لمستخدم نهائي؛ وهذه إرشادات LangChain نفسها. تعامل مع هذا المفتاح كما تتعامل مع بيانات اعتماد الجذر.
المقارنة أدناه تقييمنا الخاص، وليست من وثائق LangChain.
| السؤال | بيانات الاعتماد لكل مستخدم | مفتاح الخدمة في الواجهة الخلفية |
|---|---|---|
| نيابةً عمّن يعمل الاستدعاء | شخص ربط حسابه الخاص | أي هوية ترسلها واجهتك الخلفية في الترويسة |
| الاستخدام المعتاد | المساعدون التفاعليون والمساعدون المرافقون (copilots) | خدمات الواجهة الخلفية والوكلاء غير المراقَبين أو المجدولون |
| الخطر الرئيسي | حسابات مرتبطة بصلاحيات أوسع مما تحتاجه المهمة | مفتاح مسرّب يتيح انتحال صفة أي مستخدم |
| سياسات الموافقة | قابلة للتطبيق، لأن الشخص حاضر للتأكيد | مفيدة فقط إذا كان هناك شخص حاضر؛ وإلا فاستخدم سياسات الحظر |
قاعدتنا العملية: استخدم بيانات الاعتماد لكل مستخدم عندما يكون الشخص حاضرًا ويكون الإجراء إجراءه، واستخدم مفتاح الخدمة، مُرسَلًا فقط من واجهة خلفية تتحكم فيها، عندما تعمل مهمة دون مراقبة أو نيابةً عن النظام.
يسمح (Allow): كتابة سياسات حظر وموافقة تصمد فعلًا
السياسات هي طبقة الإنفاذ، وثمة إعدادان افتراضيان في وثائق السياسات يشكّلان كل ما عداهما. فالاستدعاء الذي لا تطابقه أي سياسة يُنفَّذ. وإذا طابق استدعاءٌ سياسةَ حظر وسياسةَ موافقة معًا، فإنه يُحظر. والإعداد الافتراضي الأول هو الذي يوقع الناس في الخطأ: فالأداة التي لم يكتب لها أحد سياسة هي أداة يستطيع كل مستدعٍ مسموح له استخدامها.
مَن يوافق فعلًا
في ظل سياسة الموافقة، تكون الجهة المستدعية هي مَن يوافق على الاستدعاء، لا مراجع منفصل. يُؤكَّد كل استدعاء قبل تنفيذه، لكن لا يُحال أي شيء إلى مسؤول. والوكيل الذي يعمل دون حضور أحد لا يستطيع الموافقة على الاستدعاءات. ولهذه الحالة توصي LangChain بسياسة حظر تمنع الوكيل من استدعاء الأداة.
التحكم بمشاركة الإنسان، حيث يوافق إنسان على الإجراءات عالية الأثر قبل وقوعها، من بين وسائل التخفيف التي توصي بها OWASP. وتناسب موافقة الجهة المستدعية الحالة التي يسمح فيها مستخدم لمساعد بإرسال بريد إلكتروني من حسابه الخاص. لكنها لا تناسب الإجراءات التي تحتاج إلى عين ثانية، مثل استرداد مبلغ يتجاوز حدًا يضعه فريقك المالي. في هذه الحالات، احظر الأداة على مستوى البوابة أو ابنِ خطوة موافقة مسبقة في تطبيقك الخاص.
السعة
يمكن للمؤسسة أن تملك ما يصل إلى 1,000 سياسة تنطبق على كل مساحات العمل، إضافةً إلى ما يصل إلى 100 سياسة لكل مساحة عمل. وإنشاء سياسة تتجاوز أيًّا من الحدين يعيد الخطأ 422. ضع القواعد مثل حظر الأدوات غير القابلة للتراجع عن الوكلاء غير المراقَبين على مستوى المؤسسة، والقواعد الخاصة بالفرق في مساحات العمل. وإذا كنت تولّد السياسات آليًا، فتعامل مع الخطأ 422 بحيث يفشل النص البرمجي بشكل واضح بدلًا من أن يترك قاعدة دون كتابة.
دليل الطرح: من أسرار متناثرة إلى بوابة واحدة خاضعة للحوكمة
نفّذ هذه الخطوات من الأقل خطورة إلى الأعلى.
- الجرد. أدرج كل خادم MCP وكل أداة يستخدمها وكلاؤك، وصنّف كلًا منها حسب الأثر: قراءة، أو كتابة، أو غير قابل للتراجع، أو موجّه إلى الخارج.
- سجّل الخوادم. انقل بيانات اعتماد المنبع إلى البوابة، ثم تأكد من أن أي تهيئة وكيل لم تعد تحتفظ بمفتاح منبع.
- يرى (See). ابنِ مجموعة واحدة لكل دور من أدوار الوكلاء بأصغر طقم أدوات مفيد.
- يعمل بصفة (Act As). بيانات اعتماد لكل مستخدم للمساعدين الذين يعملون نيابةً عن أشخاص؛ ومفتاح الخدمة، من الواجهة الخلفية فقط، للمهام المستقلة.
- يسمح (Allow). سياسات الحظر أولًا، للوكلاء غير المراقَبين والأدوات غير القابلة للتراجع، ثم سياسات الموافقة للاستدعاءات التفاعلية الحساسة.
- تأكد من وصول التتبّعات. افحص مشروع التتبّع tool-gateway وعلامة التبويب Usage بعد أولى استدعاءاتك الاختبارية.
- اختبر الحمل. اختبر في مواجهة الحدود الموثّقة (انظر قسم التحفظات أدناه) في ظل حركة مرور واقعية.
قائمة التحقق قبل الإنتاج
- [ ] لم تعد هناك مفاتيح أو رموز للمنبع في شيفرة الوكيل أو الموجّهات أو تهيئة العميل
- [ ] لا يعتمد أي وكيل غير مراقَب على سياسة موافقة
- [ ] تتعامل العملاء مع استجابات تسجيل الدخول HTTP 428 دون الدخول في حلقة
- [ ] يعامل الوكلاء مخرجات الأدوات بوصفها مدخلات غير موثوقة
- [ ] تحديث المجموعات جزء من عملية إصدار خوادم MCP
قابلية المراقبة: ما تسجّله التتبّعات وعلامة التبويب Usage
تسجّل تتبّعات استدعاءات الأدوات أداة كل استدعاء وخادمه ومستخدمه ونتيجته ومدته. أما البيانات المرسلة إلى الأداة أو العائدة منها فلا تُخزَّن. تبقى الحمولات الحساسة خارج السجل، وكذلك التفاصيل التي قد تحتاجها لاحقًا في تحقيق ما. تصل التتبّعات إلى مشروع تتبّع باسم tool-gateway، تنشئه البوابة عند تسجيل أول استدعاء، كما توضّح وثائق التتبّعات. وتتبّعات مساحة العمل مجانية ولا تُحتسب ضمن حدود التتبّع لديك، فالتكلفة ليست سببًا لتجاهلها. وللفحوص الأسرع، تعرض علامة التبويب Usage أحدث 100 استدعاء أداة خلال آخر 7 أيام، مع أداة كل استدعاء وخادمه ونتيجته وزمن استجابته ووقت بدئه. وتناسب هذه الواجهة فحوص الطرح المباشرة لا التدقيق طويل الأمد.
إذا كانت عمليات الامتثال أو الاستجابة للحوادث لديك تحتاج إلى تحليل جنائي على مستوى الحمولة، فيجب أن يكون هذا التسجيل في طبقة الوكيل أو التطبيق لديك، على سبيل المثال إلى جانب تتبّع OpenTelemetry GenAI للوكلاء.
التحفظات وحدود المرحلة التجريبية ومتى تظل الأسرار الخاصة بكل وكيل مقبولة
الحدود الصارمة المدرجة في وثائق Tool Gateway من LangChain، بدءًا من النظرة العامة في How Tool Gateway works، هي: حجم طلب 1 MB، وحجم استجابة 8 MB، و60 ثانية كي يبدأ خادم MCP بالاستجابة، و100 طلب في الثانية مع دفقات تصل إلى 1,000. والأدوات التي تعيد مستندات كبيرة أو تعتمد على أنظمة منبع بطيئة هي أول ما ينبغي اختبار حمله.
خلال المرحلة التجريبية، يقتصر الوصول على خطتي Plus وEnterprise وعلى المناطق السحابية الأربع المذكورة. وقد يتغير سلوك الإصدار التجريبي، ويعكس هذا الدليل الوثائق المتاحة عند الإطلاق. نقترح حسم التفاصيل التنفيذية التي نُبّه إليها في أعلى الدليل، مثل متطلبات النقل وتغطية الخطط لميزات الحوكمة، قبل أن تخطط لأي ترحيل.
متى تكون البوابة الخيار الأفضل
تؤتي البوابة ثمارها عندما يكون لديك عدد كبير من خوادم MCP والوكلاء، أو عندما يحتاج كل مستخدم إلى وصول مفوَّض، أو عندما يريد فريق الأمان مكانًا واحدًا لتعريف السياسات ومراجعتها.
متى قد تكفي الأسرار الخاصة بكل وكيل
لا يحتاج كل فريق إلى هذا. فإذا كنت تشغّل وكيلًا واحدًا بعدد قليل من الأدوات، ومالك واحد، ودون وصول مفوَّض من المستخدمين، فقد تضيف البوابة المركزية من الإجراءات أكثر مما تضيف من الحماية.
النقاط الرئيسية
- دخل LangSmith Tool Gateway مرحلة الإصدار التجريبي العام في 19 نوفمبر 2026، ضمن خطتي Plus وEnterprise، في مناطق GCP US وGCP EU وGCP APAC وAWS US، مع استبعاد Azure US.
- يربط نموذج «يرى / يعمل بصفة / يسمح» (See / Act As / Allow) الأسباب الجذرية للصلاحية المفرطة لدى OWASP بالمجموعات والهوية والسياسات، ولكل طبقة حدودها الخاصة.
- لا تصادق الجهة المستدعية إلا مع LangSmith، ولا تحمل أبدًا رموز خوادم MCP في المنبع أو مفاتيح API الخاصة بها، بما يتسق مع حظر مواصفة MCP لتمرير الرموز.
- تحدد مجموعات الأدوات ما يراه الوكيل لكنها ليست أداة للتحكم في الوصول، لأن الجهة المستدعية تظل قادرة على الوصول إلى kits/me/mcp وإلى كل أداة تسمح بها هويتها.
- مع ترويسة X-LangSmith-Identity، يستطيع أي شخص يحمل مفتاح الخدمة العمل بصفة أي مستخدم. أبقِ هذا المفتاح في واجهة خلفية تتحكم فيها.
- تسمح السياسات بالاستدعاءات افتراضيًا، ويتغلب الحظر على الموافقة، والجهة المستدعية هي مَن يوافق. يحتاج الوكلاء غير المراقَبين إلى سياسات حظر.
- لا تتضمن التتبّعات الحمولات، وتمر مخرجات الأدوات دون تغيير. خطّط وفق حدود 1 MB للطلب و8 MB للاستجابة و60 ثانية و100 طلب في الثانية.
الخلاصة
ابدأ بالجرد. صنّف كل أداة MCP يستخدمها وكلاؤك بوصفها قراءة أو كتابة أو غير قابلة للتراجع أو موجّهة إلى الخارج، واكتب سياسات حظر للأدوات غير القابلة للتراجع والموجّهة إلى الخارج قبل نقل أي وكيل إلى ما وراء البوابة. ثم مرّر دورًا واحدًا من أدوار الوكلاء عبر المسار كاملًا، بمجموعته الصغيرة الخاصة ونمط الهوية الذي يطابق مَن هو حاضر فعلًا. ولا توسّع نطاق الطرح إلا بعد أن تظهر استدعاءاته في مشروع التتبّع tool-gateway وتبقى اختبارات الحمل ضمن الحدود الموثّقة.
الاستثناء هو الفريق الصغير. فإذا كنت تشغّل وكيلًا واحدًا بعدد قليل من الأدوات ومالك واحد، فقد يظل السر المحدود النطاق على جانب الخادم مع رموز قصيرة العمر هو الخيار الأبسط. ويمكن للبوابة أن تنتظر حتى يأتي وكيل ثانٍ أو وصول مفوَّض من المستخدمين.
الأسئلة الشائعة
هل يتوفر LangSmith Tool Gateway بشكل عام، وما الخطط والمناطق التي تدعمه؟
ليس بعد. فقد أُطلق في إصدار تجريبي عام في 19 نوفمبر 2026. يتوفر الإصدار التجريبي ضمن خطتي LangSmith Plus وEnterprise، وعلى LangSmith Cloud يغطي مناطق GCP US وGCP EU وGCP APAC وAWS US، مع استبعاد Azure US. راجع الوثائق الحالية قبل الالتزام، لأن نطاق الإصدار التجريبي قد يتغير.
هل تمنع مجموعات الأدوات الوكيل من استدعاء أدوات خارج المجموعة؟
لا. تنص وثائق LangChain على أن المجموعة ليست أداة للتحكم في الوصول، لأن الجهة المستدعية نفسها تستطيع استخدام kits/me/mcp، الذي يقدّم كل أداة يحق لها استخدامها. تحدد المجموعات ما يراه الوكيل. ولتقييد ما يستطيع فعله حقًا، اعتمد على تحديد نطاق الهوية وسياسات الحظر.
ماذا ينبغي أن يفعل عميلي عندما يتلقى استجابة HTTP 428؟
تعامل معها بوصفها خطوة تسجيل دخول. تحمل استجابة 428 رابط تسجيل دخول لمستخدم لم يربط حسابه. اعرض الرابط، وانتظر حتى يؤكد المستخدم تسجيل الدخول، ثم أعد محاولة الاستدعاء الأصلي مرة واحدة. ولمعرفة الحقل الذي يحمل الرابط، راجع الوثائق الحالية أو افحص استجابة فعلية أثناء الاختبار.
مَن يوافق على الاستدعاء في ظل سياسة الموافقة، وماذا أفعل مع الوكلاء غير المراقَبين؟
الجهة المستدعية هي مَن يوافق على الاستدعاء. لا يوجد مراجع منفصل ولا قائمة انتظار لدى مسؤول. والوكيل الذي يعمل دون حضور أحد لا يستطيع الموافقة على الاستدعاءات، لذلك توصي LangChain بسياسات حظر تمنع هؤلاء الوكلاء من استخدام أداة ما. وإذا كنت تحتاج إلى شخص ثانٍ يراجع الإجراءات عالية الأثر، فابنِ هذه الخطوة في تطبيقك الخاص أو احظر الأداة.
هل يخزّن Tool Gateway مدخلات استدعاءات الأدوات ومخرجاتها؟
لا. تسجّل تتبّعات استدعاءات الأدوات أداة كل استدعاء وخادمه ومستخدمه ونتيجته ومدته، لكن البيانات المرسلة إلى الأداة أو العائدة منها لا تُخزَّن. وإذا كنت تحتاج إلى سجلات على مستوى الحمولة لأغراض الامتثال أو التحليل الجنائي، فخطّط لهذا التسجيل في طبقة تطبيقك الخاصة.
هل تنقّي البوابة استجابات الأدوات من حقن الأوامر؟
لا. يمرّر Tool Gateway استجابة كل خادم إلى الجهة المستدعية دون تغيير، وتنصح الوثائق بمعاملة مخرجات الأدوات بوصفها مدخلات غير موثوقة لوكيلك. وتظل وسائل الدفاع ضد حقن الأوامر جزءًا من تصميم وكيلك.
ما الحدود الموثّقة للحجم ومهلة الانتظار ومعدل الطلبات؟
الحدود الصارمة الموثّقة هي: حجم طلب 1 MB، وحجم استجابة 8 MB، و60 ثانية كي يبدأ خادم MCP بالاستجابة، و100 طلب في الثانية مع دفقات تصل إلى 1,000. اختبر حمل الأدوات التي تعيد مستندات كبيرة أو تعتمد على أنظمة منبع بطيئة قبل الانتقال إلى الإنتاج.
المصادر
- https://www.langchain.com/blog/langsmith-tool-gateway
- https://docs.langchain.com/langsmith/tool-gateway-how-it-works
- https://docs.langchain.com/langsmith/tool-gateway-quickstart
- https://docs.langchain.com/langsmith/tool-gateway-tool-kits
- https://docs.langchain.com/langsmith/tool-gateway-identity
- https://docs.langchain.com/langsmith/tool-gateway-policies
- https://docs.langchain.com/langsmith/tool-gateway-traces
- https://www.unite.ai/langchain-launches-langsmith-tool-gateway-to-govern-agent-tool-calls/
- https://superpowerdaily.com/posts/langchain-launches-a-gateway-to-control-which-tools-ai-agents-can-use
- https://modelcontextprotocol.io/specification/2025-03-26/basic/transports
- https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization/security-considerations
- https://genai.owasp.org/llmrisk/llm062025-excessive-agency/



