वेब अनुप्रयोगों का पूर्वावलोकन करने के लिए Amazon Bedrock AgentCore रनटाइम का उपयोग करें क्योंकि आपका कोडिंग एजेंट उन्हें बनाता है।

Amazon Bedrock AgentCore के साथ कोडिंग एजेंट बनाने वाले डेवलपर्स के लिए, सत्र एंडपॉइंट्स एक एजेंट के चल रहे वेब पूर्वावलोकन को ब्राउज़र-एक्सेसिबल लाइव वर्कस्पेस में बदल देते हैं। नमूना एक अलग सत्र के अंदर पोर्ट 8090 पर चलने वाली Vite वेबसाइट रखता है, उपयोगकर्ता को चैट फलक से संकेत भेजने देता है, और पूर्ण तैनाती चरण के बिना एजेंट फ़ाइलों को संपादित करते समय प्रीव्यू को अपडेट करता है।

पूर्वावलोकन लूप क्यों मायने रखता है

कोडिंग एजेंट अब डैशबोर्ड, उत्पाद पृष्ठों और प्रोटोटाइप जैसे काम करने वाले वेब ऐप बनाते हैं। सबसे तेज़ समीक्षा पथ एप्लिकेशन खोलना, इसका उपयोग करना, परिवर्तन के लिए पूछना और परिणाम की जांच करना है। यह लूप तब काम करता है जब ऐप चल रहा होता है जहां एजेंट इसे संपादित करता है, इसलिए सेकंड के भीतर ब्राउज़र में बदलाव दिखाई देते हैं। यदि ऐप को कॉपी किया जाना चाहिए और कहीं और तैनात किया जाना है, तो प्रत्येक परिवर्तन परिनियोजन और समीक्षा धीमा हो जाती है।

AgentCore एक एजेंट फ्रेमवर्क और फाउंडेशन मॉडल का उपयोग करके स्केल पर एजेंटों को बनाने, कनेक्ट करने और अनुकूलित करने के लिए एक मंच है। एजेन्टकोर रनटाइम, Amazon Bedrock AgentCore की क्षमता, प्रत्येक एजेंट सत्र को अपने अलग-थलग माइक्रोवीएम में चलाता है। सत्र एंडपॉइंट्स हर सत्र को एक प्रमाणित यूआरएल देते हैं जो प्रत्येक अनुरोध की एचटीटीपी विधि, पथ, क्वेरी स्ट्रिंग और बॉडी और वेबसॉकेट कनेक्शन को अनुमत बंदरगाहों तक अग्रेषित करता है। एक समीक्षक पेज अपडेट देख सकता है क्योंकि एजेंट प्रत्येक फ़ाइल को सहेजता है.

सत्र अंतबिंदु चल रहे अनुप्रयोग तक कैसे पहुँचते हैं

प्रत्येक सत्र को अपना स्वयं का सत्र अंतबिंदु मिलता है, और छह विवरण यह निर्धारित करते हैं कि इसका उपयोग कैसे किया जाता हैः

• पोर्ट विकल्प: अनुमतपोर्ट्स CreateAgentRuntime में सेट किया गया है और इसमें 1 से 5 प्रविष्टियां हो सकती हैं, प्रत्येक एक एकल बंदरगाह या आरक्षित प्लेटफ़ॉर्म पोर्ट को छोड़कर 8000 से 12000 के भीतर की सीमा। किसी पोर्ट की अनुमति देने से सर्वर शुरू नहीं होता; एप्लिकेशन को उस पर सुनना चाहिए, जो कि 0.0 तक बाध्य है।
• यूआरएल डिलीवरी: InvokeAgentRuntime प्रतिक्रिया एक्स-एम्ज़ेन-बेड्रॉक-एजेंटकोर-रनटाइम-सत्र-अंत बिंदु-यूआरएल हेडर में अंतबिंदु को ले जाती है, जो संगत सॉफ़्टवेयर डेवलपमेंट किट सत्रEndpointUrl के रूप में प्रकट करते हैं।
• प्रमाणीकरण: हर अनुरोध को प्रमाणित किया जाता है। AWS Identity और Access Management रनटाइम के लिए, प्रत्येक HTTP अनुरोध, HTTP / 2 स्ट्रीम, और वेबसॉकेट हैंडशेक एक Signature Version 4 हस्ताक्षर करता है, और कॉलर की आवश्यकता होती है bedrock-agentcore:InvokeAgentRuntimeProxy रनिंग टाइम पर और इसके रनिंग समय एंडपॉइंट में। इनबाउंड JSON Web Token प्राधिकरणों के लिए , अनुरोध धारक टोकन ले जाते हैं। यूआरएल जानने से एक्सेस प्रदान नहीं होता है।
• पोर्ट चयनः क्लाइंट पोर्ट 443 पर कनेक्ट होते हैं, और एक होस्ट-नाम उपसर्ग सत्र बंदरगाह का चयन करता है। 8090 उपसर्ग index.html तक पहुँच सकता है, जबकि 8081 उपसर्ग /status तक पहुंच सकता है।
• प्रोटोकॉल समर्थन: HTTP/1.1 और HTTP/2 अनुरोध, सर्वर-भेजी गई घटनाओं और gRPC सहित, और WebSocket कनेक्शन के माध्यम से गुजरते हैं। नमूना का उपयोग करता है http/1.1 तथा वेबसॉकेट.
• सत्र का दायरा: यूआरएल को प्रत्येक अनुरोध पर क्रेडेंशियल्स की आवश्यकता होती है और यह केवल सत्र के रूप में लंबे समय तक रहता है। इसका मतलब एजेंट आउटपुट बनाने, परीक्षण करने और समीक्षा करना है। उपयोगकर्ताओं की सेवा के लिए, ऐप को होस्टिंग सेवा जैसे कि AWS Amplify Hosting पर तैनात करें।

एक ब्राउज़र अपने आप में पेज अनुरोधों के लिए Signature Version 4 हस्ताक्षर या धारक टोकन नहीं जोड़ सकता है, इसलिए बेसिक-एजेंटकोर सॉफ़्टवेयर डेवलपमेंट किट में सत्र एंडपॉइंट क्लाइंट डेवलपर की मशीन पर एक स्थानीय एंडप्वाइंट खोल सकता है। ब्राउज़र खुलता है http://localhost:8088, और स्थानीय एंडपोइन्ट आगे भेजने से पहले क्रेडेंशियल्स जोड़ता है अनुरोध और वेबसॉकेट हैंडशेक्स.

सत्र समाप्ति बिंदु एक रनटाइम अंतबिंदु से भिन्न होता है, जैसे कि डिफ़ॉल्ट. एक रन टाइम एंडपॉइंट एजेंट तक पहुँचता है और यह नियंत्रित करता है कि कौन सा संस्करण कॉलर्स पहुंचेंगे; InvokeAgentRuntime कॉल इसके माध्यम से हल करते हैं, जिससे विकास और उत्पादन संस्करणों को बढ़ावा दिया जा सकता है या वापस रोल किया जाता है बिना कॉलर बदलते हुए। एक सत्र अंतबिन्दु दिखाता है कि एजेंट अपने सत्र में क्या चलाता है, केवल अनुमत बंदरगाहों तक पहुंचता है , जो भी संस्करण के साथ काम करता है वह सत्र चलता है, और सत्र समाप्त होने पर काम करना बंद कर देता है।

पूर्वावलोकन को कैसे तैनात और समीक्षा करें

नमूने में चार भाग होते हैं। एक कोडिंग एजेंट पोर्ट पर सत्र में चलता है 8080 और चार उपकरणों के साथ वेबसाइट फ़ाइलों को संपादित करता हैः सूची, पढ़ें, लिखें और संपादित करें. एजेंट बंदरगाह 8090 पर एक Vite विकास सर्वर शुरू करता है, जो वेबसाइट की सेवा करता है और अपने गर्म-पुनः लोड वेबसॉकेट पर ब्राउज़र को प्रत्येक सहेजे गए परिवर्तन को धक्का देता है। PreviewApp पूर्वावलोकन पृष्ठ की सेवा करती है, InvokeAgentRuntime को संकेत भेजती है, और वेबसाइट के लिए एक स्थानीय एंडपॉइंट खोलती है। पहले दृश्य चरण से पहले, प्रीव्यूएप्प ने पहले ही सत्र शुरू करने के लिए InvogeAgent RUNTIME को बुलाया है, Session endpoint URL पढ़ता है, and open a local endpoint for port 8090.

एक परिवर्तन अनुरोध के लिए, साइट फलक localhost से वेबसाइट को लोड करता हैः8088। स्थानीय एंडपॉइंट प्रत्येक अनुरोध और WebSocket हैंडशेक में क्रेडेंशियल्स जोड़ता है और उन्हें सत्र अंतबिंदु पर अग्रेषित करता है। सत्र अंत बिंदु अनुमत पोर्टों के खिलाफ हस्ताक्षर और बंदरगाह की जांच करता है, फिर पोर्ट को अनुरोध अग्रेषण करता है 8090 । पृष्ठ Vite हॉट-रिलोड वेबसॉक को खुला रखता है।

समीक्षाकर्ता चैट फलक से एक संकेत भेजता है। पूर्वावलोकन ऐप इसे मानक AWS API कॉल के रूप में InvokeAgentRuntime को AWS क्रेडेंशियल्स के साथ हस्ताक्षरित करता है, और रनटाइम इसे पोर्ट पर एजेंट को वितरित करता है Amazon Bedrock AgentCore Session । एजेंट के कदम वापस चैट पैनल तक जाते हैं। एजेंट क्या बदलना है यह तय करने के लिए Amazon Bedrock 5.5 में Amazon Bedrock कहता है, साइट की फ़ाइलों को पढ़ता है और उन लोगों को बचाता है जिन्हें वह बदल देता है। वाइट डेवलपमेंट सर्वर उन फाइलों को देखता है। जब कोई फ़ाइल सहेजी जाती है, तो Vite वेबसॉकेट पर परिवर्तन को धक्का देता है, सत्र एंडपॉइंट और स्थानीय अंत बिंदु के माध्यम से, और साइट फ़ील्ड अपडेट किए बिना ताज़ा हो जाता है।

नोटबुक से, पूर्वावलोकन ऐप उसी सत्र अंत बिंदु के माध्यम से पोर्ट 8081 पर एजेंट का / स्थिति मार्ग भी पढ़ सकता है। केवल बंदरगाह बदलता है। पोर्ट 8080 में अनुमति नहीं दी गई हैPorts, क्योंकि InvokeAgentRuntime बिना Session endpoint के एजेंट तक पहुंचता है, और एंडपॉइंट उस पोर्ट को अस्वीकार करता है.

वॉकथ्रू का पालन करने के लिए, एक उपयोगकर्ता को उस क्षेत्र में AWS खाते की आवश्यकता होती है जहां एजेन्टकोर रनटाइम सत्र एंडपॉइंट्स उपलब्ध हैं, जिसमें क्रेडेंशियल्स कॉन्फ़िगर किए गए हैं। आवश्यक अनुमतियों में AWS Identity और Access Management भूमिका बनाना, Amazon Simple Storage Service पर अपलोड करना, रनिंग टाइम बनाना और बेसिक-एजेंटकोरः InvokeAgentRuntime और बेसक्वेक एजेंटकोअर: इनवोकेएजंटरनटाइमप्रोक्सी का उपयोग करना और उसके डीईएफएएलटी रनिंग समय अंत बिंदु शामिल हैं। पर्यावरण को पायथन 3.10 या बाद में, बेसिक एजेंटकोर 1.25.2 या बाद, बोटो 3 1.43 .122 या इसके बाद, गिट, जूपीटर लैब जैसे जुपिटेयर वातावरण या Visual Studio Code जूपिटर एक्सटेंशन के साथ, एनपीएम तक पहुंच Claude Haiku Amazon Bedrock में Node.js 22 या बाद के साथ ।

नमूना नोड.जेएस के लिए प्रत्यक्ष कोड परिनियोजन के साथ Amazon S3 में एक ज़िप फ़ाइल के रूप में एजेंट को तैनात करता है, इसलिए डॉकर या Amazon Elastic Container Registry रिपॉजिटरी की आवश्यकता नहीं होती है। सत्र एंडपॉइंट्स माइक्रोवीएम रनटाइम के साथ काम करते हैं, न कि इंस्टेंस कंप्यूटिंग प्रकार के साथ। सत्र अंत बिंदु यूआरएल सार्वजनिक एचटीटीपीएस के माध्यम से पहुँचा जा सकता है, और इनबाउंड कनेक्शन के लिए समर्थित नहीं है।

तैनाती स्क्रिप्ट एजेंट को एक फ़ाइल में बंडल करता है, वेबसाइट और इसकी निर्भरताएं आरएम 64 सिस्टम पर रनटाइम के लिनक्स के लिए जोड़ती हैं, ज़िप को Amazon S3 अपलोड करती हैं, और रन टाइम बनाती हैं। deploy.py में, agentRuntimeArtifact रन टाइम NODE_22 और entryPoint app.js सेट करता है। प्रोटोकॉल कॉन्फ़िगरेशन सर्वरप्रोटोकॉल HTTP, पोर्ट 8080 और पथ /invocations। अनुमत पोर्ट्स सूची 8090 वेबसाइट के लिए और 8081 स्थिति मार्ग के लिए। Vite विन्यास बंदरगाह पर 0.0 सुनता है 8090 और server.allowedHosts सही छोड़ देता है, क्योंकि अनुरोध स्थानीय होस्ट के बजाय रन-समय से जुड़े नाम के तहत आते हैं। सत्र एंडपॉइंट प्रत्येक अनुरोध को प्रमाणित करता है इससे पहले कि यह सर्वर तक पहुंच जाए, इसलिए सर्वर को अपने स्वयं के मेजबान की जांच करने की आवश्यकता नहीं होती है।

1. क्लोन https://github.com/awslabs/agentcore-samples.git और एजेंटकोर-सैंपल/01-विशेषताओं/02-मेजबान-आपका-एजेंट/01-रनटाइम/03-उन्नत/16-सत्र-अंत बिंदुओं में परिवर्तन।
2. session_endpoints_preview.ipynb खोलें
3. पायथन निर्भरताओं को स्थापित करने के लिए स्थापना कक्ष चलाएँ.
4. %run deploy.py कक्ष चलाएँ. तैनाती में कुछ मिनट लगते हैं, ज्यादातर रनटाइम के लिए READY स्थिति तक पहुंचने की प्रतीक्षा करते हुए।

रनटाइम तैयार होने के साथ, PreviewApp को प्रारंभ करें। एक कॉल सत्र शुरू करता है, पोर्ट 8090 से local_port 8088 तक स्थानीय एंडपॉइंट खोलता है और लोकलहोस्ट पर पूर्वावलोकन पृष्ठ प्रस्तुत करता हैः8087 खुला http://localhost:8087 । पेज दाईं ओर वेबसाइट दिखाता है, सत्र में बंदरगाह 8090 से सेवा दी जाती है, और बाईं ओर सुझाए गए अनुरोधों के साथ एक छोटा गाइड। एजेंट को साइट को गहरे रंग की थीम पर स्विच करने के लिए कहें, जैसे ही वे स्ट्रीम करते हैं उसके चरणों का पालन करें, और बिना रिफ्रेश के वेबसाइट परिवर्तन देखें।

सामान्य त्रुटियाँ और क्या परिवर्तन

सबसे आम सेटअप त्रुटि सर्वर प्रबंधक के रूप में allowedPorts का इलाज कर रही है। अनुमति देना 8090 या 8081 एक सर्वर शुरू नहीं करता है; Vite विकास सर्वर को बंदरगाह पर 0.0 सुनना चाहिए। Amazon Bedrock AgentCore Session 1.1 एक और गलती यह मानती है कि एक ज्ञात URL पहुंच प्रदान करती है। एंडपॉइंट हर अनुरोध पर क्रेडेंशियल्स की जांच करता है, इसलिए ब्राउज़र को स्थानीय एंडप्वाइंट हेल्पर की आवश्यकता होती है, न कि सीधी पहुँच सत्र अंत बिंदु यूआरएल तक.

एक तीसरी गलती एंडपॉइंट प्रकारों को भ्रमित करना है। InvokeAgentRuntime सत्र अंतबिंदु के बिना पोर्ट 8080 पर एजेंट तक पहुंचना चाहिए। सत्र अंत बिंदु यह देखने के लिए है कि सत्र क्या चलाता है, न कि कॉल करने वालों द्वारा किस एजेंट संस्करण का उपयोग किया जाता है। वह भूमिका रनटाइम अंत बिन्दु से संबंधित है, जैसे DEFAULT.

टीमों के लिए, व्यावहारिक प्रभाव यह है कि समीक्षा तैनाती की प्रतीक्षा करने से सत्र सक्रिय होने पर एक प्रामाणिक लाइव पूर्वावलोकन देखने के लिए स्थानांतरित हो जाती है। जब काम उपयोगकर्ताओं के लिए तैयार होता है, तो इसे अभी भी होस्टिंग सेवा में तैनात किया जाना चाहिए जैसे AWS Amplify Hosting । नोटबुक सहित पूरा नमूना एजेंटकोर-नमूने GitHub रिपो के 14-रिमोट एक्सेस फ़ोल्डर में है।

Meta Description: Amazon Bedrock AgentCore Session एंडपॉइंट्स डेवलपर्स को प्रत्येक परिवर्तन को तैनात किए बिना पोर्ट 8090 पर लाइव एक कोडिंग एजेंट के Vite ऐप का पूर्वावलोकन करने की अनुमति देते हैं।
टैगः अमेज़ॅन बेड्रॉक एजेंटकोर, सत्र एंडपॉइंट्स, कोडिंग एजेंट, Vite, पोर्ट 8090
विशेष रुप से प्रदर्शित छवि: पोर्ट पर एक लाइव वेब एप्लिकेशन का पूर्वावलोकन करने वाले सुरक्षित एजेंट सत्र के अमूर्त अनुकूल चित्रण 8090, बिना लोगों, लोगो या पाठ के।