Skip to content

Latest commit

 

History

History
94 lines (60 loc) · 12.9 KB

File metadata and controls

94 lines (60 loc) · 12.9 KB

Scenario 3: VS Code ਵਿੱਚ MCP ਸਰਵਰ ਨਾਲ ਇਨ-ਐਡੀਟਰ ਡੌਕਸ

ਓਵਰਵਿਊ

ਇਸ ਸਿਨਾਰਿਓ ਵਿੱਚ, ਤੁਸੀਂ ਸਿੱਖੋਗੇ ਕਿ Microsoft Learn Docs ਨੂੰ MCP ਸਰਵਰ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਆਪਣੇ Visual Studio Code ਵਾਤਾਵਰਣ ਵਿੱਚ ਸਿੱਧਾ ਕਿਵੇਂ ਲਿਆਇਆ ਜਾ ਸਕਦਾ ਹੈ। ਬਰਾਊਜ਼ਰ ਟੈਬਸ ਬਦਲਦੇ ਰਹਿਣ ਦੀ ਥਾਂ, ਤੁਸੀਂ ਆਪਣੇ ਐਡੀਟਰ ਦੇ ਅੰਦਰ ਹੀ ਅਧਿਕਾਰਿਕ ਡੌਕਸ ਨੂੰ ਐਕਸੈਸ, ਖੋਜ ਅਤੇ ਹਵਾਲਾ ਦੇ ਸਕਦੇ ਹੋ। ਇਹ ਤਰੀਕਾ ਤੁਹਾਡੇ ਕੰਮ ਦੇ ਪ੍ਰਵਾਹ ਨੂੰ ਸੁਗਮ ਬਣਾਉਂਦਾ ਹੈ, ਤੁਹਾਨੂੰ ਧਿਆਨ ਕੇਂਦਰਿਤ ਰੱਖਦਾ ਹੈ ਅਤੇ GitHub Copilot ਵਰਗੇ ਟੂਲਾਂ ਨਾਲ ਬਿਨਾਂ ਰੁਕਾਵਟ ਦੇ ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਦੀ ਸਹੂਲਤ ਦਿੰਦਾ ਹੈ।

  • VS Code ਵਿੱਚ ਹੀ ਡੌਕਸ ਖੋਜੋ ਅਤੇ ਪੜ੍ਹੋ ਬਿਨਾਂ ਕੋਡਿੰਗ ਵਾਤਾਵਰਣ ਛੱਡੇ।
  • ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਦਾ ਹਵਾਲਾ ਦਿਓ ਅਤੇ README ਜਾਂ ਕੋਰਸ ਫਾਈਲਾਂ ਵਿੱਚ ਸਿੱਧੇ ਲਿੰਕ ਸ਼ਾਮਲ ਕਰੋ।
  • GitHub Copilot ਅਤੇ MCP ਨੂੰ ਇਕੱਠੇ ਵਰਤੋਂ ਕਰਕੇ ਇੱਕ ਬਿਨਾਂ ਰੁਕਾਵਟ, AI-ਸਮਰਥਿਤ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਵਰਕਫਲੋ ਬਣਾਓ।

ਸਿੱਖਣ ਦੇ ਲਕੜੇ

ਇਸ ਅਧਿਆਇ ਦੇ ਅੰਤ ਤੱਕ, ਤੁਸੀਂ ਸਮਝ ਜਾਵੋਗੇ ਕਿ VS Code ਵਿੱਚ MCP ਸਰਵਰ ਨੂੰ ਕਿਵੇਂ ਸੈੱਟਅਪ ਅਤੇ ਵਰਤਣਾ ਹੈ ਤਾਂ ਜੋ ਆਪਣੀ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਅਤੇ ਵਿਕਾਸ ਵਰਕਫਲੋ ਨੂੰ ਬਿਹਤਰ ਬਣਾਇਆ ਜਾ ਸਕੇ। ਤੁਸੀਂ ਸਮਰੱਥ ਹੋਵੋਗੇ:

  • MCP ਸਰਵਰ ਦੀ ਵਰਤੋਂ ਲਈ ਆਪਣੇ ਵਰਕਸਪੇਸ ਨੂੰ ਕਨਫਿਗਰ ਕਰਨਾ।
  • VS Code ਦੇ ਅੰਦਰੋਂ ਸਿੱਧਾ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਖੋਜਣਾ ਅਤੇ ਸ਼ਾਮਲ ਕਰਨਾ।
  • GitHub Copilot ਅਤੇ MCP ਦੀ ਤਾਕਤ ਨੂੰ ਮਿਲਾ ਕੇ ਇੱਕ ਜ਼ਿਆਦਾ ਉਤਪਾਦਕ, AI-ਸਹਾਇਤ ਵਰਕਫਲੋ ਬਣਾਉਣਾ।

ਇਹ ਹੁਨਰ ਤੁਹਾਨੂੰ ਧਿਆਨ ਕੇਂਦਰਿਤ ਰਹਿਣ, ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਦੀ ਗੁਣਵੱਤਾ ਸੁਧਾਰਨ ਅਤੇ ਵਿਕਾਸਕਾਰ ਜਾਂ ਤਕਨੀਕੀ ਲੇਖਕ ਵਜੋਂ ਤੁਹਾਡੀ ਉਤਪਾਦਕਤਾ ਵਧਾਉਣ ਵਿੱਚ ਮਦਦ ਕਰਨਗੇ।

ਹੱਲ

ਇਨ-ਐਡੀਟਰ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਐਕਸੈਸ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ, ਤੁਸੀਂ ਕੁਝ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋਗੇ ਜੋ MCP ਸਰਵਰ ਨੂੰ VS Code ਅਤੇ GitHub Copilot ਨਾਲ ਜੋੜਦੇ ਹਨ। ਇਹ ਹੱਲ ਕੋਰਸ ਲੇਖਕਾਂ, ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਲੇਖਕਾਂ ਅਤੇ ਵਿਕਾਸਕਾਰਾਂ ਲਈ ਬਹੁਤ ਵਧੀਆ ਹੈ ਜੋ ਡੌਕਸ ਅਤੇ Copilot ਨਾਲ ਕੰਮ ਕਰਦੇ ਸਮੇਂ ਆਪਣੇ ਧਿਆਨ ਨੂੰ ਐਡੀਟਰ ਵਿੱਚ ਹੀ ਰੱਖਣਾ ਚਾਹੁੰਦੇ ਹਨ।

  • ਕੋਰਸ ਜਾਂ ਪ੍ਰੋਜੈਕਟ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਲਿਖਦੇ ਸਮੇਂ README ਵਿੱਚ ਜਲਦੀ ਹਵਾਲਾ ਲਿੰਕ ਸ਼ਾਮਲ ਕਰੋ।
  • ਕੋਡ ਬਣਾਉਣ ਲਈ Copilot ਦੀ ਵਰਤੋਂ ਕਰੋ ਅਤੇ MCP ਨਾਲ ਤੁਰੰਤ ਸੰਬੰਧਿਤ ਡੌਕਸ ਲੱਭੋ ਅਤੇ ਹਵਾਲਾ ਦਿਓ।
  • ਆਪਣੇ ਐਡੀਟਰ ਵਿੱਚ ਧਿਆਨ ਕੇਂਦਰਿਤ ਰਹੋ ਅਤੇ ਉਤਪਾਦਕਤਾ ਵਧਾਓ।

ਕਦਮ-ਦਰ-ਕਦਮ ਗਾਈਡ

ਸ਼ੁਰੂ ਕਰਨ ਲਈ, ਇਹ ਕਦਮ ਫਾਲੋ ਕਰੋ। ਹਰ ਕਦਮ ਲਈ, ਤੁਸੀਂ ਪ੍ਰਕਿਰਿਆ ਨੂੰ ਵਿਜ਼ੂਅਲ ਤੌਰ 'ਤੇ ਦਰਸਾਉਣ ਲਈ assets ਫੋਲਡਰ ਤੋਂ ਸਕ੍ਰੀਨਸ਼ਾਟ ਸ਼ਾਮਲ ਕਰ ਸਕਦੇ ਹੋ।

  1. MCP ਕਨਫਿਗਰੇਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ: ਆਪਣੇ ਪ੍ਰੋਜੈਕਟ ਰੂਟ ਵਿੱਚ .vscode/mcp.json ਫਾਈਲ ਬਣਾਓ ਅਤੇ ਹੇਠਾਂ ਦਿੱਤੀ ਕਨਫਿਗਰੇਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ:

    {
      "servers": {
        "LearnDocsMCP": {
          "url": "https://learn.microsoft.com/api/mcp"
        }
      }
    }

    ਇਹ ਕਨਫਿਗਰੇਸ਼ਨ VS Code ਨੂੰ ਦੱਸਦੀ ਹੈ ਕਿ Microsoft Learn Docs MCP server ਨਾਲ ਕਿਵੇਂ ਕਨੈਕਟ ਕਰਨਾ ਹੈ।

    Step 1: Add mcp.json to .vscode folder

  2. GitHub Copilot Chat ਪੈਨਲ ਖੋਲ੍ਹੋ: ਜੇ ਤੁਹਾਡੇ ਕੋਲ GitHub Copilot ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਨਹੀਂ ਹੈ, ਤਾਂ VS Code ਵਿੱਚ Extensions ਵਿਊ 'ਤੇ ਜਾ ਕੇ ਇਸਨੂੰ ਇੰਸਟਾਲ ਕਰੋ। ਤੁਸੀਂ ਇਸਨੂੰ ਸਿੱਧਾ Visual Studio Code Marketplace ਤੋਂ ਡਾਊਨਲੋਡ ਕਰ ਸਕਦੇ ਹੋ। ਫਿਰ, ਸਾਈਡਬਾਰ ਤੋਂ Copilot Chat ਪੈਨਲ ਖੋਲ੍ਹੋ।

    Step 2: Open Copilot Chat panel

  3. ਏਜੰਟ ਮੋਡ ਚਾਲੂ ਕਰੋ ਅਤੇ ਟੂਲਾਂ ਦੀ ਜਾਂਚ ਕਰੋ: Copilot Chat ਪੈਨਲ ਵਿੱਚ, ਏਜੰਟ ਮੋਡ ਚਾਲੂ ਕਰੋ।

    Step 3: Enable agent mode and verify tools

    ਏਜੰਟ ਮੋਡ ਚਾਲੂ ਕਰਨ ਤੋਂ ਬਾਅਦ, ਯਕੀਨੀ ਬਣਾਓ ਕਿ MCP ਸਰਵਰ ਉਪਲਬਧ ਟੂਲਾਂ ਵਿੱਚ ਸ਼ਾਮਲ ਹੈ। ਇਸ ਨਾਲ ਇਹ ਪੱਕਾ ਹੁੰਦਾ ਹੈ ਕਿ Copilot ਏਜੰਟ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਸਰਵਰ ਤੱਕ ਪਹੁੰਚ ਸਕਦਾ ਹੈ ਅਤੇ ਸੰਬੰਧਿਤ ਜਾਣਕਾਰੀ ਲੈ ਸਕਦਾ ਹੈ।

    Step 3: Verify MCP server tool

  4. ਨਵਾਂ ਚੈਟ ਸ਼ੁਰੂ ਕਰੋ ਅਤੇ ਏਜੰਟ ਨੂੰ ਪ੍ਰਾਂਪਟ ਕਰੋ: Copilot Chat ਪੈਨਲ ਵਿੱਚ ਨਵਾਂ ਚੈਟ ਖੋਲ੍ਹੋ। ਹੁਣ ਤੁਸੀਂ ਆਪਣੇ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਸਵਾਲਾਂ ਨਾਲ ਏਜੰਟ ਨੂੰ ਪ੍ਰਾਂਪਟ ਕਰ ਸਕਦੇ ਹੋ। ਏਜੰਟ MCP ਸਰਵਰ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸੰਬੰਧਿਤ Microsoft Learn ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਸਿੱਧਾ ਤੁਹਾਡੇ ਐਡੀਟਰ ਵਿੱਚ ਲਿਆਵੇਗਾ।

    • "ਮੈਂ ਵਿਸ਼ਾ X ਲਈ ਇੱਕ ਅਧਿਐਨ ਯੋਜਨਾ ਲਿਖਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰ ਰਿਹਾ ਹਾਂ। ਮੈਂ ਇਸਨੂੰ 8 ਹਫ਼ਤੇ ਲਈ ਪੜ੍ਹਾਂਗਾ, ਹਰ ਹਫ਼ਤੇ ਲਈ ਮੈਨੂੰ ਸਲਾਹ ਦਿਓ ਕਿ ਕਿਹੜਾ ਸਮੱਗਰੀ ਲੈਣੀ ਚਾਹੀਦੀ ਹੈ।"

    Step 4: Prompt the agent in chat

  5. ਲਾਈਵ ਕਵੈਰੀ:

    ਆਓ Azure AI Foundry Discord ਦੇ #get-help ਸੈਕਸ਼ਨ ਤੋਂ ਇੱਕ ਲਾਈਵ ਕਵੈਰੀ ਲੈਂਦੇ ਹਾਂ (ਮੂਲ ਸੁਨੇਹਾ ਵੇਖੋ):

    "ਮੈਂ Azure AI Foundry 'ਤੇ ਵਿਕਸਤ ਕੀਤੇ ਗਏ AI ਏਜੰਟਾਂ ਨਾਲ ਇੱਕ ਮਲਟੀ-ਏਜੰਟ ਹੱਲ ਨੂੰ ਡਿਪਲੋਇ ਕਰਨ ਦੇ ਤਰੀਕੇ ਬਾਰੇ ਜਵਾਬ ਲੱਭ ਰਿਹਾ ਹਾਂ। ਮੈਂ ਵੇਖਦਾ ਹਾਂ ਕਿ ਕੋਈ ਸਿੱਧਾ ਡਿਪਲੋਇਮੈਂਟ ਤਰੀਕਾ ਨਹੀਂ ਹੈ, ਜਿਵੇਂ ਕਿ Copilot Studio ਚੈਨਲ। ਤਾਂ, ਵੱਖ-ਵੱਖ ਤਰੀਕੇ ਕੀ ਹਨ ਜਿਨ੍ਹਾਂ ਨਾਲ ਐਂਟਰਪ੍ਰਾਈਜ਼ ਯੂਜ਼ਰ ਇਸ ਡਿਪਲੋਇਮੈਂਟ ਨੂੰ ਕਰ ਸਕਦੇ ਹਨ ਅਤੇ ਕੰਮ ਪੂਰਾ ਕਰ ਸਕਦੇ ਹਨ? ਕਈ ਲੇਖ/ਬਲੌਗ ਹਨ ਜੋ ਕਹਿੰਦੇ ਹਨ ਕਿ ਅਸੀਂ Azure Bot ਸਰਵਿਸ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹਾਂ ਜੋ MS Teams ਅਤੇ Azure AI Foundry ਏਜੰਟਾਂ ਵਿਚਕਾਰ ਪੁਲ ਵਜੋਂ ਕੰਮ ਕਰ ਸਕਦਾ ਹੈ, ਪਰ ਕੀ ਇਹ ਕੰਮ ਕਰੇਗਾ ਜੇ ਮੈਂ ਇੱਕ Azure ਬੋਟ ਸੈੱਟਅਪ ਕਰਾਂ ਜੋ Azure AI Foundry ਦੇ Orchestrator Agent ਨਾਲ Azure ਫੰਕਸ਼ਨ ਰਾਹੀਂ ਜੁੜਦਾ ਹੋਵੇ ਜਾਂ ਮੈਨੂੰ ਹਰ AI ਏਜੰਟ ਲਈ ਵੱਖ-ਵੱਖ Azure ਫੰਕਸ਼ਨ ਬਣਾਉਣੇ ਪੈਣਗੇ ਜੋ ਬੋਟ ਫਰੇਮਵਰਕ 'ਤੇ ਆਰਕੀਸਟ੍ਰੇਸ਼ਨ ਕਰਦੇ ਹਨ? ਹੋਰ ਕੋਈ ਸੁਝਾਅ ਸਵਾਗਤਯੋਗ ਹਨ।"

    Step 5: Live queries

    ਏਜੰਟ ਸੰਬੰਧਿਤ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਲਿੰਕ ਅਤੇ ਸੰਖੇਪ ਦੇ ਕੇ ਜਵਾਬ ਦੇਵੇਗਾ, ਜਿਹਨਾਂ ਨੂੰ ਤੁਸੀਂ ਸਿੱਧਾ ਆਪਣੇ ਮਾਰਕਡਾਊਨ ਫਾਈਲਾਂ ਵਿੱਚ ਸ਼ਾਮਲ ਕਰ ਸਕਦੇ ਹੋ ਜਾਂ ਕੋਡ ਵਿੱਚ ਹਵਾਲੇ ਵਜੋਂ ਵਰਤ ਸਕਦੇ ਹੋ।

ਨਮੂਨਾ ਕਵੈਰੀਜ਼

ਇੱਥੇ ਕੁਝ ਉਦਾਹਰਨ ਕਵੈਰੀਜ਼ ਹਨ ਜੋ ਤੁਸੀਂ ਕੋਸ਼ਿਸ਼ ਕਰ ਸਕਦੇ ਹੋ। ਇਹ ਕਵੈਰੀਜ਼ ਦਿਖਾਉਂਦੀਆਂ ਹਨ ਕਿ MCP ਸਰਵਰ ਅਤੇ Copilot ਕਿਵੇਂ ਮਿਲ ਕੇ ਤੁਰੰਤ, ਸੰਦਰਭ-ਸੂਚਕ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਅਤੇ ਹਵਾਲੇ ਪ੍ਰਦਾਨ ਕਰ ਸਕਦੇ ਹਨ ਬਿਨਾਂ VS Code ਛੱਡੇ:

  • "ਮੈਨੂੰ ਦੱਸੋ ਕਿ Azure Functions triggers ਕਿਵੇਂ ਵਰਤਣੇ ਹਨ।"
  • "Azure Key Vault ਦੀ ਅਧਿਕਾਰਿਕ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਲਈ ਲਿੰਕ ਸ਼ਾਮਲ ਕਰੋ।"
  • "Azure ਸਰੋਤਾਂ ਦੀ ਸੁਰੱਖਿਆ ਲਈ ਸਭ ਤੋਂ ਵਧੀਆ ਅਭਿਆਸ ਕੀ ਹਨ?"
  • "Azure AI ਸੇਵਾਵਾਂ ਲਈ ਇੱਕ quickstart ਲੱਭੋ।"

ਇਹ ਕਵੈਰੀਜ਼ ਦਿਖਾਉਂਦੀਆਂ ਹਨ ਕਿ MCP ਸਰਵਰ ਅਤੇ Copilot ਕਿਵੇਂ ਮਿਲ ਕੇ ਤੁਰੰਤ, ਸੰਦਰਭ-ਸੂਚਕ ਡੌਕੂਮੈਂਟੇਸ਼ਨ ਅਤੇ ਹਵਾਲੇ ਪ੍ਰਦਾਨ ਕਰ ਸਕਦੇ ਹਨ ਬਿਨਾਂ VS Code ਛੱਡੇ।


ਅਸਵੀਕਾਰੋਪਣ:
ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ Co-op Translator ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦਿਤ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸਮਰਥਤਾਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ, ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਉਤਪੰਨ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆ ਲਈ ਅਸੀਂ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।