README.md

استهلاك خادم من امتداد AI Toolkit لبرنامج Visual Studio Code

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

لنفترض أنك تربط وكيلًا بخادم MCP الخاص بالآلة الحاسبة. فجأة، يمكن لوكيلك إجراء عمليات حسابية بمجرد استلامه لمطالبة مثل "ما حاصل ضرب 47 في 89؟" — دون الحاجة إلى ترميز المنطق يدويًا أو بناء واجهات برمجة تطبيقات مخصصة.

نظرة عامة

يغطي هذا الدرس كيفية ربط خادم MCP الخاص بالآلة الحاسبة بوكيل باستخدام امتداد AI Toolkit في Visual Studio Code، مما يمكن وكيلك من إجراء عمليات حسابية مثل الجمع والطرح والضرب والقسمة من خلال اللغة الطبيعية.

يُعد AI Toolkit امتدادًا قويًا لبرنامج Visual Studio Code يبسط تطوير الوكلاء. يمكن لمهندسي الذكاء الاصطناعي بسهولة بناء تطبيقات ذكاء اصطناعي عن طريق تطوير واختبار نماذج الذكاء الاصطناعي التوليدية — محليًا أو في السحابة. يدعم الامتداد معظم النماذج التوليدية الرئيسية المتاحة اليوم.

ملاحظة: يدعم AI Toolkit حاليًا بايثون وTypeScript.

أهداف التعلم

بنهاية هذا الدرس، ستكون قادرًا على:

• استهلاك خادم MCP عبر AI Toolkit.
• تكوين إعدادات الوكيل لتمكينه من اكتشاف واستخدام الأدوات التي يوفرها خادم MCP.
• استخدام أدوات MCP عبر اللغة الطبيعية.

النهج

إليك كيف نحتاج إلى التعامل مع هذا على مستوى عالٍ:

• إنشاء وكيل وتحديد مطالبة النظام الخاصة به.
• إنشاء خادم MCP يحتوي على أدوات آلة حاسبة.
• ربط منشئ الوكيل بخادم MCP.
• اختبار استدعاء أدوات الوكيل عبر اللغة الطبيعية.

رائع، الآن بعد أن فهمنا التسلسل، دعنا نكوّن وكيل ذكاء اصطناعي للاستفادة من الأدوات الخارجية عبر MCP، مما يعزز قدراته!

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

• Visual Studio Code
• AI Toolkit لـ Visual Studio Code

التمرين: استهلاك خادم

في هذا التمرين، ستبني وتشغّل وتعزّز وكيل ذكاء اصطناعي باستخدام أدوات من خادم MCP داخل Visual Studio Code باستخدام AI Toolkit.

-0- الخطوة التمهيدية، أضف نموذج OpenAI GPT-4o إلى نماذجي

يعتمد التمرين على نموذج GPT-4o. يجب إضافة النموذج إلى نماذجي قبل إنشاء الوكيل.

1. افتح امتداد AI Toolkit من شريط النشاط.
2. في قسم الكتالوج، اختر النماذج لفتح كتالوج النماذج. فتح النماذج يفتح كتالوج النماذج في تبويب محرر جديد.
3. في شريط البحث داخل كتالوج النماذج، اكتب OpenAI GPT-4o.
4. انقر على + إضافة لإضافة النموذج إلى قائمة نماذجي. تأكد من اختيار النموذج الذي يستضيفه GitHub.
5. في شريط النشاط، تحقق من ظهور نموذج OpenAI GPT-4o في القائمة.

-1- إنشاء وكيل

يتيح لك منشئ الوكيل (المطالبة) إنشاء وتخصيص وكلاء مدعومين بالذكاء الاصطناعي. في هذا القسم، ستنشئ وكيلًا جديدًا وتعيّن نموذجًا لتشغيل المحادثة.

1. افتح امتداد AI Toolkit من شريط النشاط.
2. في قسم الأدوات، اختر منشئ الوكيل (المطالبة). فتح منشئ الوكيل (المطالبة) يفتح تبويب محرر جديد.
3. انقر على زر + وكيل جديد. سيطلق الامتداد معالج إعداد عبر لوحة الأوامر.
4. أدخل الاسم وكيل الآلة الحاسبة واضغط إدخال.
5. في منشئ الوكيل (المطالبة)، في حقل النموذج، اختر نموذج OpenAI GPT-4o (عبر GitHub).

-2- إنشاء مطالبة نظام للوكيل

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

1. في قسم المطالبات، انقر على زر توليد مطالبة النظام. يفتح هذا الزر منشئ المطالبات الذي يستخدم الذكاء الاصطناعي لتوليد مطالبة نظام للوكيل.
2. في نافذة توليد مطالبة، أدخل ما يلي: You are a helpful and efficient math assistant. When given a problem involving basic arithmetic, you respond with the correct result.
3. انقر على زر توليد. ستظهر إشعار في الزاوية اليمنى السفلى يؤكد أن مطالبة النظام قيد التوليد. بمجرد اكتمال التوليد، ستظهر المطالبة في حقل مطالبة النظام في منشئ الوكيل (المطالبة).
4. راجع مطالبة النظام وعدلها إذا لزم الأمر.

-3- إنشاء خادم MCP

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

يأتي AI Toolkit مزودًا بقوالب لتسهيل إنشاء خادم MCP خاص بك. سنستخدم قالب بايثون لإنشاء خادم MCP للآلة الحاسبة.

ملاحظة: يدعم AI Toolkit حاليًا بايثون وTypeScript.

1. في قسم الأدوات في منشئ الوكيل (المطالبة)، انقر على زر + خادم MCP. سيطلق الامتداد معالج إعداد عبر لوحة الأوامر.

2. اختر + إضافة خادم.

3. اختر إنشاء خادم MCP جديد.

4. اختر قالب python-weather.

5. اختر المجلد الافتراضي لحفظ قالب خادم MCP.

6. أدخل الاسم التالي للخادم: Calculator

7. سيفتح نافذة جديدة من Visual Studio Code. اختر نعم، أثق بالمؤلفين.

8. باستخدام الطرفية (Terminal > New Terminal)، أنشئ بيئة افتراضية: python -m venv .venv

9. باستخدام الطرفية، فعّل البيئة الافتراضية:

   1. ويندوز - .venv\Scripts\activate
   2. macOS/Linux - source venv/bin/activate

10. باستخدام الطرفية، ثبّت التبعيات: pip install -e .[dev]

11. في عرض المستكشف بشريط النشاط، وسّع دليل src واختر ملف server.py لفتحه في المحرر.

12. استبدل الكود في ملف server.py بما يلي واحفظ:

    """
    Sample MCP Calculator Server implementation in Python.
    
    
    This module demonstrates how to create a simple MCP server with calculator tools
    that can perform basic arithmetic operations (add, subtract, multiply, divide).
    """
    
    from mcp.server.fastmcp import FastMCP
    
    server = FastMCP("calculator")
    
    @server.tool()
    def add(a: float, b: float) -> float:
        """Add two numbers together and return the result."""
        return a + b
    
    @server.tool()
    def subtract(a: float, b: float) -> float:
        """Subtract b from a and return the result."""
        return a - b
    
    @server.tool()
    def multiply(a: float, b: float) -> float:
        """Multiply two numbers together and return the result."""
        return a * b
    
    @server.tool()
    def divide(a: float, b: float) -> float:
        """
        Divide a by b and return the result.
        
        Raises:
            ValueError: If b is zero
        """
        if b == 0:
            raise ValueError("Cannot divide by zero")
        return a / b

-4- تشغيل الوكيل مع خادم MCP للآلة الحاسبة

الآن بعد أن أصبح لدى وكيلك أدوات، حان وقت استخدامها! في هذا القسم، سترسل مطالبات إلى الوكيل لاختبار والتحقق مما إذا كان الوكيل يستخدم الأداة المناسبة من خادم MCP للآلة الحاسبة.

ستشغّل خادم MCP للآلة الحاسبة على جهاز التطوير المحلي عبر منشئ الوكيل كعميل MCP.

1. اضغط F5 to start debugging the MCP server. The Agent (Prompt) Builder will open in a new editor tab. The status of the server is visible in the terminal.
2. In the User prompt field of the Agent (Prompt) Builder, enter the following prompt: اشتريت 3 عناصر بسعر 25 دولارًا لكل منها، ثم استخدمت خصمًا بقيمة 20 دولارًا. كم دفعت؟
3. Click the Run button to generate the agent's response.
4. Review the agent output. The model should conclude that you paid $55.
5. Here's a breakdown of what should occur:
   • The agent selects the multiply and substract tools to aid in the calculation.
   • The respective a and b values are assigned for the multiply tool.
   • The respective a and b القيم تم تعيينها لأداة subtract.
   • يتم توفير الاستجابة من كل أداة في استجابة الأداة الخاصة بها.
   • يتم توفير الإخراج النهائي من النموذج في استجابة النموذج النهائية.
6. قدّم مطالبات إضافية لاختبار الوكيل بشكل أعمق. يمكنك تعديل المطالبة الحالية في حقل مطالبة المستخدم بالنقر داخل الحقل واستبدال المطالبة الموجودة.
7. بمجرد الانتهاء من اختبار الوكيل، يمكنك إيقاف الخادم عبر الطرفية بإدخال CTRL/CMD+C للخروج.

المهمة

حاول إضافة إدخال أداة إضافي إلى ملف server.py الخاص بك (مثل: إرجاع الجذر التربيعي لرقم). قدّم مطالبات إضافية تتطلب من الوكيل استخدام أداتك الجديدة (أو الأدوات الموجودة). تأكد من إعادة تشغيل الخادم لتحميل الأدوات المضافة حديثًا.

الحل

الحل

النقاط الرئيسية

النقاط الأساسية من هذا الفصل هي:

• امتداد AI Toolkit هو عميل رائع يتيح لك استهلاك خوادم MCP وأدواتها.
• يمكنك إضافة أدوات جديدة إلى خوادم MCP، مما يوسع قدرات الوكيل لتلبية المتطلبات المتطورة.
• يتضمن AI Toolkit قوالب (مثل قوالب خادم MCP للبايثون) لتبسيط إنشاء الأدوات المخصصة.

موارد إضافية

• وثائق AI Toolkit

ماذا بعد

• التالي: الاختبار وتصحيح الأخطاء

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