नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
Agent 365 CLI परीक्षण और विकास उद्देश्यों के लिए एक mock tooling server उपलब्ध है. यह सर्वर MCP (मॉडल संदर्भ प्रोटोकॉल) सर्वर इंटरैक्शन का सिमुलेशन करता है, जिससे आप अपने एजेंट की टूलिंग क्षमताओं को स्थानीय रूप से बिना वास्तविक सर्वर इम्प्लीमेंटेशन के टेस्ट कर सकते हैं. यह किसी अन्य Agent 365 कार्यक्षमताओं को कवर नहीं करता है.
मॉक सर्वर का उपयोग करने के लाभ
मॉक सर्वर स्थानीय विकास और परीक्षण के लिए निम्नलिखित लाभ प्रदान करता है:
- ऑफ़लाइन विकास: इंटरनेट कनेक्टिविटी या बाहरी निर्भरता के बिना अपने एजेंट का परीक्षण करें.
- लगातार परीक्षण: एज मामलों के परीक्षण के लिए पूर्वानुमानित प्रतिक्रियाएँ प्राप्त करें.
- डिबगिंग: वास्तविक समय में सभी अनुरोध और प्रत्युत्तर देखें
- तेज़ पुनरावृत्ति: बाहरी एपीआई कॉल की प्रतीक्षा करने या जटिल परीक्षण वातावरण स्थापित करने की आवश्यकता नहीं है.
आवश्यकताएँ
मॉक टूलिंग सर्वर का उपयोग करने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित पूर्वापेक्षाएँ हैं:
-
Agent 365 CLI इंस्टॉल किया गया - CLI के साथ मॉक टूलिंग सर्वर का उपयोग करें. इंस्टॉलेशन निर्देशों के लिए Agent 365 CLI देखें.
- मॉक टूलिंग सर्वर का उपयोग करने के लिए आपके पास कम से कम संस्करण 1.1.25-पूर्वावलोकन होना चाहिए.
- नमूना एजेंट प्रोजेक्ट - एक स्थानीय एजेंट प्रोजेक्ट जो MCP सर्वर से कनेक्ट कर सकता है. हमारे Agent365-नमूना रेपो में उपलब्ध शुरुआती बिंदु देखें.
मॉक टूलिंग सर्वर प्रारंभ करें
a365 develop start-mock-tooling-server कमांड का उपयोग करके मॉक टूलिंग सर्वर शुरू करें.
# Full command
a365 develop start-mock-tooling-server
# Short alias
a365 develop mts
कमांड के विकल्प
मॉक टूलिंग सर्वर निम्न विकल्पों का समर्थन करता है:
| विकल्प | विवरण | डिफ़ॉल्ट |
|---|---|---|
-p, --port <port> |
मॉक सर्वर के लिए पोर्ट नंबर | 5309 |
-v, --verbose |
वर्बोज़ लॉगिंग सक्षम करें | गलत |
-?, -h, --help |
मदद और उपयोग की जानकारी दिखाएं | - |
-bg |
सर्वर को नए टर्मिनल पर चलाएँ | - |
उदाहरण
निम्न उदाहरण मॉक टूलिंग सर्वर को शुरू करने के सामान्य तरीके दिखाते हैं:
डिफ़ॉल्ट सेटिंग्स से प्रारंभ करें:
a365 develop start-mock-tooling-server
कस्टम पोर्ट पर प्रारंभ करें:
a365 develop start-mock-tooling-server -p 8080
वर्बोज़ लॉगिंग से शुरू करें:
a365 develop start-mock-tooling-server -v
जब आप कमांड चलाते हैं, तो यह:
- निर्दिष्ट पोर्ट (डिफ़ॉल्ट: localhost:5309) पर मॉक सर्वर प्रारंभ करता है.
- टर्मिनल में सर्वर लॉग और इनकमिंग अनुरोध प्रदर्शित करता है.
नमूना एजेंटों के साथ मॉक सर्वर का उपयोग करें
अपने सैंपल एजेंट को मॉक टूलिंग सर्वर से कनेक्ट करने के लिए:
चरण 1: मॉक सर्वर प्रारंभ करें
a365 develop start-mock-tooling-server
सर्वर प्रारंभ होता है और निम्न उदाहरण के समान आउटपुट प्रदर्शित करता है:
info: Microsoft.Hosting.Lifetime[14]
Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
Application started. Press Ctrl+C to shut down.
चरण 2: अपने एजेंट को कॉन्फ़िगर करें
अपने नमूना एजेंट में MCP_PLATFORM_ENDPOINT नाम का परिवेश वेरिएबल मॉक सर्वर को लक्षित करने के लिए सेट करें:
MCP_PLATFORM_ENDPOINT=http://localhost:5309
यदि आप कस्टम पोर्ट का उपयोग करते हैं, तो 5309 को अपने चुने हुए पोर्ट नंबर से बदलें.
चरण 3: अपना एजेंट चलाएँ
अपने नमूना एजेंट को शुरू करें जैसा कि आप सामान्य रूप से करते हैं. एजेंट अब वास्तविक MCP सर्वर के बजाय मॉक सर्वर से कनेक्ट करता है.
चरण 4: सर्वर गतिविधि की निगरानी करें
मॉक सर्वर टर्मिनल प्रदर्शित करता है:
- आपके एजेंट से आने वाले अनुरोध
- मॉक प्रत्युत्तर वापस भेजे जा रहे हैं
- कनेक्शन की स्थिति और त्रुटियां (यदि कोई हो)
उदाहरण सर्वर लॉग:
info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms
मॉक सर्वर को रोकना
मॉक सर्वर को बंद करने के लिए, उस टर्मिनल में Ctrl+C दबाएँ जिसमें सर्वर चल रहा है, या टर्मिनल विंडो को बंद करें.
समस्या निवारण
इस अनुभाग में मॉक टूलींग सर्वर की सामान्य समस्याओं का निवारण करने की जानकारी है.
टिप
Agent 365 समस्या निवारण मार्गदर्शिका में उच्च-स्तरीय समस्या निवारण अनुशंसाएँ, सर्वोत्तम प्रथाएँ, और Agent 365 विकास जीवनचक्र के प्रत्येक भाग के लिए समस्या निवारण सामग्री के लिंक शामिल हैं.
मॉक सर्वर प्रारंभ नहीं होता
लक्षण:Error: Address already in use
कारण: कोई अन्य प्रक्रिया पहले से ही डिफ़ॉल्ट पोर्ट (5309) या आपके निर्दिष्ट पोर्ट का उपयोग कर रही है.
समाधान:
किसी दूसरे पोर्ट का उपयोग करें.
a365 develop start-mock-tooling-server -p 8080या पोर्ट का उपयोग करने वाली प्रक्रिया को समाप्त करें और दुबारा कोशिश करें.
एजेंट मॉक सर्वर से कनेक्ट नहीं कर सकता
लक्षण: एजेंट के लॉग में कनेक्शन त्रुटियाँ या टाइमआउट दिखते हैं जब मॉक सर्वर तक पहुँचने का प्रयास किया जाता है.
कारण:
- मॉक सर्वर नहीं चल रहा है.
- गलत
MCP_PLATFORM_ENDPOINTपरिवेश वेरिएबल. - फ़ायरवॉल या नेटवर्क कॉन्फ़िगरेशन संबंधी समस्याएँ.
समाधान:
- सत्यापित करें कि मॉक सर्वर चल रहा है और दिखाता है "अब सुन रहा है: http://localhost:5309".
- देखें कि
MCP_PLATFORM_ENDPOINTपरिवेश वेरिएबल सर्वर पते से मैच होता हो. - सुनिश्चित करें कि कोई फ़ायरवॉल निर्दिष्ट पोर्ट पर कनेक्शन को अवरुद्ध नहीं करता है.