# يمنح IaGenify SDK 0.3.2 الوكلاء خريطة بالأدوات المتاحة لهم.

Canonical URL: https://www.iagenify.com/ar/news/iagenify-sdk-agent-capability-catalogue

تستند تعليمات الوكيل إلى الأدوات والإجراءات المفعّلة فعلياً للتشغيل، ليختار قدرات موجودة بدلاً من التخمين من وثائق عامة.

## Key points
- يتلقى الوكيل قائمة موجزة بالقدرات المتاحة في تشغيله.
- تعكس القائمة الأدوات التي فعّلها التطبيق والبيئة ونمط الصلاحيات.
- يقارن فحص العقد طرائق SDK بأدوات الوكيل أو باستثناءات لها أسباب موثقة.

لا يستطيع الوكيل الاختيار جيداً إلا إذا عرف الإجراءات المتاحة له. لا تكفي قائمة عامة في الوثائق: فقد يفعّل التطبيق جزءاً منها فقط، أو تفتقر بيئة التشغيل إلى ميزة، أو يمنع نمط الصلاحيات إجراءً ما. يضيف IaGenify SDK 0.3.2 خريطة قدرات مستندة إلى الأدوات المتاحة فعلياً لكل تشغيل.

## صف التشغيل الحقيقي لا المنصة نظرياً

في بداية التشغيل يتلقى الوكيل ملخصاً موجزاً لمجموعات الأدوات النشطة وإجراءاتها. إذا أزال التطبيق أداة اختفت من الخريطة. وإذا لم توفر البيئة إجراءً فلن يوحي الوكيل بأنه قادر عليه. بذلك يصبح التخطيط أقرب إلى التنفيذ الممكن فعلاً.

## يساعد الكتالوج في أكثر من قرار

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

## يمكن فحص التغطية بدلاً من الاعتماد على الذاكرة

يقارن فحص العقد طرائق موارد SDK بشيفرة أدوات الوكيل. يجب أن تكون كل طريقة متاحة عبر أداة أو أن يكون لاستبعادها سبب موثق. وهكذا يظهر الانقطاع أثناء التطوير بدلاً من الاعتماد على مزامنة قوائم يدوية متعددة.

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

## خريطة موجزة تصف SDK واسعاً

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

> ينبغي للوكيل أن يخطط وفق القدرات الموجودة فعلاً في تشغيله، لا وفق قائمة دعائية بكل ما قد تدعمه المنصة.

يجعل IaGenify SDK 0.3.2 صيانة الحد الفاصل بين SDK وحلقة الوكيل أسهل: تأتي القدرات من كتالوج التشغيل ويتحقق فحص العقد من توافقها مع الموارد العامة.

## FAQ
### هل تفعّل الخريطة كل طرائق SDK؟
لا. تصف ما هو متاح في ذلك التشغيل؛ ويظل اختيار التطبيق والبيئة والصلاحيات سارياً.

### كيف تختلف عن الوثائق؟
تلخص ما يستطيع التشغيل فعله؛ أما الوثائق التفصيلية فتشرح استخدام العملية.

### لماذا نعد الإجراءات بدلاً من أسماء الأدوات؟
قد تضم الأداة عدة عمليات، لذلك توضح الإجراءات قدرات الوكيل بصورة أدق.

### هل تُكشف العمليات الحساسة تلقائياً؟
لا. يمكن استبعاد الطرائق المتعلقة بصلاحيات الحساب أو الأسرار مع توثيق السبب والتحقق منه.