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

Cette section fournit 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 :

Expiration de la session du navigateur

Symptôme : les sessions du navigateur se terminent de façon 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 contrôles 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 appliquées sur les sites Web populaires détectent la navigation automatique et nécessitent une vérification humaine.

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

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

Problème : Cross-Origin des erreurs de partage de ressources (CORS) 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 demandes d'origine croisée adressées à votre serveur d'exécution lors du développement local ou du déploiement auto-hébergé.

Solution : ajoutez un intergiciel CORS à votre interface BedrockAgentCoreApp pour gérer les demandes provenant de plusieurs origines :

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

La réexécution de session et l'authentification par robot Web ne fonctionnent pas dans les nouvelles fenêtres ou les nouveaux contextes du navigateur

Problème : les fonctionnalités de réexécution de session et d'authentification par robot Web 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 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 avec des 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 du 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 expirés depuis l'enregistrement du profil 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 leurs résolutions 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 : Le secret de configuration ou d'identification du proxy n'est pas valide.

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 contenant 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 :

Dépannage des InvokeBrowser actions du système

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

Solution :