الأدوات
تعرّف على كيفية استخدام Bob للأدوات المتخصصة لقراءة الملفات وتعديل الأكواد وتشغيل الأوامر وإطلاق subagents واستخدام تكاملات MCP وتبديل الأوضاع لتبسيط سير عمل البرمجة.
سير عمل الأدوات
عند عملك مع Bob، يحدد الإجراءات المناسبة. لكل خطوة، يقوم Bob بـ:
- اختيار الأداة المناسبة بناءً على طلبك
- عرض الأداة مع معاملاتها لمراجعتك
- تشغيل الأداة الموافق عليها وعرض النتائج عليك
- الاستمرار في هذه العملية حتى إتمام مهمتك
فئات الأدوات
تُصنَّف أدوات Bob حسب وظيفتها الرئيسية. فهم هذه الفئات يساعدك على رؤية كيفية أداء Bob للمهام المختلفة.
أدوات القراءة
تتيح أدوات القراءة لـ Bob الوصول إلى محتوى الملفات وفهم هيكل الأكواد دون إجراء تغييرات.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
read_file | قراءة محتويات ملف مع نطاقات أسطر اختيارية | عرض ملفات التهيئة وفحص الأكواد المصدرية |
glob | البحث عن الملفات حسب نمط الاسم (مثلاً **/*.ts) | تحديد موقع ملفات الاختبار وإيجاد جميع المكونات |
grep | البحث في محتوى الملفات باستخدام أنماط regex | إيجاد تعريفات الدوال وتحديد موقع TODOs |
list_files | سرد الملفات والمجلدات | تصفح هيكل مجلد واحد |
GetSymbolsOverview | الحصول على الرموز عالية المستوى في ملف | فهم هيكل الملف قبل التعمق فيه |
FindSymbol | البحث عن رمز بمسار الاسم مع عمق اختياري | التنقل إلى فئة أو طريقة أو دالة |
FindReferencingSymbols | إيجاد جميع مراجع رمز معين | فهم مكان استخدام دالة أو نوع |
يستخدم Bob أدوات القراءة عندما يتضمن طلبك مراجعة الأكواد أو البحث عن الأنماط أو فحص هيكل المشروع.
أدوات الكتابة
تتيح أدوات الكتابة لـ Bob إنشاء ملفات جديدة أو تعديل الأكواد الموجودة.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
write_file | إنشاء ملف جديد أو إعادة كتابة ملف موجود بالكامل | توليد مكونات جديدة وإنشاء ملفات التهيئة |
apply_diff | تطبيق تغييرات دقيقة ومستهدفة على أجزاء محددة من ملف | تحديث منطق الدوال وإصلاح الأخطاء وإعادة هيكلة الأكواد |
insert_content | إدراج أسطر جديدة في موضع محدد من ملف | إضافة imports وإدراج دوال جديدة |
search_and_replace | البحث عن نصوص أو أنماط regex واستبدالها عبر ملف | إعادة تسمية المتغيرات وتحديث الأنماط المتكررة |
يستخدم Bob أدوات الكتابة عندما يتضمن طلبك إنشاء ملفات أو تطبيق ميزات أو إصلاح أخطاء أو إعادة هيكلة الأكواد.
أدوات الأوامر
تتيح أدوات الأوامر لـ Bob تشغيل الأوامر وإجراء عمليات النظام.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
execute_command | تشغيل أوامر CLI في مساحة عملك | تثبيت التبعيات وتشغيل الاختبارات وبناء المشاريع |
يستخدم Bob أدوات الأوامر عندما يتضمن طلبك تشغيل أوامر أو تثبيت حزم أو تشغيل سكريبتات أو إجراء عمليات النظام.
أدوات Subagent
تتيح أدوات Subagent لـ Bob إطلاق agent مستقل للتعامل مع العمل المركّز والمستقل في سياقه المعزول.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
spawn_subagent | إنشاء agent مستقل بنافذة سياق خاصة به | استكشاف قسم من قاعدة الأكواد وجمع المعلومات دون تلويث السياق الرئيسي |
كيفية عمل subagents
يعمل subagent بشكل مستقل عن المحادثة الرئيسية. له نافذة سياق خاصة به، وينفّذ مهمته المُوكَلة، ويعيد ملخص النتائج إلى Bob.
يستخدم Bob subagents بشكل محدود. الافتراضي دائماً هو إنجاز العمل مباشرةً. يُعتبر subagent فقط عندما تكون جميع الشروط التالية صحيحة:
- المهمة مستقلة بوضوح ومطلوب فقط ملخص للنتائج
- ستُضيف كميات كبيرة من المحتوى غير ذي الصلة إلى السياق الرئيسي
- لا يمكن إنجازها باستدعاء أداة أو اثنتين مباشرةً
هناك نوعان من subagents:
| النوع | الوصف |
|---|---|
explore | استكشاف للأكواد للقراءة فقط، يعمل على نموذج أخف |
general | وصول كامل للأدوات، يعمل على النموذج الافتراضي |
بشكل افتراضي، لا يرى subagent سجل المحادثة الأصل. ضبط fork_context: true يمرر سجل المحادثة إلى subagent عندما يحتاج إلى فهم القرارات السابقة.
لا يستخدم Bob subagents لقراءات الملفات البسيطة أو الأبحاث السريعة أو عمليات الأداة الواحدة.
أدوات Subtask
تتيح أدوات Subtask لـ Bob إنشاء مثيل مهمة جديد ومُسمَّى يعمل كمحادثة مخصصة مستقلة في واجهة المستخدم.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
start_subtask | إنشاء مهمة جديدة بعنوان وتعليمات وقائمة todo اختيارية | تقسيم طلب كبير إلى subtask متتبَّعة بخيط محادثة خاص بها |
كيفية عمل subtasks
Subtask مهمة مستقلة تماماً تظهر في واجهة المستخدم بمسار تنقل وسجل محادثة خاصين. على عكس subagent — الذي يعمل بصمت في الخلفية ويعيد فقط ملخصاً — subtask مرئية وتفاعلية.
أدوات MCP
تتيح أدوات MCP لـ Bob توسيع قدراته من خلال خوادم Model Context Protocol (MCP) المتصلة.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
| أدوات خادم MCP | الوصول إلى الأدوات التي توفرها خوادم MCP المتصلة | استعلام قواعد البيانات والتفاعل مع APIs والوصول إلى الخدمات الخارجية |
أدوات الوضع
تتيح أدوات الوضع لـ Bob التبديل بين الأوضاع المختلفة للمهام المتخصصة.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
switch_mode | التغيير إلى وضع مختلف (Agent أو Plan أو Ask إلخ) | التبديل إلى وضع Plan لتصميم البنية المعمارية، وضع Agent للتطبيق |
أدوات Skills
تتيح أدوات Skills لـ Bob تفعيل مجموعات تعليمات متخصصة للمجالات والمهام المحددة.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
use_skill | تحميل تعليمات مفصّلة لـ skill مُسمَّى في السياق الحالي | تفعيل skill Carbon builder وتحميل إرشادات سير عمل Jira |
أدوات سير العمل
تتيح أدوات سير العمل لـ Bob إطلاق عمليات متعددة الخطوات مُعرَّفة مسبقاً ومصممة للمهام المتكررة.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
start_workflow | إطلاق سير عمل مُسمَّى بخطواته المنظّمة الخاصة | إنشاء pull request أو مراجعة الأكواد |
أدوات Todo
تتيح أدوات Todo لـ Bob تتبع التقدم عبر المهام متعددة الخطوات باستخدام قائمة تحقق مرئية.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
update_todo_list | إنشاء أو تحديث قائمة تحقق Markdown لخطوات المهمة | تتبع خطوات التطبيق وتحديد العناصر المكتملة وإضافة المهام المكتشفة حديثاً |
أدوات الأسئلة
تتيح أدوات الأسئلة لـ Bob جمع معلومات إضافية لإتمام المهام.
| الأداة | الغرض | مثال على الاستخدام |
|---|---|---|
ask_followup_question | طلب توضيح أو تفاصيل إضافية | السؤال عن نهج التطبيق المفضل وطلب المعلومات المفقودة |
حافظ على تزامن التوثيق مع قاعدة الكود
تعرّف على كيفية إبقاء التوثيق التقني متزامنًا مع قاعدة الكود باستخدام أمر init في IBM Bob ووضع Docs Architect مخصص عبر سيناريوهات تطوير واقعية، مثل تطوير الميزات ومراجعات الكود وتأهيل الأعضاء الجدد والصيانة المستمرة.
إدارة نافذة السياق
تعرّف على كيفية عمل نافذة سياق Bob بسعة 270,000 token وكيف تساهم كل فئة في استخدام token وأفضل الممارسات للحفاظ على المهام مركّزة وفعّالة من حيث التكلفة.