Agent Space Preview 默认不暴露端口，需通过 CLI 配置端口映射（如本地3000→容器8080），配置后空间会重启，须确保容器监听0.0.0.0:8080，并通过get-agent-space验证映射及浏览器访问localhost:3000确认生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在使用 Amazon DevOps Agent 的 Troubleshoot 功能时，Agent Space Preview 默认不暴露任何端口，必须手动配置才能让本地开发环境访问正在预览的代理运行实例。
确认 Agent Space 已创建并处于运行状态
进入 AWS 控制台 → Amazon DevOps Agent → Agent Spaces 页面，找到目标空间，确认其 Status 显示为 Running。若为 Creating 或 Failed，请先等待或排查初始化日志。
Preview 端口配置仅对已成功启动的 Agent Space 生效，未就绪状态下修改端口不会生效，且可能被后续重建覆盖。
通过 CLI 为 Agent Space 添加 Preview 端口映射
执行以下命令，将本地 3000 端口转发至 Agent Space 内部服务的 8080 端口：
aws devops-agent update-agent-space --agent-space-id <your-space-id> --preview-port-mappings '[{"localPort":3000,"containerPort":8080}]'
注意：该操作会触发 Agent Space 重启，期间已有连接将中断。请确保容器内服务监听的是 0.0.0.0:8080 而非 127.0.0.1:8080，否则外部请求无法到达。
验证端口是否生效
第一步：运行 aws devops-agent get-agent-space --agent-space-id <your-space-id>，检查返回 JSON 中 previewPortMappings 字段是否包含你设置的映射项。
第二步：待空间状态再次变为 Running 后，在本地浏览器访问 http://localhost:3000。若返回服务响应（如 HTTP 200 + 正常页面），说明端口已通；若超时或拒绝连接，请检查容器日志中是否有绑定失败提示。
这一步操作起来很简单，直接把文件拖进去就行。
