क्विकस्टार्ट: जावास्क्रिप्ट लैंगचेन नमूना एजेंट सेट अप करें और चलाएं

इस क्विकस्टार्ट में, एजेंट 365 टूलिंग, सूचनाएं, अवलोकन क्षमता का उपयोग करके एक कार्यशील जावास्क्रिप्ट लैंगचेन एजेंट स्थापित करें और एजेंट प्लेग्राउंड और टीम्स का उपयोग करके एजेंट का परीक्षण करें।

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

• यदि आप Visual Studio कोड का उपयोग करने की योजना बनाते हैं, तो आपको .NET स्थापित होना आवश्यक है। (.NET 8.0 की अनुशंसा की जाती है।
• Node.js संस्करण 10.x या उच्चतर स्थापित करें।
• लैंगचेन
• एजेंट खेल का मैदान
• Npm (नोड पैकेज मैनेजर) तक पहुंच NodeJS के साथ स्थापित है
• GitHub तक पहुंच
• एक मौजूदा एआई एजेंट प्रोजेक्ट। यह त्वरित प्रारंभ Microsoft 365 एजेंट टूलकिट से एक एजेंट 365 नमूना एजेंट का उपयोग करता है जिसे VS कोड में ATK के रूप में भी जाना जाता है।
• ए365 सीएलआई
• एजेंट पहचान प्रमाणीकरण

Microsoft 365 एजेंट टूलकिट से LangChain + Node.js नमूना सेट करें

सब कुछ तैयार करने के लिए, आप वीएस कोड में Microsoft 365 एजेंट टूलकिट स्थापित करते हैं, नमूना गैलरी खोलते हैं, और लैंगचेन + Node.js नमूने को स्थानीय रूप से मचान बनाते हैं ताकि आप इसे बाद में कॉन्फ़िगर और चला सकें। निम्नलिखित स्क्रीनशॉट दिखाते हैं कि आपको आगे बढ़ते हुए क्या देखने की उम्मीद करनी चाहिए।

1. Visual Studio कोड खोलें, उसके बाद एक्सटेंशन पैनल Ctrl+Shift+X खोलें।

2. खोज बार में, "एजेंट टूलकिट" टाइप करें।
   आपको यहां स्क्रीनशॉट में दिखाया गया परिणाम देखना चाहिए:

   

3. Microsoft 365 एजेंट टूलकिट का चयन करें।

4. स्थापित करें का चयन करें.

   वीएस कोड एक्सटेंशन विवरण दृश्य दिखाता है:

   

5. एक बार इंस्टॉल हो जाने पर, M365 एजेंट टूलकिट आइकन बाएं नेविगेशन बार में दिखाई देता है।

6. स्वागत अनुभव खोलने के लिए इसे चुनें।

   अब आपको एक घोषणात्मक एजेंट बनाओ, एक नया एजेंट/ऐप बनाएं और नमूने देखें, जैसे विकल्प दिखाई देने चाहिए, जैसा कि यहां दिखाया गया है:

   

7. नमूने देखें का चयन करें.

8. नमूने सूची में, LangChain + Node.js एजेंट नमूना ढूँढने के लिए स्क्रॉल करें।

9. इसे चुनें।

   आपको दो विकल्प दिखाई देंगे: बनाएं (स्थानीय रूप से मचान) या GitHub पर देखें।

10. बनाएं चुनें.

11. संकेत मिलने पर, अपनी मशीन पर एक फ़ोल्डर चुनें जहां नमूना उत्पन्न किया जाना चाहिए। उदाहरण के लिए: C:\A365-Ignite-Demo

    टूलकिट LangChain + Node.js नमूने को एक सबफ़ोल्डर (जैसे sample_agent) में मचान बनाता है और फिर इसे वीएस कोड में स्वचालित रूप से खोलता है।

    एक बार मचान पूरा हो जाने के बाद, अब आपके पास अपनी मशीन पर पूरी तरह कार्यात्मक LangChain + Node.js एजेंट प्रोजेक्ट है

आवश्यक एजेंट 365 पैकेज स्थापित करें

नमूना चलाने से पहले, अपने प्रोजेक्ट में package.json खोलें और पुष्टि करें कि सभी आवश्यक एजेंट 365 और एजेंट फ्रेमवर्क निर्भरताएं सूचीबद्ध हैं। Microsoft 365 एजेंट टूलकिट द्वारा जनरेट किए गए नमूने में पहले से ही ये प्रविष्टियाँ शामिल हैं।

एक बार जब आप समीक्षा package.jsonकर लेते हैं, तो चलाकर सब कुछ स्थापित करें:

npm install

यह सभी एजेंट 365 लायब्रेरी, एजेंट फ्रेमवर्क निर्भरताओं, होस्टिंग घटकों और नमूने में परिभाषित किसी भी अन्य निर्भरता को नीचे खींचता है। स्थापना के बाद, प्रोजेक्ट बनाता है और देव सर्वर प्रारंभ करके चलता है सत्यापित करें

npm run dev

Microsoft 365 उपकरण (MCP सर्वर) जोड़ें

आप CLI में a365 डेवलप कमांड का उपयोग करके MCP सर्वर का अन्वेषण और प्रबंधन कर सकते हैं।

एमसीपी सर्वर के साथ काम करते समय, आप यह कर सकते हैं:

• पता लगाएं कि कौन से MCP सर्वर उपयोग के लिए उपलब्ध हैं
• अपने एजेंट के कॉन्फ़िगरेशन में एक या अधिक MCP सर्वर जोड़ें
• वर्तमान में कॉन्फ़िगर किए गए MCP सर्वर की समीक्षा करें
• MCP सर्वर निकालें जिनकी अब आपको आवश्यकता नहीं है

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

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

टूल जोड़ने और प्रबंधित करने का तरीका जानें

अधिसूचना सदस्यता और हैंडलिंग

नमूना एजेंट सभी एजेंट 365 सूचनाओं का उपयोग करके onAgentNotification("*") सदस्यता लेता है और उन्हें एक ही हैंडलर को रूट करता है। यह हैंडलर एजेंट को पृष्ठभूमि या सिस्टम घटनाओं पर प्रतिक्रिया करने की अनुमति देता है, न कि केवल प्रत्यक्ष उपयोगकर्ता संदेशों पर।

एजेंटों को सूचित करने का तरीका जानें

निम्न कोड दिखाता है कि फ़ाइल में agent.ts अधिसूचना कैसे कॉन्फ़िगर की गई है।

constructor() {
   super();

   this.onAgentNotification("agents:*", async(context, state, activity) => {

      await this.handleAgentNotificationActivity(context, state, activity);

   });
}

async handleAgentNotificationActivity(context, state, activity)
{
   await context.sendActivity("Received an AgentNotification!");

   // Add custom handling here
}

अवलोकन क्षमता

यह स्निपेट नमूने में अवलोकन को सक्षम करने के लिए आवश्यक न्यूनतम परिवर्तनों को दर्शाता है। यह एजेंट 365 ऑब्जर्वेबिलिटी एसडीके को इनिशियलाइज़ करता है और प्रत्येक एजेंट इनवोकेशन को एक में InferenceScope लपेटता है ताकि इनपुट, आउटपुट और मेटाडेटा को स्वचालित रूप से कैप्चर किया जा सके।

निम्न कोड फ़ाइल में client.ts एक सुव्यवस्थित अवलोकन उदाहरण दिखाता है।

const sdk = ObservabilityManager.configure(b =>
   b.withService('<service-name>', '<version>')
);

sdk.start();

async invokeAgentWithScope(prompt: string) {

   const scope = InferenceScope.start(
      { 
         operationName: InferenceOperationType.CHAT, 
         model: '<llm-name>' 
      },
      { 
         agentId: '<agent-id>', 
         agentName: '<agent-name>', 
         conversationId: '<conv-id>' 
      },
      { tenantId: '<tenant-id>' }
   );

   const response = await this.invokeAgent(prompt);
   scope?.recordInputMessages([prompt]);
   scope?.recordOutputMessages([response]);
   scope?.recordResponseId(`resp-${Date.now()}`);
   return response;

}

यह स्निपेट Node.js + लैंगचेन नमूने में अवलोकन को सक्षम करने के लिए मुख्य पैटर्न दिखाता है। संपूर्ण अवलोकन सेटअप के लिए, अवलोकन क्षमता के बारे में अधिक जानें देखें

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

आवश्यक परिवेश चर सेट करें, एक प्रमाणीकरण मोड का चयन करें, और एजेंट को स्थानीय रूप से प्रारंभ करें। आप Microsoft 365 टेनेंट की आवश्यकता के बिना Agents Playground के साथ एंड-टू-एंड सब कुछ परीक्षण कर सकते हैं, जब तक कि आप एजेंट को प्रकाशित नहीं करना चाहते हैं और इसे Teams या Outlook जैसे ऐप्स में उपयोग नहीं करना चाहते हैं। कृपया विस्तृत चरणों के लिए देखें एजेंटों के खेल के मैदान के साथ एजेंट के परीक्षण को कॉन्फ़िगर करने के लिए परीक्षण के बारे में अधिक जानें।

परीक्षण चरणों का अवलोकन

• किसी फ़ाइल .env में अपनी API कुंजियाँ और मॉडल सेटिंग जोड़ें ताकि नमूना किसी LLM से बात कर सके.
• अपना प्रमाणीकरण मोड चुनें. स्थानीय विकास के लिए, नमूना आपके एजेंट ब्लूप्रिंट से बनाए गए मानों का उपयोग करके Agentic Auth का समर्थन करता है।
• एजेंट को स्थानीय रूप से शुरू करें, जो इसे एजेंट प्लेग्राउंड जैसे टूल के सामने उजागर करता है।
• संदेशों, उपकरणों और सूचनाओं का परीक्षण करने के लिए एजेंट प्लेग्राउंड का उपयोग करें, बिना किसी टैनेंट को सेट किए या कुछ भी परिनियोजित किए।
• जब आप वास्तविक दुनिया के व्यवहार के लिए तैयार हों, तो Microsoft 365 टेनेंट प्रकाशित करें और Teams, Outlook या अन्य Microsoft 365 सतहों के अंदर एजेंट का परीक्षण करें।

अपना एजेंट प्रकाशित करें.

जब आपका एजेंट वास्तविक Microsoft 365 अनुभवों जैसे Teams चैट, Outlook संदेश, Word @mentionsके लिए तैयार होता है, तो आप इसे Microsoft 365 टेनेंट पर प्रकाशित करते हैं. एजेंट 365 सीएलआई publish कमांड पैकेजिंग को संभालता है: यह आपके मैनिफेस्ट को अपडेट करता है, सब कुछ बंडल करता है, और एजेंट को माइक्रोसॉफ्ट एडमिन सेंटर पर अपलोड करता है।

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

आप प्रकाशित एजेंटों को यहां देख सकते हैं: https://admin.cloud.microsoft/#/agents/all

पूर्ण वर्कफ़्लो और चरण-दर-चरण निर्देशों के बारे में अधिक जानें