AgentCore 浏览器疑难解答

本节提供您在使用 Amazon Bed AgentCore rock 浏览器时可能遇到的常见问题的解决方案。

权限被拒绝错误

症状：错误提及访问被拒绝或权限不足。

解决方案：

访问模型被拒

症状：运行代理时出现模型访问或授权错误。

解决方案：

浏览器会话超时

症状：浏览器会话意外结束或出现超时错误。

解决方案：

Amazon S3 中未显示录音

症状：会话完成后，您的 Amazon S3 存储桶中没有录制文件。

解决方案：

剧作家连接错误

症状：无法通过 Playwright 或 WebSocket 错误连接到浏览器。

解决方案：

由于验证码检查，代理无法取得进展

问题：使用浏览器工具与网站交互时，您的代理被验证码验证屏蔽。

原因：热门网站上的 Anti-bot 措施会检测到自动浏览并需要人工验证。

解决方案：构建代理以避开搜索引擎，并实现以下架构模式：

与浏览器应用程序集成时出现 CORS 错误

问题：构建调用自定义 Amazon Bed AgentCore rock 运行时服务器的基于浏览器的 Web 应用程序时，会出现 Cross-Origin 资源共享 (CORS) 错误。

原因：在本地开发或自托管部署期间，浏览器安全策略会阻止对运行时服务器的跨源请求。

解决方案：向你添加 CORS 中间件 BedrockAgentCoreApp 以处理来自前端的跨源请求：

from bedrock_agentcore.runtime import BedrockAgentCoreApp
from fastapi.middleware.cors import CORSMiddleware

app = BedrockAgentCoreApp()

# Add CORS middleware to allow browser requests
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],           # Customize in production
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

# Handle browser preflight requests to /invocations
@app.options("/invocations")
async def options_handler():
    return {"message": "OK"}

@app.entrypoint
def my_agent(payload):
    return {"response": "Hello from agent"}

会话重播和 Web Bot 身份验证在新的浏览器窗口或上下文中不起作用

问题：当您的自动化代码创建新的浏览器窗口或上下文时，会话重播和 Web Bot 身份验证功能不可用。

原因：这些功能依赖于只能在 Amazon Bedrock AgentCore 提供的默认浏览器环境中运行的浏览器扩展。当你使用像 Playwright 这样的browser.new_context()方法创建新的上下文时，扩展不可用。

解决方案：使用连接到浏览器会话时提供的默认浏览器上下文。如果您需要会话重播或 Web Bot 身份验证功能，请避免创建新的上下文或窗口。

# ✓ Use the existing default context
context = browser.contexts[0]
page = context.pages[0]

# ✗ Don't create new contexts - Session Replay and Web Bot Auth won't work
# context = browser.new_context()

浏览器扩展程序问题

扩展下载失败，访问被拒绝

症状：使用扩展程序时，会话无法启动，错误与 Amazon S3 访问有关。

解决方案：

由于格式无效，扩展名被拒绝

症状：由于扩展文件格式存在验证错误，会话无法启动。

解决方案：

浏览器配置文件问题

由于对配置文件进行并行操作，无法保存浏览器会话配置文件

症状：SaveBrowserSessionProfile投掷。ConflictException

解决方案：

由于会话并行操作，无法保存浏览器会话配置文件

症状：SaveBrowserSessionProfile投掷。ConflictException

解决方案：

加载已保存的浏览器配置文件时身份验证失败

症状：从已保存的配置文件加载的浏览器会话需要重新进行身份验证，即使该配置文件是使用有效的身份验证 Cookie 保存的。

原因：存储在浏览器配置文件中的 Cookie 已过期。网站对 Cookie（例如身份验证令牌）设置过期时间，浏览器会根据这些到期日期自动删除过期的 Cookie。加载配置文件时，自保存配置文件后已过期的任何 Cookie 都将不可用。

解决方案：

根证书颁发机构问题疑难解答

下表描述了为 Amazon Bedrock B AgentCore rowser 配置根 CA 证书时的常见错误及其解决方法。

浏览器代理疑难解答

使用代理启动会话时出错

症状：StartBrowserSession返回 HTTP 400 错误，消息以开头Failed to set up browser proxy:。

原因：代理配置或凭证密钥无效。

解决方案：

浏览器中的代理连接错误

症状：浏览器会话成功启动，但是出现了 HTTP 502 错误的代理域的页面导航失败或。net::ERR_INVALID_AUTH_CREDENTIALS

原因：浏览器无法连接到代理服务器，或者代理服务器拒绝了提供的凭据。这些是 Chromium 网络错误，而不是 AWS API 错误。

解决方案：

InvokeBrowser 操作系统操作疑难解答

下表描述了使用 InvokeBrowser API 进行 OS-level 浏览器操作时的常见错误。

解决方案：