Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Résoudre les problèmes liés au navigateur AgentCore

Cette section propose des solutions aux problèmes courants que vous pouvez rencontrer lors de l'utilisation du AgentCore navigateur Amazon Bedrock.

Erreurs de type « Autorisation refusée »

Symptôme : erreurs mentionnant un accès refusé ou des autorisations insuffisantes.

Solution :

Accès au modèle refusé

Symptôme : erreurs relatives à l'accès au modèle ou à l'autorisation lors de l'exécution d'agents.

Solution :

Délai d'expiration de la session du navigateur

Symptôme : les sessions du navigateur se terminent de manière inattendue ou des erreurs de temporisation se produisent.

Solution :

L'enregistrement n'apparaît pas dans Amazon S3

Symptôme : aucun fichier d'enregistrement dans votre compartiment Amazon S3 une fois la session terminée.

Solution :

Erreurs de connexion du dramaturge

Symptôme : Impossible de se connecter au navigateur avec Playwright ou WebSocket des erreurs.

Solution :

L'agent ne peut pas progresser en raison des vérifications CAPTCHA

Problème : Votre agent est bloqué par la vérification CAPTCHA lorsqu'il utilise l'outil Navigateur pour interagir avec des sites Web.

Cause : Anti-bot les mesures prises sur les sites Web les plus populaires détectent la navigation automatique et nécessitent une vérification humaine.

Solution : structurez votre agent de manière à éviter les moteurs de recherche et implémentez le modèle d'architecture suivant :

Erreurs CORS lors de l'intégration aux applications de navigateur

Problème : Cross-Origin des erreurs CORS (Resource Sharing) se produisent lors de la création d'applications Web basées sur un navigateur qui appellent un serveur d'exécution Amazon AgentCore Bedrock personnalisé.

Cause : les politiques de sécurité du navigateur bloquent les requêtes d'origine croisée adressées à votre serveur d'exécution pendant le développement local ou le déploiement auto-hébergé.

Solution : ajoutez le middleware CORS à votre interface pour gérer les requêtes BedrockAgentCoreApp d'origine croisée depuis votre interface :

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 et Web Bot Auth ne fonctionnent pas dans de nouvelles fenêtres ou de nouveaux contextes de navigateur

Problème : les fonctionnalités Session Replay et Web Bot Auth ne sont pas disponibles lorsque votre code d'automatisation crée de nouvelles fenêtres ou de nouveaux contextes de navigateur.

Cause : Ces fonctionnalités reposent sur des extensions de navigateur qui ne fonctionnent que dans le contexte de navigateur par défaut fourni par Amazon Bedrock AgentCore. Lorsque vous créez un nouveau contexte à l'aide de méthodes comme browser.new_context() dans Playwright, les extensions ne sont pas disponibles.

Solution : utilisez le contexte de navigateur par défaut fourni lorsque vous vous connectez à la session du navigateur. Évitez de créer de nouveaux contextes ou de nouvelles fenêtres si vous avez besoin de la fonctionnalité Session Replay ou 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()

Problèmes liés aux extensions de navigateur

Le téléchargement de l'extension échoue et l'accès est refusé

Symptôme : la session ne démarre pas en raison d'erreurs liées à l'accès à Amazon S3 lors de l'utilisation d'extensions.

Solution :

Extension rejetée en raison d'un format non valide

Symptôme : la session ne démarre pas avec des erreurs de validation concernant le format de fichier d'extension.

Solution :

Problèmes liés au profil du navigateur

Impossible d'enregistrer le profil de session du navigateur en raison d'une opération simultanée sur le profil

Symptôme : SaveBrowserSessionProfile lancersConflictException.

Solution :

Impossible d'enregistrer le profil de session du navigateur en raison d'une opération simultanée sur la session

Symptôme : SaveBrowserSessionProfile lancersConflictException.

Solution :

L'authentification échoue lors du chargement d'un profil de navigateur enregistré

Symptôme : une session de navigateur chargée à partir d'un profil enregistré nécessite une nouvelle authentification même si le profil a été enregistré avec des cookies d'authentification valides.

Cause : Les cookies enregistrés dans le profil du navigateur ont expiré. Les sites Web fixent des délais d'expiration pour les cookies (tels que les jetons d'authentification), et le navigateur supprime automatiquement les cookies expirés en fonction de ces dates d'expiration. Lorsque vous chargez un profil, les cookies qui ont expiré depuis que le profil a été enregistré ne seront pas disponibles.

Solution :

Résolution des problèmes liés à l'autorité de certification racine

Le tableau suivant décrit les erreurs courantes et leur résolution lors de la configuration des certificats CA racine pour le AgentCore navigateur Amazon Bedrock.

Résolution des problèmes liés aux proxys de navigateur

Erreurs lors du démarrage d'une session avec un proxy

Symptôme : StartBrowserSession renvoie une erreur HTTP 400 avec un message commençant parFailed to set up browser proxy:.

Cause : La configuration du proxy ou le secret des informations d'identification ne sont pas valides.

Solution :

Erreurs de connexion au proxy dans le navigateur

Symptôme : une session de navigateur démarre correctement, mais la navigation dans les pages échoue pour les domaines proxy présentant des erreurs HTTP 502 ou. net::ERR_INVALID_AUTH_CREDENTIALS

Cause : Le navigateur ne peut pas se connecter au serveur proxy ou le serveur proxy rejette les informations d'identification fournies. Il s'agit d'erreurs réseau Chromium, et non AWS d'erreurs d'API.

Solution :

Résolution des problèmes liés InvokeBrowser aux actions du

Le tableau suivant décrit les erreurs courantes lors de l'utilisation de l' InvokeBrowser API pour les actions OS-level du navigateur.

Solution :