Skip to content

Latest commit

 

History

History
381 lines (288 loc) · 18.5 KB

File metadata and controls

381 lines (288 loc) · 18.5 KB

🌐 الوحدة 2: أساسيات MCP مع مجموعة أدوات الذكاء الاصطناعي

Duration Difficulty Prerequisites

📋 أهداف التعلم

بنهاية هذه الوحدة، ستتمكن من:

  • ✅ فهم بنية وفوائد بروتوكول سياق النموذج (MCP)
  • ✅ استكشاف نظام خوادم MCP الخاص بشركة Microsoft
  • ✅ دمج خوادم MCP مع منشئ وكلاء مجموعة أدوات الذكاء الاصطناعي
  • ✅ بناء وكيل أتمتة متصفح وظيفي باستخدام Playwright MCP
  • ✅ تكوين واختبار أدوات MCP داخل وكلائك
  • ✅ تصدير ونشر وكلاء مدعومين من MCP للاستخدام الإنتاجي

🎯 البناء على الوحدة 1

في الوحدة 1، أتقنا أساسيات مجموعة أدوات الذكاء الاصطناعي وأنشأنا وكيل Python الأول لدينا. الآن سنقوم بتعزيز وكلائك من خلال ربطهم بأدوات وخدمات خارجية عبر بروتوكول ثوري يُدعى بروتوكول سياق النموذج (MCP).

فكر في هذا كتحديث من آلة حاسبة بسيطة إلى حاسوب كامل - حيث ستكتسب وكلاء الذكاء الاصطناعي لديك القدرة على:

  • 🌐 تصفح المواقع والتفاعل معها
  • 📁 الوصول إلى الملفات والتعامل معها
  • 🔧 التكامل مع أنظمة المؤسسات
  • 📊 معالجة البيانات الحية من واجهات برمجة التطبيقات (APIs)

🧠 فهم بروتوكول سياق النموذج (MCP)

🔍 ما هو MCP؟

بروتوكول سياق النموذج (MCP) هو "USB-C لتطبيقات الذكاء الاصطناعي" - معيار مفتوح ثوري يربط نماذج اللغة الكبيرة (LLMs) بالأدوات الخارجية ومصادر البيانات والخدمات. تمامًا كما قضى USB-C على فوضى الكابلات من خلال توفير موصل عالمي واحد، يقضي MCP على تعقيدات دمج الذكاء الاصطناعي من خلال بروتوكول موحد.

🎯 المشكلة التي يحلها MCP

قبل MCP:

  • 🔧 تكاملات مخصصة لكل أداة
  • 🔄 الاعتماد على بائع واحد مع حلول ملكية
  • 🔒 ثغرات أمنية بسبب الاتصالات العشوائية
  • ⏱️ شهور من التطوير لتكاملات بسيطة

مع MCP:

  • ⚡ تكامل أدوات سهل وبدون تعقيد
  • 🔄 بنية خالية من التبعية على البائعين
  • 🛡️ ممارسات أمان مدمجة
  • 🚀 دقائق لإضافة قدرات جديدة

🏗️ نظرة معمقة على بنية MCP

يتبع MCP بنية عميل-خادم تخلق نظامًا بيئيًا آمنًا وقابلًا للتوسع:

graph TB
    A[AI Application/Agent] --> B[MCP Client]
    B --> C[MCP Server 1: Files]
    B --> D[MCP Server 2: Web APIs]
    B --> E[MCP Server 3: Database]
    B --> F[MCP Server N: Custom Tools]
    
    C --> G[Local File System]
    D --> H[External APIs]
    E --> I[Database Systems]
    F --> J[Enterprise Systems]
Loading

🔧 المكونات الأساسية:

المكون الدور أمثلة
MCP Hosts التطبيقات التي تستخدم خدمات MCP Claude Desktop، VS Code، AI Toolkit
MCP Clients معالجات البروتوكول (1:1 مع الخوادم) مدمجة في تطبيقات المضيف
MCP Servers تعرض القدرات عبر البروتوكول القياسي Playwright، Files، Azure، GitHub
Transport Layer طرق الاتصال stdio، HTTP، WebSockets

🏢 نظام خوادم MCP الخاص بشركة Microsoft

تتقدم Microsoft في نظام MCP البيئي بمجموعة شاملة من خوادم المؤسسات التي تلبي احتياجات الأعمال الواقعية.

🌟 خوادم MCP المميزة من Microsoft

1. ☁️ خادم Azure MCP

🔗 المستودع: azure/azure-mcp
🎯 الغرض: إدارة شاملة لموارد Azure مع دمج الذكاء الاصطناعي

✨ الميزات الرئيسية:

  • توفير البنية التحتية بطريقة إعلانية
  • مراقبة الموارد في الوقت الحقيقي
  • توصيات لتحسين التكاليف
  • التحقق من الامتثال الأمني

🚀 حالات الاستخدام:

  • البنية التحتية ككود بمساعدة الذكاء الاصطناعي
  • توسيع الموارد تلقائيًا
  • تحسين تكاليف السحابة
  • أتمتة سير عمل DevOps

2. 📊 Microsoft Dataverse MCP

📚 الوثائق: Microsoft Dataverse Integration
🎯 الغرض: واجهة لغة طبيعية لبيانات الأعمال

✨ الميزات الرئيسية:

  • استعلامات قاعدة البيانات بلغة طبيعية
  • فهم سياق الأعمال
  • قوالب استدعاء مخصصة
  • حوكمة بيانات المؤسسات

🚀 حالات الاستخدام:

  • تقارير ذكاء الأعمال
  • تحليل بيانات العملاء
  • رؤى خط المبيعات
  • استعلامات الامتثال

3. 🌐 Playwright MCP Server

🔗 المستودع: microsoft/playwright-mcp
🎯 الغرض: أتمتة المتصفح وقدرات التفاعل مع الويب

✨ الميزات الرئيسية:

  • أتمتة عبر متصفحات متعددة (Chrome، Firefox، Safari)
  • كشف ذكي للعناصر
  • إنشاء لقطات شاشة وملفات PDF
  • مراقبة حركة الشبكة

🚀 حالات الاستخدام:

  • سير عمل اختبار مؤتمت
  • استخراج البيانات من الويب
  • مراقبة واجهة المستخدم وتجربة المستخدم
  • أتمتة التحليل التنافسي

4. 📁 Files MCP Server

🔗 المستودع: microsoft/files-mcp-server
🎯 الغرض: عمليات نظام الملفات الذكية

✨ الميزات الرئيسية:

  • إدارة الملفات بطريقة إعلانية
  • مزامنة المحتوى
  • تكامل التحكم في الإصدارات
  • استخراج البيانات الوصفية

🚀 حالات الاستخدام:

  • إدارة الوثائق
  • تنظيم مستودعات الأكواد
  • سير عمل نشر المحتوى
  • معالجة ملفات خطوط البيانات

5. 📝 MarkItDown MCP Server

🔗 المستودع: microsoft/markitdown
🎯 الغرض: معالجة وتعديل Markdown متقدم

✨ الميزات الرئيسية:

  • تحليل Markdown غني
  • تحويل الصيغ (MD ↔ HTML ↔ PDF)
  • تحليل هيكل المحتوى
  • معالجة القوالب

🚀 حالات الاستخدام:

  • سير عمل التوثيق الفني
  • أنظمة إدارة المحتوى
  • إنشاء التقارير
  • أتمتة قواعد المعرفة

6. 📈 Clarity MCP Server

📦 الحزمة: @microsoft/clarity-mcp-server
🎯 الغرض: تحليلات الويب ورؤى سلوك المستخدم

✨ الميزات الرئيسية:

  • تحليل بيانات خرائط الحرارة
  • تسجيل جلسات المستخدم
  • مقاييس الأداء
  • تحليل قمع التحويل

🚀 حالات الاستخدام:

  • تحسين مواقع الويب
  • بحوث تجربة المستخدم
  • تحليل اختبارات A/B
  • لوحات معلومات ذكاء الأعمال

🌍 نظام المجتمع البيئي

بعيدًا عن خوادم Microsoft، يشمل نظام MCP البيئي:

  • 🐙 GitHub MCP: إدارة المستودعات وتحليل الأكواد
  • 🗄️ قواعد بيانات MCP: تكاملات PostgreSQL، MySQL، MongoDB
  • ☁️ مزودو السحابة MCP: أدوات AWS، GCP، Digital Ocean
  • 📧 تواصل MCP: تكاملات Slack، Teams، البريد الإلكتروني

🛠️ المختبر العملي: بناء وكيل أتمتة متصفح

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

🚀 المرحلة 1: إعداد أساس الوكيل

الخطوة 1: تهيئة وكيلك

  1. افتح منشئ وكلاء AI Toolkit
  2. أنشئ وكيل جديد بالإعدادات التالية:
    • الاسم: BrowserAgent
    • Model: Choose GPT-4o

BrowserAgent

🔧 Phase 2: MCP Integration Workflow

Step 3: Add MCP Server Integration

  1. Navigate to Tools Section in Agent Builder
  2. Click "Add Tool" to open the integration menu
  3. Select "MCP Server" from available options

AddMCP

🔍 Understanding Tool Types:

  • Built-in Tools: Pre-configured AI Toolkit functions
  • MCP Servers: External service integrations
  • Custom APIs: Your own service endpoints
  • Function Calling: Direct model function access

Step 4: MCP Server Selection

  1. Choose "MCP Server" option to proceed AddMCPServer

  2. Browse MCP Catalog to explore available integrations MCPCatalog

🎮 Phase 3: Playwright MCP Configuration

Step 5: Select and Configure Playwright

  1. Click "Use Featured MCP Servers" to access Microsoft's verified servers
  2. Select "Playwright" from the featured list
  3. Accept Default MCP ID or customize for your environment

MCPID

Step 6: Enable Playwright Capabilities

🔑 Critical Step: Select ALL available Playwright methods for maximum functionality

Tools

🛠️ Essential Playwright Tools:

  • Navigation: goto, goBack, goForward, reload
  • Interaction: click, fill, press, hover, drag
  • Extraction: textContent, innerHTML, getAttribute
  • Validation: isVisible, isEnabled, waitForSelector
  • Capture: screenshot, pdf, video
  • Network: setExtraHTTPHeaders, route, waitForResponse

الخطوة 7: التحقق من نجاح التكامل

✅ مؤشرات النجاح:

  • ظهور جميع الأدوات في واجهة منشئ الوكلاء
  • عدم وجود رسائل خطأ في لوحة التكامل
  • حالة خادم Playwright تظهر "Connected"

AgentTools

🔧 استكشاف المشكلات الشائعة:

  • فشل الاتصال: تحقق من اتصال الإنترنت وإعدادات الجدار الناري
  • الأدوات المفقودة: تأكد من اختيار جميع القدرات أثناء الإعداد
  • أخطاء الأذونات: تحقق من أن VS Code لديه الأذونات اللازمة للنظام

🎯 المرحلة 4: هندسة الطلبات المتقدمة

الخطوة 8: تصميم مطالبات نظام ذكية

أنشئ مطالبات متقدمة تستفيد من كامل قدرات Playwright:

# Web Automation Expert System Prompt

## Core Identity
You are an advanced web automation specialist with deep expertise in browser automation, web scraping, and user experience analysis. You have access to Playwright tools for comprehensive browser control.

## Capabilities & Approach
### Navigation Strategy
- Always start with screenshots to understand page layout
- Use semantic selectors (text content, labels) when possible
- Implement wait strategies for dynamic content
- Handle single-page applications (SPAs) effectively

### Error Handling
- Retry failed operations with exponential backoff
- Provide clear error descriptions and solutions
- Suggest alternative approaches when primary methods fail
- Always capture diagnostic screenshots on errors

### Data Extraction
- Extract structured data in JSON format when possible
- Provide confidence scores for extracted information
- Validate data completeness and accuracy
- Handle pagination and infinite scroll scenarios

### Reporting
- Include step-by-step execution logs
- Provide before/after screenshots for verification
- Suggest optimizations and alternative approaches
- Document any limitations or edge cases encountered

## Ethical Guidelines
- Respect robots.txt and rate limiting
- Avoid overloading target servers
- Only extract publicly available information
- Follow website terms of service

الخطوة 9: إنشاء مطالبات مستخدم ديناميكية

صمم مطالبات تعرض قدرات متنوعة:

🌐 مثال تحليل ويب:

Navigate to github.com/kinfey and provide a comprehensive analysis including:
1. Repository structure and organization
2. Recent activity and contribution patterns  
3. Documentation quality assessment
4. Technology stack identification
5. Community engagement metrics
6. Notable projects and their purposes

Include screenshots at key steps and provide actionable insights.

Prompt

🚀 المرحلة 5: التنفيذ والاختبار

الخطوة 10: تنفيذ أول أتمتة لك

  1. انقر على "تشغيل" لبدء تسلسل الأتمتة
  2. راقب التنفيذ في الوقت الحقيقي:
    • فتح متصفح Chrome تلقائيًا
    • يتنقل الوكيل إلى الموقع المستهدف
    • التقاط لقطات شاشة لكل خطوة رئيسية
    • تدفق نتائج التحليل في الوقت الحقيقي

Browser

الخطوة 11: تحليل النتائج والرؤى

راجع التحليل الشامل في واجهة منشئ الوكلاء:

Result

🌟 المرحلة 6: القدرات المتقدمة والنشر

الخطوة 12: التصدير والنشر الإنتاجي

يدعم منشئ الوكلاء خيارات نشر متعددة:

Code

🎓 ملخص الوحدة 2 والخطوات التالية

🏆 الإنجاز المحقق: إتقان دمج MCP

✅ المهارات المكتسبة:

  • فهم بنية MCP وفوائده
  • استكشاف نظام خوادم MCP الخاص بـ Microsoft
  • دمج Playwright MCP مع AI Toolkit
  • بناء وكلاء أتمتة متصفح متقدمين
  • هندسة مطالبات متقدمة لأتمتة الويب

📚 موارد إضافية

🎉 تهانينا! لقد أتقنت دمج MCP بنجاح ويمكنك الآن بناء وكلاء ذكاء اصطناعي جاهزين للإنتاج مع قدرات أدوات خارجية!

🔜 الانتقال إلى الوحدة التالية

هل أنت مستعد للارتقاء بمهارات MCP الخاصة بك؟ تابع إلى الوحدة 3: تطوير MCP متقدم مع AI Toolkit حيث ستتعلم كيفية:

  • إنشاء خوادم MCP مخصصة خاصة بك
  • تكوين واستخدام أحدث SDK لـ MCP بلغة Python
  • إعداد MCP Inspector لأغراض التصحيح
  • إتقان سير عمل تطوير خوادم MCP المتقدم
  • بناء خادم MCP للطقس من الصفر

إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير خاطئ ناتج عن استخدام هذه الترجمة.