Amazon Bedrock AgentCore отримав Session endpoints для попереднього перегляду вебзастосунків

Платформа Amazon Bedrock AgentCore отримала механізм Session endpoints для свого рантайму, який запускає кожну сесію ШІ-агента в ізольованій microVM. Нова можливість створює автентифікований URL для конкретної сесії, пересилаючи HTTP-запити та WebSocket-зʼєднання на дозволені розробником порти. Це дозволяє в реальному часі тестувати та переглядати вебрезультати роботи агентів без потреби копіювати файли й розгортати їх на зовнішніх хостингах.

Як працюють Session endpoints

Кожна активна сесія отримує індивідуальну кінцеву точку. Її робота базується на кількох технічних правилах:

• Конфігурація портів: під час виклику CreateAgentRuntime параметр allowedPorts приймає від 1 до 5 записів. Це можуть бути окремі порти або діапазони в межах 8000–12000 (за винятком зарезервованих платформою). Застосунок усередині microVM повинен слухати адресу 0.0.0.0.
• Отримання URL: адреса повертається в заголовку X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url відповіді на запит InvokeAgentRuntime (або як поле sessionEndpointUrl в SDK).
• Автентифікація: запити перевіряються через AWS IAM (із підписом SigV4 для HTTP, HTTP/2 та WebSocket) або через вхідний JWT-авторизатор із bearer-токеном. Для виклику через IAM потрібні права bedrock-agentcore:InvokeAgentRuntimeProxy.
• Маршрутизація портів: клієнт завжди підʼєднується через порт 443, а цільовий порт усередині сесії обирається за допомогою префікса до хоста (наприклад, https://8090--<session-endpoint-id>...).
• Підтримка протоколів: шлюз пропускає трафік HTTP/1.1, HTTP/2 (зокрема Server-Sent Events та gRPC) і WebSocket.
• Локальний проксі для браузера: оскільки браузер самостійно не додає підписи SigV4 чи bearer-токени до звичайних вебзапитів сторінки, клієнт bedrock-agentcore SDK відкриває локальну точку (localhost). Вона автоматично додає облікові дані перед відправленням трафіку на віддалений Session endpoint.

Архітектура та поведінка під час розробки

AWS продемонструвала роботу інструмента на прикладі кодинг-агента, який використовує модель Claude Haiku 5.5 через Amazon Bedrock. Агент слухає порт 8080 для отримання промптів, редагує файли сайту (через інструменти list, read, write, edit) і паралельно тримає запущеним dev-сервер Vite на порту 8090. Останній транслює зміни файлів у браузер через WebSocket для гарячого перезавантаження (hot-reload).

Завдяки цьому користувач бачить оновлення інтерфейсу за кілька секунд після збереження коду без ручного оновлення сторінки. Крім того, через той самий endpoint за іншим портом (наприклад, 8081) можна викликати допоміжні API-роути агента, як-от статус виконаних змін.

Обмеження та безпека

Session endpoint діє лише під час життя конкретної сесії та призначений виключно для розробки, перевірки та тестування. Для публічного продакшену AWS рекомендує переносити застосунки на сервіси штибу AWS Amplify Hosting.

У разі спроби звернутися до порту поза списком allowedPorts або без валідних облікових даних рантайм повертає помилку 403 AccessDenied. Якщо на дозволеному порту немає запущеного сервера, повертається 502 PortNotReachable, а в разі завершення сесії — 404 SessionNotFound.

Session endpoints працюють лише з обчислювальним типом microVM (тип Instances не підтримується) і доступні через публічний HTTPS. Вхідні зʼєднання через AWS PrivateLink наразі не підтримуються. Усі звернення фіксуються в AWS CloudTrail як події InvokeAgentRuntimeProxy.