Session endpoints ב-AgentCore Runtime: תצוגה מקדימה חיה של אפליקציית הווב שסוכן קוד בונה, ומגבלות הגישה ש-AWS מתעדת
הפוסט של AWS מ-30 באוקטובר מראה איך Session endpoints נותנים לכל סשן של AgentCore runtime כתובת URL מאומתת לפורטים שאתם מאפשרים, כך שאפשר לצפות באפליקציית Vite של סוכן קוד מתעדכנת חי. מה הוא אומר על פורטים, אימות, סירובים ומגבלות, ומה הייתי בודק.
AWS פרסמה את "Preview web apps live as your coding agent builds them with Amazon Bedrock AgentCore runtime" ב-30 באוקטובר. הפיצ'ר הוא Session endpoints: כל סשן של AgentCore runtime מקבל כתובת URL מאומתת שמעבירה תנועת HTTP ו-WebSocket לפורטים שאתם מפרטים מראש. הפוסט משתמש בזה כדי להראות סוכן קוד שעורך אתר Vite בזמן שאתם צופים בעמוד משתנה.
קראתי את הפוסט ואת ה-README של תיקיית הדוגמה במאגר awslabs/agentcore-samples. לא פרסתי שום דבר, אז ההתנהגות למטה היא מה ש-AWS מתעדת, לא מה שצפיתי. לא קראתי את עמוד התיעוד המקושר של Session endpoint.
מהו Session endpoint
לפי הפוסט, AgentCore runtime מריץ כל סשן סוכן ב-microVM מבודד משלו. Session endpoint הוא כתובת URL מאומתת לסשן אחד שמעבירה את ה-method, הנתיב, מחרוזת השאילתה והגוף של כל בקשה, וחיבורי WebSocket, לפורטים שאתם מאפשרים. שישה פרטים מהפוסט:
- אתם בוחרים את הפורטים. מגדירים
allowedPortsב-CreateAgentRuntime: 1 עד 5 ערכים, כל אחד פורט בודד או טווח בתוך 8000 עד 12000, לא כולל פורטים שמורים של הפלטפורמה. לאפשר פורט לא מפעיל שרת. האפליקציה שלכם חייבת להאזין עליו, קשורה ל-0.0.0.0. - ה-URL מגיע עם הסשן. InvokeAgentRuntime מחזיר אותו בכותרת
X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url. - כל בקשה מאומתת. עם IAM, כל בקשת HTTP, זרם HTTP/2 ולחיצת יד של WebSocket נושאת חתימת SigV4, והקורא צריך
bedrock-agentcore:InvokeAgentRuntimeProxyעל ה-runtime וה-endpoint שלו. עם JWT authorizer, כל בקשה נושאת bearer token. "Knowing the URL doesn't grant access." - שם ה-host בוחר את הפורט. הלקוח מתחבר על 443, וקידומת כמו
8090--על ה-host בוחרת את הפורט בתוך הסשן. - הוא נושא HTTP/1.1, HTTP/2 (כולל server-sent events ו-gRPC) ו-WebSocket.
- הוא מוגבל לסשן אחד. הוא מחזיק רק כל עוד הסשן. AWS אומרת להשתמש בו לבנות, לבדוק ולסקור, ולפרוס לשירות אירוח כמו AWS Amplify Hosting כדי לשרת משתמשים.
הוא שונה מ-runtime endpoint כמו DEFAULT, ששולט לאיזו גרסת סוכן קוראים מגיעים. Session endpoint נותן לכם לראות מה הסוכן מריץ בתוך הסשן שלו, עובד עם כל גרסה שהסשן מריץ, ונעצר כשהסשן מסתיים.
הדוגמה
סוכן קוד רץ על פורט 8080 עם ארבעה כלי קבצים (list, read, write, edit) וקורא ל-Claude Haiku 5.5 ב-Amazon Bedrock. הוא מפעיל שרת פיתוח של Vite על פורט 8090. על המכונה שלכם, PreviewApp מגיש עמוד צ'אט ופותח endpoint מקומי. דפדפן לא יכול להוסיף חתימות SigV4 לבקשות שעמוד עושה, אז לקוח ה-Session endpoint של ה-SDK פותח endpoint מקומי על localhost שחותם כל בקשה ולחיצת יד של WebSocket.
פורט 8080 לא נמצא ב-allowedPorts, כי InvokeAgentRuntime מגיע לסוכן בלי ה-Session endpoint. הפורטים המאופשרים הם 8090 (האתר) ו-8081 (נתיב /status שמפרט כל פרומפט והקבצים שהוא שינה). הפרומפט לדוגמה בפוסט מבקש ערכת צבעים כהה, והאתר מתעדכן דרך ה-WebSocket של hot-reload של Vite בלי רענון.
דרישות שמופיעות: bedrock-agentcore 1.25.2 ומעלה, boto3 1.43.122 ומעלה, Python 3.10+, Node.js 22+, וגישה ל-Claude Haiku 5.5. הסוכן נפרס כ-zip ב-S3 עם direct code deployment ל-Node.js, אז לא צריך Docker או מאגר ECR.
בדקתי ב-PyPI באותו יום: ה-latest של bedrock-agentcore היה 1.25.2, שתואם את המינימום שהפוסט מזכיר.
מה ה-runtime מסרב
הפוסט אומר שסירובים חוזרים עם סטטוס HTTP, גוף ריק וקוד שגיאה בכותרת תגובה, כך שאפשר להבדיל אותם משגיאות האפליקציה שלכם:
| בקשה | תגובה |
|---|---|
פורט שלא ב-allowedPorts | 403 AccessDenied |
| אין credentials תקפים | 403 AccessDenied או 401 AuthenticationRequired |
| פורט מאופשר, שום דבר לא מאזין | 502 PortNotReachable |
| הסשן כבר לא קיים | 404 SessionNotFound |
איך הגישה מוגנת, ואיפה היא נעצרת
לפי הפוסט:
- ה-runtime מסיר את כותרות האימות שלו לפני ההעברה, כך שהאתר לא מקבל את החתימה שלכם.
- בקשות נרשמות ב-CloudTrail כאירועי
InvokeAgentRuntimeProxy. - ה-endpoint המקומי פועל עם ה-credentials שלכם. הוא מאזין רק על 127.0.0.1, עונה רק לבקשות שמופנות לכתובת המקומית שלו, ומסרב לחיבורי WebSocket מעמודים מ-origins אחרים. AWS אומרת להריץ אותו רק בזמן שאתם משתמשים בתצוגה המקדימה.
- "The access controls don't separate the website from the agent." שניהם רצים באותו סשן, אז תנו לתפקיד ההרצה רק את ההרשאות שהסוכן צריך.
- אם ה-runtime מחליף את משאב החישוב של הסשן, חיבורים פתוחים נסגרים ועריכות הסוכן עלולות לא לשרוד בלי אחסון מתמשך.
- כלי הקבצים של הסוכן פותרים נתיבים בתוך תיקיית האתר ומסרבים לנתיבים מחוץ לה. AWS מציעה Bedrock Guardrails אם אחרים יכולים לשלוח פרומפטים, וסקירת שינויים לפני פרסום.
- Session endpoints עובדים עם runtimes מסוג microVM, לא סוג החישוב Instances. ה-URLs נגישים דרך HTTPS ציבורי, ו-PrivateLink לא נתמך לחיבורים נכנסים.
אי-התאמה קטנה שמצאתי
הפוסט אומר שהדוגמה המלאה נמצאת בתיקיית "14-remote-access" של מאגר agentcore-samples. ב-31 באוקטובר הנתיב ההוא החזיר לי 404. פקודת ה-clone של הפוסט עצמו, והמאגר, משתמשים ב-01-features/02-host-your-agent/01-runtime/03-advanced/16-session-endpoints, שנטען ומכיל את ה-notebook, deploy.py, preview_app.py, cleanup.py ותיקיות הסוכן והאתר. לתיקיית 03-advanced של המאגר אין ערך 14-remote-access; פריט 14 שם הוא 14-byo-warm-pool. אז השתמשו בנתיב 16-session-endpoints. זה נראה כמו שם מיושן בפרוזה, אבל אני לא יודע את הסיבה.
מה הייתי בודק
אלה הצעות שלא בדקתי.
1. לפרוס את הדוגמה בחשבון זמני ולקרוא את deploy.py קודם. הוא יוצר runtime, מעלה ל-S3 ויוצר תפקיד IAM.
2. לאשר את הסירובים בעצמכם. לבקש פורט מחוץ ל-allowedPorts וקריאה בלי credentials, ולהשוות לטבלה.
3. לשמור allowedPorts מינימלי. כל פורט שאתם מוסיפים הוא שטח נוסף שנגיש עם אותם credentials.
4. להגביל את תפקיד ההרצה הדוק. הפוסט אומר שהסוכן והאתר חולקים סשן.
5. לבדוק CloudTrail לאירועי InvokeAgentRuntimeProxy אחרי בדיקה, כדי שתדעו מה סשן סקירה משאיר אחריו.
6. להחליט איפה המשכיות חיה אם אתם צריכים שעריכות ישרדו את הסשן.
7. להריץ את תאי הניקוי. הפוסט אומר למחוק את ה-runtime, הקוד שהועלה והתפקיד כדי להימנע מחיובים שוטפים.
מה לא הייתי מסיק
- ש-Session endpoint בטוח לתת לאנשים אחרים. הפוסט אומר שבקרות הגישה לא מפרידות בין האתר לסוכן, והוא מתאר את ה-credentials כשלכם.
- שזו דרך לארח אפליקציה. AWS אומרת שהוא לבנייה, בדיקה וסקירה.
- שהדוגמה מתנהגת כפי שמוצג. לא הרצתי אותה.
- שהפרוזה של הפוסט והמאגר מסכימים בכל מקום. שם תיקייה אחד לא.
שאלות נפוצות
מה זה Session endpoints?
לפי AWS, כתובת URL מאומתת לכל סשן של AgentCore runtime שמעבירה תנועת HTTP ו-WebSocket לפורטים שאתם מאפשרים.
כמה פורטים אפשר לאפשר?
אחד עד חמישה ערכים ב-allowedPorts, כל אחד פורט בודד או טווח בתוך 8000 עד 12000, לפי הפוסט.
איך הוא מאומת?
SigV4 ל-runtimes עם IAM, או bearer token ל-runtime עם JWT authorizer, על כל בקשה.
האם אפשר להשתמש בו כדי לשרת את האפליקציה למשתמשים?
AWS אומרת שלא: לפרוס לשירות אירוח כמו AWS Amplify Hosting.
האם הוא עובד דרך PrivateLink?
הפוסט אומר ש-PrivateLink לא נתמך לחיבורים נכנסים.
אילו סוגי חישוב הוא תומך?
Runtimes מסוג microVM, לא סוג החישוב Instances, לפי הפוסט.
איפה קוד הדוגמה?
בתיקיית 16-session-endpoints של awslabs/agentcore-samples. הפוסט מזכיר תיקייה אחרת, שהחזירה 404 כשבדקתי.
מקורות
כולם נקראו ב-31 באוקטובר 2026.
- Preview web apps live as your coding agent builds them with Amazon Bedrock AgentCore runtime (AWS Machine Learning Blog, 30 באוקטובר 2026)
- 16-session-endpoints sample (awslabs/agentcore-samples)
- bedrock-agentcore on PyPI
לא נקראו: תיעוד ה-Session endpoint המקושר, ה-notebook וקבצי המקור, ופלט CloudTrail כלשהו.
קריאה נוספת
- AgentCore ו-S3 Files: מה AWS אומרת על מערכות קבצים משותפות לסוכני חקירת מסמכים
הפוסט של AWS מ-27 באוקטובר משלב סוכן AgentCore runtime עם פונקציית Lambda על mount משותף של S3 Files. מה הוא טוען, שלוש חוקי העקביות, ובקרות ה-prompt injection שהוא מפרט, עם רשימת הבדיקה שלי.
- Qwen4-Max: דגם הדגל של Alibaba עם 2.4T פרמטרים מבטיח ירידה של 62% בעלות למשימה מול הדור הקודם
צוות Qwen של Alibaba שחרר את Qwen4-Max, הדגם הראשון במשפחת Qwen4: מודל MoE דליל עם 2.4 טריליון פרמטרים, 71B פעילים לטוקן, חלון קונטקסט של מיליון טוקנים, מצבי חשיבה עם רמות מאמץ מתכווננות, וגישה דרך endpoints תואמי OpenAI ו-Anthropic. לפי מספרי היצרן, עד 49% פחות טוקנים במשימות קידוד סוכנתי וירידה של 62% בעלות הממוצעת למשימה מול Qwen3.8-Max. מחיר הקלט מתחיל ב-1.5 דולר למיליון טוקנים.
- LongCat-2.5: Meituan משחררת מודל סוכנים של 1.6T פרמטרים ברישיון MIT, מאומן ומוגש בלי Nvidia
צוות LongCat של Meituan שחרר את המשקלים של LongCat-2.5: מודל mixture-of-experts עם 1.6 טריליון פרמטרים, כ-48B פעילים לטוקן, הבנת תמונה מלידה, קונטקסט של 512K טוקנים ורישיון MIT. האימון והפריסה הרפרנסית רצים כולם על מאיצים סיניים מקומיים, עם quantization של W4A4 INT4 שלטענת הצוות משמר דיוק קרוב למלוא הדיוק. בבנצ'מרקים של היצרן הוא קרוב ל-Claude Opus 5 בקידוד סוכנתי, ומתחתיו במשימות terminal. אירוח עצמי דורש אשכול רציני.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS