AgentCore 瀏覽器故障診斷

本節提供使用 Amazon Bedrock AgentCore 瀏覽器時可能遇到的常見問題的解決方案。

拒絕許可錯誤

徵狀：提及存取遭拒或許可不足的錯誤。

解決方案：

拒絕模型存取

徵狀：執行代理程式時模型存取或授權的錯誤。

解決方案：

瀏覽器工作階段逾時

徵狀：瀏覽器工作階段意外結束或發生逾時錯誤。

解決方案：

Amazon S3 中未顯示錄製

徵狀：工作階段完成後，Amazon S3 儲存貯體中不會記錄檔案。

解決方案：

Playwright 連線錯誤

徵狀：無法使用 Playwright 或 WebSocket 錯誤連線到瀏覽器。

解決方案：

由於 CAPTCHA 檢查，客服人員無法進行進度

問題：使用瀏覽器工具與網站互動時，CAPTCHA 驗證會封鎖您的代理程式。

原因：熱門網站上的反機器人措施會偵測自動瀏覽，且需要人工驗證。

解決方案：建構您的代理程式以避免搜尋引擎並實作下列架構模式：

與瀏覽器應用程式整合時發生 CORS 錯誤

問題：建立瀏覽器型 Web 應用程式來呼叫自訂 Amazon Bedrock AgentCore 執行時間伺服器時，會發生跨來源資源共用 (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 Auth 無法在新的瀏覽器視窗或內容中運作

問題：當您的自動化程式碼建立新的瀏覽器視窗或內容時，工作階段重播和 Web Bot Auth 功能無法使用。

原因：這些功能依賴僅在 Amazon Bedrock AgentCore 提供的預設瀏覽器內容中運作的瀏覽器延伸模組。當您使用 Playwright browser.new_context()中的 等方法建立新的內容時，擴充功能無法使用。

解決方案：使用您連線至瀏覽器工作階段時提供的預設瀏覽器內容。如果您需要工作階段重播或 Web Bot Auth 功能，請避免建立新的內容或視窗。

# ✓ 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 AgentCore 瀏覽器的根 CA 憑證時的常見錯誤及其解決方法。

瀏覽器代理程式故障診斷

使用代理啟動工作階段時發生錯誤

徵狀： StartBrowserSession傳回 HTTP 400 錯誤，其中包含開頭為 的訊息Failed to set up browser proxy:。

原因：代理組態或登入資料秘密無效。

解決方案：

瀏覽器中的 Proxy 連線錯誤

徵狀：瀏覽器工作階段已成功啟動，但出現 HTTP 502 錯誤或 的代理網域的頁面導覽失敗net::ERR_INVALID_AUTH_CREDENTIALS。

原因：瀏覽器無法連線至代理伺服器，或代理伺服器拒絕提供的登入資料。這些是 Chromium 網路錯誤，而不是 AWS API 錯誤。

解決方案：

對 InvokeBrowser 作業系統動作進行故障診斷

下表說明針對作業系統層級瀏覽器動作使用 InvokeBrowser API 時的常見錯誤。

解決方案：