كيف تغيّر المهارات الأنثروبولوجية أدوات الوكيل - وكيفية بناء مهارة مخصصة لميلفوس لتدوير RAG بسرعة

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

تستخدم العديد من الفرق تعريفات الأدوات على غرار MCP لتنظيم ذلك، لكن MCP لديه بعض الحواف الخشنة. يتعين على النموذج التفكير في جميع الأدوات في وقت واحد، ولا يوجد الكثير من الهيكلية لتوجيه قراراته. علاوة على ذلك، يجب أن يعيش كل تعريف أداة في نافذة السياق. بعض هذه الأدوات كبيرة - GitHub MCP حوالي 26 ألف رمز - مما يستهلك السياق قبل أن يبدأ الوكيل في القيام بعمل حقيقي.

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

في هذا المنشور، سأستعرض في هذا المنشور كيفية عمل المهارات الأنثروبولوجية، ثم سأتناول كيفية بناء مهارة بسيطة في كود كلود والتي تحول اللغة الطبيعية إلى قاعدة معرفية مدعومة من ميلفوس- إعداد سريع لـ RAG دون الحاجة إلى أسلاك إضافية.

ما هي المهارات الأنثروبولوجية؟

المهارات الأنثروبولوجية (أو مهارات الوكيل) هي مجرد مجلدات تجمع التعليمات والنصوص والملفات المرجعية التي يحتاجها الوكيل للتعامل مع مهمة معينة. فكر فيها كحزم قدرات صغيرة مكتفية ذاتيًا. قد تحدد المهارة كيفية إنشاء تقرير أو إجراء تحليل أو اتباع سير عمل أو مجموعة معينة من القواعد.

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

التنسيق بسيط عن قصد، وبسبب ذلك، فهو مدعوم بالفعل أو يمكن تكييفه بسهولة عبر مجموعة من أدوات المطورين - كلود كود، وكورسور، وامتدادات VS Code، وتكامل GitHub، وإعدادات على غرار Codex، وما إلى ذلك.

تتبع المهارة هيكل مجلد متناسق

skill-name/
├── SKILL.md       # Required: Skill instructions and metadata
├── scripts/         # Optional: helper scripts
├── templates/       # Optional: document templates
└── resources/       # Optional: reference materials

1. SKILL.md (الملف الأساسي)

هذا هو دليل التنفيذ للوكيل - المستند الذي يخبر الوكيل بالضبط كيف يجب تنفيذ المهمة. وهو يحدد البيانات الوصفية للمهارة (مثل الاسم والوصف والكلمات المفتاحية للمشغل)، وسير التنفيذ، والإعدادات الافتراضية. في هذا الملف، يجب أن تصف بوضوح

• متى يجب تشغيل المهارة: على سبيل المثال، تشغيل المهارة عندما تتضمن مدخلات المستخدم عبارة مثل "معالجة ملفات CSV باستخدام Python."

• كيف يجب تنفيذ المهمة: وضع خطوات التنفيذ بالترتيب، مثل: تفسير طلب المستخدم ← استدعاء البرامج النصية للمعالجة المسبقة من الدليل scripts/ ← إنشاء الكود المطلوب ← تنسيق المخرجات باستخدام قوالب من templates/.

• القواعد والقيود: تحديد التفاصيل مثل اصطلاحات الترميز وتنسيقات الإخراج وكيفية التعامل مع الأخطاء.

2. scripts/ (البرامج النصية للتنفيذ)

يحتوي هذا الدليل على نصوص مكتوبة مسبقًا بلغات مثل Python أو Shell أو Node.js. يمكن للوكيل استدعاء هذه البرامج النصية مباشرة، بدلاً من إنشاء نفس الكود بشكل متكرر في وقت التشغيل. تتضمن الأمثلة النموذجية create_collection.py و check_env.py.

3. templates/ (قوالب المستندات)

ملفات قوالب قابلة لإعادة الاستخدام يمكن للوكيل استخدامها لإنشاء محتوى مخصص. تتضمن الأمثلة الشائعة قوالب التقارير أو قوالب التكوين.

4. resources/ (المواد المرجعية)

المستندات المرجعية التي يمكن للوكيل الرجوع إليها أثناء التنفيذ، مثل وثائق واجهة برمجة التطبيقات أو المواصفات الفنية أو أدلة أفضل الممارسات.

بشكل عام، يعكس هذا الهيكل كيفية تسليم العمل إلى زميل جديد في الفريق: SKILL.md يشرح الوظيفة، scripts/ يوفر الأدوات الجاهزة للاستخدام، templates/ يحدد التنسيقات القياسية، و resources/ يوفر معلومات أساسية. مع وجود كل هذا، يمكن للوكيل تنفيذ المهمة بشكل موثوق وبأقل قدر من التخمين.

برنامج تعليمي عملي: إنشاء مهارة مخصصة لنظام RAG المدعوم من ميلفوس

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

نظرة عامة على التصميم

المتطلبات الأساسية

المكون	المتطلبات
CLI	claude-code
النماذج	GLM 4.7، OpenAI
الحاوية	حاوية
ميلفوس	2.6.8
منصة تكوين النموذج	CC-Switch
مدير الحزم	npm
لغة التطوير	بايثون

الخطوة 1: إعداد البيئة

تثبيت claude-code

npm install -g @anthropic-ai/claude-code

تثبيت CC-Switch

ملاحظة: CC-Switch هي أداة لتبديل النماذج تسهّل التبديل بين واجهات برمجة التطبيقات المختلفة للنماذج عند تشغيل نماذج الذكاء الاصطناعي محليًا.

مستودع المشروع: https://github.com/farion1231/cc-switch

حدد كلود وأضف مفتاح واجهة برمجة التطبيقات

تحقق من الحالة الحالية

نشر وبدء تشغيل ميلفوس-ستاندالون

# Download docker-compose.yml
wget https://github.com/milvus-io/milvus/releases/download/v2.6.8/milvus-standalone-docker-compose.yml -O docker-compose.yml
# Start Milvus (check port mapping: 19530:19530)
docker-compose up -d
# Verify that the services are running
docker ps | grep milvus
# You should see three containers: milvus-standalone, milvus-etcd, milvus-minio

تكوين مفتاح OpenAI API Key

# Add this to ~/.bashrc or ~/.zshrc
OPENAI_API_KEY=your_openai_api_key_here

الخطوة 2: إنشاء المهارة المخصصة لميلفوس

إنشاء هيكل الدليل

cd ~/.claude/skills/
mkdir -p milvus-skills/example milvus-skills/scripts

التهيئة SKILL.md

ملاحظة: يعمل SKILL.md كدليل تنفيذ الوكيل. فهو يحدد ما تقوم به المهارة وكيف ينبغي تشغيلها.

name: milvus-collection-builder
description: Create Milvus collections using natural language, supporting both RAG and text search scenarios

اكتب البرامج النصية الأساسية

نوع البرنامج النصي	اسم الملف	الغرض
التحقق من البيئة	check_env.py	التحقق من إصدار Python، والتبعيات المطلوبة، واتصال Milvus
تحليل النية	intent_parser.py	يقوم بتحويل الطلبات مثل "إنشاء قاعدة بيانات RAG" إلى نية منظمة مثل scene=rag
إنشاء مجموعة	milvus_builder.py	المنشئ الأساسي الذي ينشئ مخطط المجموعة وتكوين الفهرس
استيعاب البيانات	insert_milvus_data.py	يقوم بتحميل المستندات، وتجزئتها، وإنشاء التضمينات، وكتابة البيانات في Milvus
المثال 1	basic_text_search.py	يوضح كيفية إنشاء نظام بحث عن المستندات
المثال 2	rag_knowledge_base.py	يوضح كيفية إنشاء قاعدة معرفية كاملة من RAG

توضح هذه البرامج النصية كيفية تحويل المهارة التي تركز على Milvus إلى شيء عملي: نظام بحث عن المستندات يعمل وإعداد قاعدة معرفية ذكية للأسئلة والأجوبة (RAG).

الخطوة 3: تمكين المهارة وإجراء اختبار

وصف الطلب بلغة طبيعية

"I want to build an RAG system."

إنشاء نظام RAG

إدراج بيانات العينة

تشغيل استعلام

الخاتمة

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

هذه هي البداية فقط. يحتوي خط أنابيب RAG الكامل على الكثير من الأجزاء المتحركة: المعالجة المسبقة، والتقطيع، وإعدادات البحث المختلط، وإعادة الترتيب، والتقييم، وغير ذلك. يمكن تجميع كل هذه الأجزاء كمهارات منفصلة وتكوينها حسب حالة الاستخدام الخاصة بك. إذا كان لدى فريقك معايير داخلية لأبعاد المتجهات، أو بارامترات الفهرس، أو قوالب المطالبة، أو منطق الاسترجاع، فإن المهارات هي طريقة نظيفة لترميز تلك المعرفة وجعلها قابلة للتكرار.

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

👉 التطبيق الكامل متاح في مستودع مفتوح المصدر، ويمكنك استكشاف المزيد من الأمثلة التي أنشأها المجتمع في سوق المهارات.

ترقبوا!

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