Risoluzione dei problemi relativi AgentCore al browser

Questa sezione fornisce soluzioni ai problemi più comuni che potresti riscontrare durante l'utilizzo del AgentCore browser Amazon Bedrock.

Errori di autorizzazione negata

Sintomo: errori che indicano l'accesso negato o le autorizzazioni insufficienti.

Soluzione::

Accesso al modello negato

Sintomo: errori relativi all'accesso o all'autorizzazione del modello durante l'esecuzione degli agenti.

Soluzione::

Timeout della sessione del browser

Sintomo: le sessioni del browser terminano in modo imprevisto o si verificano errori di timeout.

Soluzione::

La registrazione non viene visualizzata in Amazon S3

Sintomo: nessun file di registrazione nel bucket Amazon S3 al termine della sessione.

Soluzione::

Errori di connessione Playwright

Sintomo: impossibile connettersi al browser con Playwright o errori. WebSocket

Soluzione::

L'agente non può fare progressi a causa dei controlli CAPTCHA

Problema: l'agente viene bloccato dalla verifica CAPTCHA quando utilizza lo strumento Browser per interagire con i siti Web.

Causa: Anti-bot le misure sui siti web più diffusi rilevano la navigazione automatica e richiedono la verifica umana.

Soluzione: struttura il tuo agente in modo da evitare i motori di ricerca e implementa il seguente modello di architettura:

Errori CORS durante l'integrazione con le applicazioni browser

Problema: gli errori di condivisione Cross-Origin delle risorse (CORS) si verificano durante la creazione di applicazioni Web basate su browser che chiamano un server di runtime Amazon AgentCore Bedrock personalizzato.

Causa: le politiche di sicurezza del browser bloccano le richieste provenienti da più origini al server di runtime durante lo sviluppo locale o la distribuzione con hosting autonomo.

Soluzione: aggiungi il middleware CORS al tuo per gestire le richieste multiorigine dal tuo BedrockAgentCoreApp frontend:

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"}

Session Replay e Web Bot Auth non funzionano in nuove finestre o contesti del browser

Problema: le funzionalità Session Replay e Web Bot Auth non sono disponibili quando il codice di automazione crea nuove finestre o contesti del browser.

Causa: queste funzionalità si basano su estensioni del browser che funzionano solo nel contesto del browser predefinito fornito da Amazon Bedrock AgentCore. Quando crei un nuovo contesto utilizzando metodi come browser.new_context() in Playwright, le estensioni non sono disponibili.

Soluzione: utilizzate il contesto del browser predefinito fornito quando vi connettete alla sessione del browser. Evita di creare nuovi contesti o finestre se hai bisogno della funzionalità Session Replay o 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()

Problemi con le estensioni del browser

Il download dell'estensione non riesce e l'accesso è negato

Sintomo: la sessione non si avvia con errori relativi all'accesso ad Amazon S3 quando si utilizzano le estensioni.

Soluzione::

Estensione rifiutata a causa di un formato non valido

Sintomo: la sessione non si avvia con errori di convalida sul formato del file di estensione.

Soluzione::

Problemi relativi al profilo del browser

Impossibile salvare il profilo della sessione del browser a causa di un'operazione simultanea sul profilo

Sintomo: SaveBrowserSessionProfile ConflictException lanci.

Soluzione::

Impossibile salvare il profilo della sessione del browser a causa di un'operazione simultanea sulla sessione

Sintomo: SaveBrowserSessionProfile ConflictException lanci.

Soluzione::

L'autenticazione fallisce durante il caricamento di un profilo del browser salvato

Sintomo: una sessione del browser caricata da un profilo salvato richiede una nuova autenticazione anche se il profilo è stato salvato con cookie di autenticazione validi.

Causa: i cookie memorizzati nel profilo del browser sono scaduti. I siti Web impostano i tempi di scadenza dei cookie (come i token di autenticazione) e il browser rimuove automaticamente i cookie scaduti in base a tali date di scadenza. Quando si carica un profilo, i cookie scaduti da quando il profilo è stato salvato non saranno disponibili.

Soluzione::

Risoluzione dei problemi relativi all'Autorità di certificazione principale

La tabella seguente descrive gli errori comuni e le relative risoluzioni durante la configurazione dei certificati CA root per Amazon AgentCore Bedrock Browser.

Risoluzione dei problemi relativi ai proxy del browser

Errori all'avvio di una sessione con proxy

Sintomo: StartBrowserSession restituisce un errore HTTP 400 con un messaggio che inizia conFailed to set up browser proxy:.

Causa: la configurazione del proxy o il segreto delle credenziali non sono validi.

Soluzione::

Errori di connessione al proxy nel browser

Sintomo: una sessione del browser viene avviata correttamente, ma la navigazione delle pagine non riesce per i domini proxy con errori HTTP 502 o. net::ERR_INVALID_AUTH_CREDENTIALS

Causa: il browser non riesce a connettersi al server proxy oppure il server proxy rifiuta le credenziali fornite. Si tratta di errori di rete Chromium, non di errori API. AWS

Soluzione::

Risoluzione dei problemi relativi al InvokeBrowser sistema operativo

La tabella seguente descrive gli errori più comuni che si verificano quando si utilizza l' InvokeBrowser API per le azioni OS-level del browser.

Soluzione::