इसके माध्यम से साझा किया गया


उपकरण जोड़ें और प्रबंधित करें

महत्त्वपूर्ण

Microsoft Agent 365 तक शीघ्र पहुँच प्राप्त करने के लिए आपको Frontier पूर्वावलोकन प्रोग्राम का भाग बनने की आवश्यकता है. फ्रंटियर आपको सीधे Microsoft के नवीनतम AI नवाचारों से जोड़ता है। फ्रंटियर पूर्वावलोकन आपके ग्राहक समझौतों की मौजूदा पूर्वावलोकन शर्तों के अधीन हैं। चूंकि ये सुविधाएँ अभी भी विकास में हैं, इसलिए उनकी उपलब्धता और क्षमताएं समय के साथ बदल सकती हैं।

टूलींग मॉड्यूल डेवलपर्स को एआई एजेंट वर्कफ़्लो में मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर को खोजने, कॉन्फ़िगर करने और एकीकृत करने में सक्षम बनाता है। एमसीपी सर्वर बाहरी क्षमताओं को ऐसे उपकरणों के रूप में उजागर करते हैं जिन्हें एआई एजेंट लागू कर सकते हैं। उपलब्ध टूलींग सर्वर के अवलोकन के लिए, एजेंट 365 टूलींग सर्वर देखें

अनुरोध और प्रतिक्रिया प्रवाह प्रदर्शित करता है

ओवरव्यू

एजेंट 365 टूलींग एकीकरण चार-चरणीय वर्कफ़्लो का अनुसरण करता है:

  1. MCP सर्वर कॉन्फ़िगर करें - खोजने और MCP सर्वर जोड़ने के लिए एजेंट 365 CLI का उपयोग करें
  2. मैनिफेस्ट जनरेट करें - CLI सर्वर कॉन्फ़िगरेशन के साथ बनाता ToolingManifest.json है
  3. कोड में एकीकृत करें - अपने ऑर्केस्ट्रेटर के साथ मेनिफेस्ट लोड करें और टूल पंजीकृत करें
  4. उपकरण लागू करें - एजेंट संचालन करने के लिए निष्पादन के दौरान उपकरणों को कॉल करता है

पूर्वावश्यकताएँ

MCP सर्वर को कॉन्फ़िगर करने से पहले, सुनिश्चित करें कि आपके पास है:

  • एजेंट 365 सीएलआई स्थापित और कॉन्फ़िगर किया गया
  • .NET 8.0 SDK या उच्चतर - डाउनलोड
  • आपके Microsoft 365 टेनेंट में ग्लोबल एडमिनिस्ट्रेटर विशेषाधिकार

एजेंट पहचान सेटअप

यदि आप एजेंटिक प्रमाणीकरण का उपयोग कर रहे हैं, तो MCP सर्वर को कॉन्फ़िगर करने से पहले अपनी एजेंट पहचान बनाने के लिए एजेंट पंजीकरण प्रक्रिया पूरी करें। यह एजेंटिक ऐप आईडी और एजेंट उपयोगकर्ता बनाता है जो आपके एजेंट को एमसीपी टूल को प्रमाणित करने और एक्सेस करने में सक्षम बनाता है।

सर्विस प्रिंसिपल सेट अप करें

अपने टेनेंट में एजेंट 365 उपकरण के लिए सेवा प्रिंसिपल बनाने के लिए इस वन-टाइम सेटअप स्क्रिप्ट चलाएँ।

महत्त्वपूर्ण

यह एक ONE-TIME कार्रवाई प्रति टेनेंट है जो वैश्विक व्यवस्थापक विशेषाधिकारों की आवश्यकता है।

  1. New-Agent365ToolsServicePrincipalProdPublic.ps1 स्क्रिप्ट डाउनलोड करें

  2. PowerShell को व्यवस्थापक के रूप में खोलें और स्क्रिप्ट निर्देशिका पर नेविगेट करें

  3. यह स्क्रिप्ट चलाएँ:

    .\New-Agent365ToolsServicePrincipalProdPublic.ps1
    
  4. संकेत मिलने पर अपने Azure क्रेडेंशियल्स के साथ साइन इन करें

पूरा होने के बाद, आपका टैनेंट एजेंट विकास और MCP सर्वर कॉन्फ़िगरेशन के लिए तैयार है।

MCP सर्वर कॉन्फ़िगर करें

अपने एजेंट के लिए MCP सर्वर खोजने, जोड़ने और प्रबंधित करने के लिए Agent 365 CLI का उपयोग करें। उपलब्ध MCP सर्वर और उनकी क्षमताओं की पूरी सूची के लिए, MCP सर्वर कैटलॉग देखें

उपलब्ध सर्वरों की खोज करें

कॉन्फ़िगर किया जा सकता है जो सभी MCP सर्वरों की सूची बनाएं:

a365 develop list-available

MCP सर्वर जोड़ें

अपने एजेंट कॉन्फ़िगरेशन में एक या अधिक MCP सर्वर जोड़ें:

a365 develop add-mcp-servers mcp_MailTools

कॉन्फ़िगर किए गए सर्वरों की सूची बनाएं

वर्तमान में कॉन्फ़िगर किए गए MCP सर्वर देखें:

a365 develop list-configured

MCP सर्वर निकालें

अपने कॉन्फ़िगरेशन से MCP सर्वर निकालें:

a365 develop remove-mcp-servers mcp_MailTools

पूर्ण सीएलआई संदर्भ के लिए, a365 डेवलप कमांड देखें

टूलींग मैनिफेस्ट को समझें

जब आप चलाते a365 develop add-mcp-serversहैं, तो CLI सभी MCP सर्वरों के लिए कॉन्फ़िगरेशन वाली फ़ाइल ToolingManifest.json जनरेट करता है। एजेंट रनटाइम इस मैनिफेस्ट का उपयोग यह समझने के लिए करता है कि कौन से सर्वर उपलब्ध हैं और उनके साथ कैसे प्रमाणित किया जाए।

प्रकट संरचना

उदाहरण: ToolingManifest.json

{
  "mcpServers": [
    {
      "mcpServerName": "mcp_MailTools",
      "mcpServerUniqueName": "mcp_MailTools",
      "scope": "McpServers.Mail.All",
      "audience": "api://05879165-0320-489e-b644-f72b33f3edf0"
    }
  ]
}

मैनिफेस्ट पैरामीटर

प्रत्येक MCP सर्वर प्रविष्टि में शामिल हैं:

पैरामीटर विवरण
mcpServerName MCP सर्वर का प्रदर्शन नाम
mcpServerUniqueName MCP सर्वर आवृत्ति के लिए अद्वितीय पहचानकर्ता
सीमाक्षेत्र OAuth क्षेत्र MCP सर्वर की क्षमताओं तक पहुँचने के लिए आवश्यक है (उदाहरण के लिए: McpServers.Mail.All मेल कार्रवाई के लिए)। जब आप आदेश चलाते add-mcp-servers हैं तो यह मान MCP सर्वर कैटलॉग से पुनर्प्राप्त किया जाता है।
भेंट Microsoft Entra ID URI जो लक्ष्य API संसाधन की पहचान करता है। यह मान भी MCP सर्वर कैटलॉग से प्राप्त किया गया है।

नोट

जब आप कोई MCP सर्वर जोड़ते हैं, तो और scope मान audience स्वचालित रूप से एजेंट 365 CLI द्वारा पॉप्युलेट होते हैं। ये मान MCP सर्वर कैटलॉग से आते हैं और प्रत्येक MCP सर्वर तक पहुँचने के लिए आवश्यक अनुमतियों को परिभाषित करते हैं।

अपने एजेंट में उपकरण एकीकृत करें

टूलींग मेनिफेस्ट जनरेट करने के बाद, कॉन्फ़िगर किए गए MCP सर्वर को अपने एजेंट कोड में एकीकृत करें। यह खंड वैकल्पिक निरीक्षण चरण और आवश्यक एकीकरण चरणों को कवर करता है।

सूची उपकरण सर्वर (वैकल्पिक)

टिप

यह सेटिंग वैकल्पिक है. टूलींग मैनिफ़ेस्ट से उपलब्ध टूल सर्वर का निरीक्षण करने के लिए टूल सर्वर कॉन्फ़िगरेशन सेवा का उपयोग करें, उन्हें अपने ऑर्केस्ट्रेटर में जोड़ने से पहले।

टूलींग मैनिफ़ेस्ट से आपके एजेंट के लिए कौन से टूल सर्वर उपलब्ध हैं, यह पता लगाने के लिए टूल सर्वर कॉन्फ़िगरेशन सेवा का उपयोग करें। यह विधि आपको इसकी अनुमति देती है:

  • क्वेरी सभी कॉन्फ़िगर किए गए MCP सर्वरों से ToolingManifest.json
  • सर्वर मेटाडेटा और क्षमताओं को पुनर्प्राप्त करें
  • पंजीकरण से पहले सर्वर की उपलब्धता की जाँच करें

उपकरण सर्वर को सूचीबद्ध करने की विधि कोर टूलींग पैकेज में उपलब्ध है:

# Use McpToolServerConfigurationService.list_tool_servers
from microsoft.agents.a365.tooling import McpToolServerConfigurationService

config_service = McpToolServerConfigurationService()
tool_servers = await config_service.list_tool_servers(agentic_app_id, auth_token)

पैरामीटर

पैरामीटर Type विवरण अपेक्षित मान आवश्यक/वैकल्पिक
agentic_app_id एसटीआर एजेंट अनुप्रयोग आवृत्ति के लिए अद्वितीय पहचानकर्ता मान्य एजेंट अनुप्रयोग ID स्ट्रिंग आवश्य
auth_token एसटीआर MCP सर्वर गेटवे के साथ प्रमाणित करने के लिए वाहक टोकन वैध OAuth बियरर टोकन आवश्य

पैकेज: microsoft-agents-a365-टूलिंग

अपने ऑर्केस्ट्रेटर के साथ टूल पंजीकृत करें

अपने ऑर्केस्ट्रेशन फ्रेमवर्क के साथ सभी MCP सर्वर को पंजीकृत करने के लिए फ्रेमवर्क-विशिष्ट एक्सटेंशन विधि का उपयोग करें:

  • AddToolServersToAgentAsync (.NET)
  • Python
  • addToolServersToAgent (Node.js)

ये तरीके:

  • अपने ऑर्केस्ट्रेटर के साथ कॉन्फ़िगर किए गए MCP सर्वर से सभी टूल पंजीकृत करें
  • प्रमाणीकरण और कनेक्शन विवरण स्वचालित रूप से सेट करें
  • अपने एजेंट को लागू करने के लिए उपकरण तुरंत उपलब्ध कराएं

अपना ऑर्केस्ट्रेटर एक्सटेंशन चुनें

एजेंट 365 टूलींग मॉड्यूल विभिन्न ऑर्केस्ट्रेशन फ्रेमवर्क के लिए समर्पित एक्सटेंशन पैकेज प्रदान करता है:

  • microsoft-agents-a365-टूलिंग: कोर टूलींग कार्यक्षमता
  • microsoft-agents-a365-tooling-extensions-agentframework: एजेंट Framework एकीकरण
  • microsoft-agents-a365-tooling-extensions-azureaifoundry: Azure AI फाउंड्री एकीकरण
  • microsoft-agents-a365-tooling-extensions-openai: OpenAI एकीकरण
  • microsoft-agents-a365-tooling-extensions-semantickernel: सिमेंटिक कर्नेल एकीकरण

नोट

प्रमाणीकरण स्वचालित रूप से एजेंट 365 CLI द्वारा कॉन्फ़िगर किया गया है जब आप चलाते a365 develop add-mcp-serversहैं। OAuth स्कोप और ऑडियंस मान MCP सर्वर कैटलॉग से पुनर्प्राप्त किए जाते हैं और इसमें शामिल किए जाते हैं ToolingManifest.json। एक्सटेंशन विधियां प्रमाणीकरण सेट करने के लिए स्वचालित रूप से इन मानों का उपयोग करती हैं - किसी मैन्युअल कॉन्फ़िगरेशन की आवश्यकता नहीं है।

विस्तृत कार्यान्वयन उदाहरणों के लिए, एजेंट 365 नमूने देखें

कार्यान्वयन उदाहरण

निम्नलिखित उदाहरण प्रदर्शित करते हैं कि एजेंट 365 टूलिंग को विभिन्न ऑर्केस्ट्रेशन फ्रेमवर्क के साथ कैसे एकीकृत किया जाए।

OpenAI के साथ पायथन

यह उदाहरण दिखाता है कि पायथन एप्लिकेशन में OpenAI के साथ MCP टूल को कैसे एकीकृत किया जाए।

आयात के विवरण जोड़ें.

टूलिंग मॉड्यूल और OpenAI एक्सटेंशन तक पहुंचने के लिए आवश्यक आयात जोड़ें:

from microsoft.agents.a365.tooling import McpToolServerConfigurationService
from microsoft.agents.a365.tooling.extensions.openai import mcp_tool_registration_service

2. टूलींग सेवाओं को आरंभ करें

कॉन्फ़िगरेशन और उपकरण पंजीकरण सेवाओं के उदाहरण बनाएं:

# Create configuration service and tool service with dependency injection
self.config_service = McpToolServerConfigurationService()
self.tool_service = mcp_tool_registration_service.McpToolRegistrationService()

3. OpenAI एजेंट के साथ MCP टूल पंजीकृत करें

अपने OpenAI एजेंट के साथ सभी कॉन्फ़िगर किए गए MCP टूल को पंजीकृत करने के लिए विधि का add_tool_servers_to_agent उपयोग करें। यह विधि दोनों agentic और nonagentic प्रमाणीकरण परिदृश्य संभालती है:

async def setup_mcp_servers(self, auth: Authorization, context: TurnContext):
    """Set up MCP server connections"""
    try:
        use_agentic_auth = os.getenv("USE_AGENTIC_AUTH", "false").lower() == "true"
        if use_agentic_auth:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
            )
        else:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
                auth_token=self.auth_options.bearer_token,
            )

    except Exception as e:
        logger.error(f"Error setting up MCP servers: {e}")

विधि पैरामीटर

निम्न तालिका के साथ उपयोग add_tool_servers_to_agentकरने के लिए पैरामीटर का वर्णन करता है।

पैरामीटर विवरण
agent उपकरण पंजीकृत करने के लिए OpenAI एजेंट इंस्टेंस।
agentic_app_id एजेंट के लिए विशिष्ट पहचानकर्ता (agentic ऐप आईडी)।
auth उपयोगकर्ता के लिए प्राधिकरण संदर्भ.
context वर्तमान वार्तालाप एजेंट SDK से संदर्भ बदल देता है। सुरक्षित उपकरण पंजीकरण के लिए उपयोगकर्ता की पहचान, वार्तालाप मेटाडेटा और प्रमाणीकरण संदर्भ प्रदान करता है।
auth_token (वैकल्पिक) गैर-एजेंट प्रमाणीकरण परिदृश्यों के लिए वाहक टोकन।

4. आरंभीकरण के दौरान कॉल करें

सुनिश्चित करें कि आप एजेंट चलाने से पहले आरंभीकरण के दौरान सेटअप विधि को कॉल करें:

# Setup MCP servers during initialization
await self.setup_mcp_servers(auth, context)

add_tool_servers_to_agent विधि स्वचालित रूप से:

  • ToolingManifest.json से सभी MCP सर्वर लोड करता है
  • OpenAI एजेंट के साथ अपने टूल रजिस्टर करता है
  • मेनिफ़ेस्ट कॉन्फ़िगरेशन के आधार पर प्रमाणीकरण सेट करता है
  • आपके एजेंट को लागू करने के लिए उपकरण उपलब्ध कराता है

पूर्ण कार्य उदाहरणों के लिए, एजेंट 365 नमूने रिपॉजिटरी देखें

परीक्षण और निगरानी करें

अपने एजेंट का परीक्षण करें

अपने एजेंट में एमसीपी टूल को एकीकृत करने के बाद, यह सुनिश्चित करने के लिए टूल इनवोकेशन का परीक्षण करें कि वे सही ढंग से काम करते हैं और विभिन्न परिदृश्यों को संभालते हैं। अपने परिवेश को सेट करने के लिए परीक्षण मार्गदर्शिका का पालन करें, फिर मुख्य रूप से परीक्षण उपकरण आमंत्रण अनुभाग पर ध्यान केंद्रित करें ताकि यह सत्यापित किया जा सके कि आपके MCP उपकरण अपेक्षा के अनुरूप काम कर रहे हैं।

अवलोकन क्षमता जोड़ें

अपने एजेंट के MCP टूल इनवोकेशन की निगरानी और पता लगाने के लिए अपने एजेंट को ऑब्जर्वेबिलिटी जोड़ें, प्रदर्शन को ट्रैक करने, समस्याओं को डीबग करने और टूल उपयोग पैटर्न को समझने के लिए अवलोकन क्षमताओं को जोड़ें। ट्रेसिंग और मॉनिटरिंग को लागू करने के बारे में अधिक जानें