Skip to content

README.md

Latest commit

 

History

History
180 lines (124 loc) · 23.1 KB

README.md

File metadata and controls

180 lines (124 loc) · 23.1 KB

भिजुअल स्टुडियो कोडको लागि एआई टूलकिट एक्सटेन्सनबाट सर्भर प्रयोग गर्ने

जब तपाईं एआई एजेन्ट निर्माण गर्दै हुनुहुन्छ, यो केवल स्मार्ट उत्तरहरू उत्पन्न गर्ने कुरा मात्र होइन; यो तपाईंको एजेन्टलाई कार्य गर्न सक्षम बनाउने कुरा पनि हो। यही ठाउँमा मोडल कन्टेक्स्ट प्रोटोकल (MCP) काममा आउँछ। MCP ले एजेन्टहरूलाई बाह्य उपकरणहरू र सेवाहरूलाई एकरूप तरिकाले पहुँच गर्न सजिलो बनाउँछ। यसलाई तपाईंको एजेन्टलाई वास्तवमै प्रयोग गर्न सक्ने उपकरणको बाकसमा जडान गर्ने जस्तै सोच्नुहोस्।

मानौं तपाईंले आफ्नो एजेन्टलाई क्याल्कुलेटर MCP सर्भरसँग जडान गर्नुभयो। अचानक, तपाईंको एजेन्टले "४७ गुणा ८९ कति हुन्छ?" जस्तो सोध्दा गणितीय अपरेशनहरू गर्न सक्छ—तर्कलाई हार्डकोड गर्न वा कस्टम API निर्माण गर्न आवश्यक पर्दैन।

अवलोकन

यस पाठले कसरी क्याल्कुलेटर MCP सर्भरलाई एआई टूलकिट एक्सटेन्सनको साथ एजेन्टसँग जडान गर्ने कभर गर्दछ, जसले तपाईंको एजेन्टलाई प्राकृतिक भाषाको माध्यमबाट जोड, घटाउ, गुणा, र भाग जस्ता गणितीय अपरेशनहरू गर्न सक्षम बनाउँछ।

एआई टूलकिट भिजुअल स्टुडियो कोडको लागि एक शक्तिशाली एक्सटेन्सन हो जसले एजेन्ट विकासलाई सरल बनाउँछ। एआई इन्जिनियरहरूले स्थानीय रूपमा वा क्लाउडमा जेनेरेटिभ एआई मोडेलहरू विकास र परीक्षण गरेर सजिलै एआई एप्लिकेसनहरू निर्माण गर्न सक्छन्। यो एक्सटेन्सनले आज उपलब्ध अधिकांश प्रमुख जेनेरेटिभ मोडेलहरूलाई समर्थन गर्दछ।

नोट: एआई टूलकिटले हाल पायथन र टाइपस्क्रिप्टलाई समर्थन गर्दछ।

सिकाइ उद्देश्यहरू

यस पाठको अन्त्यसम्म, तपाईंले निम्न गर्न सक्षम हुनुहुनेछ:

  • एआई टूलकिटमार्फत MCP सर्भर प्रयोग गर्नुहोस्।
  • MCP सर्भरले प्रदान गर्ने उपकरणहरू पत्ता लगाउन र प्रयोग गर्न सक्षम बनाउन एजेन्ट कन्फिगरेसन कन्फिगर गर्नुहोस्।
  • प्राकृतिक भाषाको माध्यमबाट MCP उपकरणहरू प्रयोग गर्नुहोस्।

दृष्टिकोण

हामीले यसलाई उच्च स्तरमा यसरी दृष्टिकोण गर्नुपर्छ:

  • एजेन्ट सिर्जना गर्नुहोस् र यसको सिस्टम प्रम्प्ट परिभाषित गर्नुहोस्।
  • क्याल्कुलेटर उपकरणहरूसहित MCP सर्भर सिर्जना गर्नुहोस्।
  • MCP सर्भरसँग एजेन्ट बिल्डर जडान गर्नुहोस्।
  • प्राकृतिक भाषाको माध्यमबाट एजेन्टको उपकरण प्रयोग परीक्षण गर्नुहोस्।

ठीक छ, अब हामीले प्रवाह बुझेका छौं, आउनुहोस् MCP मार्फत बाह्य उपकरणहरूको लाभ उठाउन एआई एजेन्टलाई कन्फिगर गरौं, यसको क्षमताहरू बढाउँदै!

पूर्वआवश्यकताहरू

अभ्यास: सर्भर प्रयोग गर्नुहोस्

Warning

macOS प्रयोगकर्ताहरूका लागि नोट। हामी हाल macOS मा निर्भरता स्थापना प्रभावित गर्ने समस्याको अनुसन्धान गर्दैछौं। परिणामस्वरूप, macOS प्रयोगकर्ताहरूले यो ट्युटोरियल हाल पूरा गर्न सक्ने छैनन्। समाधान उपलब्ध भएपछि हामी निर्देशनहरू अद्यावधिक गर्नेछौं। तपाईंको धैर्यता र समझदारीका लागि धन्यवाद!

यस अभ्यासमा, तपाईंले एआई टूलकिट प्रयोग गरेर भिजुअल स्टुडियो कोडभित्र MCP सर्भरबाट उपकरणहरूसहित एआई एजेन्ट निर्माण, चलाउने, र सुधार गर्नेछ।

-0- प्रारम्भिक चरण, OpenAI GPT-4o मोडेललाई My Models मा थप्नुहोस्

यस अभ्यासले GPT-4o मोडेल प्रयोग गर्दछ। एजेन्ट सिर्जना गर्नु अघि यो मोडेललाई My Models मा थपिएको हुनुपर्छ।

  1. AI Toolkit एक्सटेन्सनलाई Activity Bar बाट खोल्नुहोस्।
  2. Catalog सेक्सनमा, Models चयन गर्नुहोस् र Model Catalog खोल्नुहोस्। Models चयन गर्दा Model Catalog नयाँ सम्पादक ट्याबमा खुल्छ।
  3. Model Catalog को खोज पट्टीमा OpenAI GPT-4o प्रविष्ट गर्नुहोस्।
  4. + Add क्लिक गरेर मोडेललाई आफ्नो My Models सूचीमा थप्नुहोस्। सुनिश्चित गर्नुहोस् कि तपाईंले GitHub द्वारा होस्ट गरिएको मोडेल चयन गर्नुभएको छ।
  5. Activity Bar मा, OpenAI GPT-4o मोडेल सूचीमा देखिएको छ भनी पुष्टि गर्नुहोस्।

-1- एजेन्ट सिर्जना गर्नुहोस्

Agent (Prompt) Builder ले तपाईंलाई आफ्नै एआई-संचालित एजेन्टहरू सिर्जना र अनुकूलन गर्न सक्षम बनाउँछ। यस खण्डमा, तपाईं नयाँ एजेन्ट सिर्जना गर्नुहुनेछ र वार्तालापलाई शक्ति प्रदान गर्न मोडेल असाइन गर्नुहुनेछ।

  1. AI Toolkit एक्सटेन्सनलाई Activity Bar बाट खोल्नुहोस्।
  2. Tools सेक्सनमा, Agent (Prompt) Builder चयन गर्नुहोस्। Agent (Prompt) Builder चयन गर्दा यो नयाँ सम्पादक ट्याबमा खुल्छ।
  3. + New Agent बटन क्लिक गर्नुहोस्। एक्सटेन्सनले Command Palette मार्फत सेटअप विजार्ड सुरु गर्नेछ।
  4. Calculator Agent नाम प्रविष्ट गर्नुहोस् र Enter थिच्नुहोस्।
  5. Agent (Prompt) Builder मा, Model फिल्डका लागि OpenAI GPT-4o (via GitHub) मोडेल चयन गर्नुहोस्।

-2- एजेन्टको लागि सिस्टम प्रम्प्ट सिर्जना गर्नुहोस्

एजेन्टको संरचना तयार भएपछि, यसको व्यक्तित्व र उद्देश्य परिभाषित गर्ने समय हो। यस खण्डमा, तपाईं Generate system prompt सुविधा प्रयोग गरेर एजेन्टको इच्छित व्यवहार वर्णन गर्नुहुनेछ—यस अवस्थामा, क्याल्कुलेटर एजेन्ट—र मोडेललाई तपाईंको लागि सिस्टम प्रम्प्ट लेख्न लगाउनुहुनेछ।

  1. Prompts सेक्सनका लागि, Generate system prompt बटन क्लिक गर्नुहोस्। यो बटनले प्रम्प्ट बिल्डर खोल्छ, जसले एआई प्रयोग गरेर एजेन्टको लागि सिस्टम प्रम्प्ट सिर्जना गर्दछ।
  2. Generate a prompt विन्डोमा, निम्न प्रविष्ट गर्नुहोस्: तपाईं एक सहयोगी र कुशल गणित सहायक हुनुहुन्छ। जब आधारभूत अंकगणितमा समस्या दिइन्छ, तपाईं सही परिणामको साथ प्रतिक्रिया दिनुहुन्छ।
  3. Generate बटन क्लिक गर्नुहोस्। तल्लो-दायाँ कुनामा एक सूचना देखिनेछ जसले पुष्टि गर्दछ कि सिस्टम प्रम्प्ट सिर्जना भइरहेको छ। प्रम्प्ट सिर्जना पूरा भएपछि, यो Agent (Prompt) Builder को System prompt फिल्डमा देखिनेछ।
  4. System prompt समीक्षा गर्नुहोस् र आवश्यक भएमा परिमार्जन गर्नुहोस्।

-3- MCP सर्भर सिर्जना गर्नुहोस्

अब तपाईंले एजेन्टको सिस्टम प्रम्प्ट परिभाषित गर्नुभयो—यसको व्यवहार र प्रतिक्रियाहरूलाई मार्गदर्शन गर्दै—अब यसलाई व्यावहारिक क्षमताहरूले सुसज्जित गर्ने समय हो। यस खण्डमा, तपाईं गणना, घटाउ, गुणा, र भाग गणनाहरू कार्यान्वयन गर्न उपकरणहरूसहित क्याल्कुलेटर MCP सर्भर सिर्जना गर्नुहुनेछ। यो सर्भरले तपाईंको एजेन्टलाई प्राकृतिक भाषाको प्रम्प्टहरूको जवाफमा वास्तविक-समय गणितीय अपरेशनहरू गर्न सक्षम बनाउनेछ।

AI Toolkit ले आफ्नै MCP सर्भर सिर्जना गर्न सजिलो बनाउन टेम्प्लेटहरूसँग सुसज्जित छ। हामी क्याल्कुलेटर MCP सर्भर सिर्जना गर्न पायथन टेम्प्लेट प्रयोग गर्नेछौं।

नोट: एआई टूलकिटले हाल पायथन र टाइपस्क्रिप्टलाई समर्थन गर्दछ।

  1. Agent (Prompt) Builder को Tools सेक्सनमा, + MCP Server बटन क्लिक गर्नुहोस्। एक्सटेन्सनले Command Palette मार्फत सेटअप विजार्ड सुरु गर्नेछ।

  2. + Add Server चयन गर्नुहोस्।

  3. Create a New MCP Server चयन गर्नुहोस्।

  4. python-weather टेम्प्लेट चयन गर्नुहोस्।

  5. Default folder चयन गरेर MCP सर्भर टेम्प्लेट सुरक्षित गर्नुहोस्।

  6. सर्भरको लागि निम्न नाम प्रविष्ट गर्नुहोस्: Calculator

  7. नयाँ भिजुअल स्टुडियो कोड विन्डो खुल्नेछ। Yes, I trust the authors चयन गर्नुहोस्।

  8. Terminal प्रयोग गरेर भर्चुअल वातावरण सिर्जना गर्नुहोस्: python -m venv .venv

  9. Terminal प्रयोग गरेर भर्चुअल वातावरण सक्रिय गर्नुहोस्:

    1. Windows - .venv\Scripts\activate
    2. macOS/Linux - source .venv/bin/activate

  10. Terminal प्रयोग गरेर निर्भरता स्थापना गर्नुहोस्: pip install -e .[dev]

  11. Activity Bar को Explorer दृश्यमा, 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 सर्भरबाट उपयुक्त उपकरण प्रयोग गर्छ कि गर्दैन।

  1. MCP सर्भर डिबग गर्न F5 थिच्नुहोस्। Agent (Prompt) Builder नयाँ सम्पादक ट्याबमा खुल्नेछ। सर्भरको स्थिति टर्मिनलमा देखिनेछ।
  2. Agent (Prompt) Builder को User prompt फिल्डमा निम्न प्रम्प्ट प्रविष्ट गर्नुहोस्: मैले $२५ का ३ वस्तुहरू किनेँ, र त्यसपछि $२० छुट प्रयोग गरें। मैले कति तिरेँ?
  3. Run बटन क्लिक गरेर एजेन्टको प्रतिक्रिया उत्पन्न गर्नुहोस्।
  4. एजेन्टको आउटपुट समीक्षा गर्नुहोस्। मोडेलले निष्कर्ष निकाल्नुपर्छ कि तपाईंले $५५ तिर्‍नुभयो।
  5. यहाँ के हुनुपर्छ भन्ने ब्रेकडाउन छ:
    • एजेन्टले गणनाका लागि multiply र subtract उपकरणहरू चयन गर्छ।
    • multiply उपकरणका लागि सम्बन्धित a र b मानहरू असाइन गरिन्छ।
    • subtract उपकरणका लागि सम्बन्धित a र b मानहरू असाइन गरिन्छ।
    • प्रत्येक उपकरणबाट प्रतिक्रिया सम्बन्धित Tool Response मा प्रदान गरिन्छ।
    • मोडेलबाट अन्तिम आउटपुट अन्तिम Model Response मा प्रदान गरिन्छ।
  6. थप परीक्षणका लागि अतिरिक्त प्रम्प्टहरू सबमिट गर्नुहोस्। तपाईं User prompt फिल्डमा रहेको प्रम्प्टलाई क्लिक गरेर प्रतिस्थापन गर्न सक्नुहुन्छ।
  7. परीक्षण समाप्त भएपछि, terminal मार्फत CTRL/CMD+C प्रविष्ट गरेर सर्भर बन्द गर्न सक्नुहुन्छ।

असाइनमेन्ट

आफ्नो server.py फाइलमा थप उपकरण प्रविष्टि थप्ने प्रयास गर्नुहोस् (उदाहरण: कुनै सङ्ख्याको वर्गमूल फिर्ता गर्नुहोस्)। एजेन्टलाई तपाईंको नयाँ उपकरण (वा विद्यमान उपकरणहरू) प्रयोग गर्न आवश्यक पर्ने थप प्रम्प्टहरू सबमिट गर्नुहोस्। नयाँ उपकरणहरू लोड गर्न सर्भर पुनः सुरु गर्न निश्चित गर्नुहोस्।

समाधान

Solution

मुख्य बुँदाहरू

यस अध्यायबाट मुख्य बुँदाहरू निम्न छन्:

  • एआई टूलकिट एक्सटेन्सन एक उत्कृष्ट क्लाइन्ट हो जसले तपाईंलाई MCP सर्भरहरू र तिनका उपकरणहरू प्रयोग गर्न दिन्छ।
  • तपाईं MCP सर्भरहरूमा नयाँ उपकरणहरू थप्न सक्नुहुन्छ, एजेन्टको क्षमताहरूलाई विकसित आवश्यकताहरू पूरा गर्न विस्तार गर्दै।
  • एआई टूलकिटले कस्टम उपकरणहरूको सिर्जना सरल बनाउन टेम्प्लेटहरू (जस्तै, पायथन MCP सर्भर टेम्प्लेटहरू) समावेश गर्दछ।

थप स्रोतहरू

अब के गर्ने?

अस्वीकरण:
यो दस्तावेज़ AI अनुवाद सेवा Co-op Translator प्रयोग गरेर अनुवाद गरिएको छ। हामी यथार्थताको लागि प्रयास गर्छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादमा त्रुटिहरू वा अशुद्धताहरू हुन सक्छ। यसको मूल भाषा मा रहेको मूल दस्तावेज़लाई आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीको लागि, व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलतफहमी वा गलत व्याख्याको लागि हामी जिम्मेवार हुने छैनौं।