الوكلاء والمهارات

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

ما هي وكلاء الذكاء الاصطناعي؟

وكيل الذكاء الاصطناعي هو نظام ذكاء اصطناعي يمكنه التخطيط والتنفيذ والتكرار على المهام بشكل مستقل. على عكس التفاعلات البسيطة للتعليمة والاستجابة، يمكن للوكلاء:

• التخطيط - تقسيم الأهداف المعقدة إلى خطوات قابلة للتنفيذ
• التنفيذ - استخدام الأدوات واتخاذ إجراءات في العالم الحقيقي
• الملاحظة - معالجة التغذية الراجعة من إجراءاتهم
• التكيف - تعديل نهجهم بناءً على النتائج
• الاستمرارية - الحفاظ على السياق والذاكرة عبر التفاعلات

التعليمات كلبنات بناء

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

تتراكم أنواع التعليمات هذه معاً لتشكيل سلوك الوكيل الكامل:

تعليمات النظام (هوية الوكيل)

التعليمة التأسيسية التي تحدد من هو الوكيل وكيف يتصرف:

You are a code review assistant. Your role is to:
- Analyze code for bugs, security issues, and performance problems
- Suggest improvements following best practices
- Explain your reasoning clearly
- Be constructive and educational in feedback

You have access to tools for reading files, searching code, and running tests.

تعليمات التخطيط (كيفية التفكير)

التعليمات التي توجه عملية التفكير والتخطيط لدى الوكيل:

Before taking action, always:
1. Understand the complete request
2. Break it into smaller, verifiable steps
3. Identify which tools you'll need
4. Consider edge cases and potential issues
5. Execute step by step, validating as you go

تعليمات استخدام الأدوات (كيفية التصرف)

التوجيهات حول متى وكيف يتم استخدام الأدوات المتاحة:

When you need to understand a codebase:
- Use grep_search for finding specific patterns
- Use read_file to examine file contents
- Use list_dir to explore directory structure
- Always verify your understanding before making changes

تعليمات التعافي (كيفية التعامل مع الفشل)

التعليمات عندما تسوء الأمور:

If an action fails:
1. Analyze the error message carefully
2. Consider alternative approaches
3. Ask for clarification if the task is ambiguous
4. Never repeat the same failed action without changes

ما هي المهارات؟

إذا كانت التعليمات هي الذرات، فإن المهارات هي الجزيئات — لبنات بناء قابلة لإعادة الاستخدام تمنح الوكلاء قدرات محددة.

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

تشريح المهارة

تتضمن المهارة المصممة جيداً عادةً:

مثال: مهارة مراجعة الكود

إليك كيف قد تبدو مهارة مراجعة الكود:

يحدد ملف SKILL.md النهج العام:

---
name: code-review
description: Comprehensive code review with security, performance, and style analysis
---

# Code Review Skill

You are an expert code reviewer. When reviewing code:

## Process
1. **Understand Context** - What does this code do? What problem does it solve?
2. **Check Correctness** - Does it work? Are there logic errors?
3. **Security Scan** - Reference security-checklist.md for common vulnerabilities
4. **Performance Review** - Check performance-tips.md for optimization opportunities
5. **Style & Maintainability** - Is the code readable and maintainable?

## Output Format
Provide feedback in categories:
- 🔴 **Critical** - Must fix before merge
- 🟡 **Suggested** - Recommended improvements
- 🟢 **Nice to have** - Optional enhancements

Always explain *why* something is an issue, not just *what* is wrong.

المهارات مقابل التعليمات البسيطة

بناء مهارات فعالة

1. حدد الخبرة بوضوح

ابدأ بوصف واضح لما تمكّنه المهارة:

---
name: api-design
description: Design RESTful APIs following industry best practices, 
  including versioning, error handling, and documentation standards
---

2. نظّم المعرفة بشكل هرمي

نظّم المعلومات من العام إلى الخاص:

# API Design Skill

## Core Principles
- Resources should be nouns, not verbs
- Use HTTP methods semantically
- Version your APIs from day one

## Detailed Guidelines
[More specific rules...]

## Reference Materials
- See `rest-conventions.md` for naming conventions
- See `error-codes.md` for standard error responses

3. أدرج أمثلة ملموسة

تصبح القواعد المجردة واضحة مع الأمثلة:

## Endpoint Naming

✅ Good:
- GET /users/{id}
- POST /orders
- DELETE /products/{id}/reviews/{reviewId}

❌ Avoid:
- GET /getUser
- POST /createNewOrder
- DELETE /removeProductReview

4. قدم أطر اتخاذ القرار

ساعد الوكيل على اتخاذ الخيارات في المواقف الغامضة:

## When to Use Pagination

Use pagination when:
- Collection could exceed 100 items
- Response size impacts performance
- Client may not need all items

Use full response when:
- Collection is always small (<20 items)
- Client typically needs everything
- Real-time consistency is critical

5. أضف أنماط التعافي

توقع ما يمكن أن يسوء:

## Common Issues

**Problem**: Client needs fields not in standard response
**Solution**: Implement field selection: GET /users?fields=id,name,email

**Problem**: Breaking changes needed
**Solution**: Create new version, deprecate old with timeline

تركيب المهارات

تصبح الوكلاء قوية عندما تعمل مهارات متعددة معاً. فكر في كيف يمكن للمهارات أن تكمل بعضها البعض:

عند تركيب المهارات، تأكد من أنها لا تتعارض. يجب أن تكون المهارات:

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

مشاركة واكتشاف المهارات

تكون المهارات أكثر قيمة عند مشاركتها. تتيح لك منصات مثل halaGPT:

• اكتشاف مهارات أنشأها المجتمع للمهام الشائعة
• تنزيل المهارات مباشرة إلى مشاريعك
• مشاركة خبرتك الخاصة كمهارات قابلة لإعادة الاستخدام
• التكرار على المهارات بناءً على الاستخدام الفعلي

النظام البيئي للوكلاء والمهارات

تخلق العلاقة بين الوكلاء والمهارات نظاماً بيئياً قوياً:

يوفر الوكيل إطار التنفيذ — التخطيط واستخدام الأدوات والذاكرة — بينما توفر المهارات خبرة المجال. هذا الفصل يعني:

• المهارات قابلة للنقل - نفس المهارة تعمل مع وكلاء مختلفين
• الوكلاء قابلة للتوسيع - أضف قدرات جديدة بإضافة مهارات
• الخبرة قابلة للمشاركة - يمكن لخبراء المجال المساهمة بالمهارات دون بناء وكلاء كاملين

أفضل الممارسات

لبناء المهارات

1. ابدأ محدداً، ثم عمّم - ابنِ مهارة لحالة استخدامك الدقيقة أولاً، ثم جردها
2. أدرج حالات الفشل - وثّق ما لا تستطيع المهارة فعله وكيفية التعامل معه
3. أنشئ إصدارات لمهاراتك - تتبع التغييرات حتى يتمكن الوكلاء من الاعتماد على إصدارات مستقرة
4. اختبر مع مهام حقيقية - تحقق من صحة المهارات مقابل العمل الفعلي، وليس النظرية فقط

لاستخدام المهارات مع الوكلاء

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