AgentCore 브라우저 문제 해결

이 섹션에서는 Amazon Bedrock AgentCore 브라우저를 사용할 때 발생할 수 있는 일반적인 문제에 대한 솔루션을 제공합니다.

권한 거부 오류

증상: 액세스 거부 또는 권한 부족을 언급하는 오류.

해결 방법:

모델 액세스 거부됨

증상: 에이전트를 실행할 때 모델 액세스 또는 권한 부여에 대한 오류입니다.

해결 방법:

브라우저 세션 제한 시간

증상: 브라우저 세션이 예기치 않게 종료되거나 제한 시간 오류가 발생합니다.

해결 방법:

Amazon S3에 레코딩이 표시되지 않음

증상: 세션이 완료된 후 Amazon S3 버킷에 레코딩 파일이 없습니다.

해결 방법:

Playwright 연결 오류

증상: Playwright 또는 WebSocket 오류가 있는 브라우저에 연결할 수 없습니다.

해결 방법:

CAPTCHA 검사로 인해 에이전트가 진행할 수 없음

문제: 브라우저 도구를 사용하여 웹 사이트와 상호 작용할 때 CAPTCHA 확인으로 에이전트가 차단됩니다.

원인: 인기 있는 웹 사이트의 봇 방지 조치가 자동 브라우징을 감지하고 사람의 확인이 필요합니다.

해결 방법: 검색 엔진을 피하고 다음 아키텍처 패턴을 구현하도록 에이전트를 구성합니다.

브라우저 애플리케이션과 통합 시 CORS 오류

문제: 사용자 지정 Amazon Bedrock AgentCore 런타임 서버를 호출하는 브라우저 기반 웹 애플리케이션을 빌드할 때 CORS(Cross-Origin Resource Sharing) 오류가 발생합니다.

원인: 브라우저 보안 정책은 로컬 개발 또는 자체 호스팅 배포 중에 런타임 서버에 대한 교차 오리진 요청을 차단합니다.

솔루션: BedrockAgentCoreApp에 CORS 미들웨어를 추가하여 프런트엔드의 교차 오리진 요청을 처리합니다.

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

세션 재생 및 웹 봇 인증이 새 브라우저 창 또는 컨텍스트에서 작동하지 않음

문제: 자동화 코드가 새 브라우저 창 또는 컨텍스트를 생성할 때는 세션 재생 및 웹 봇 인증 기능을 사용할 수 없습니다.

원인: 이러한 기능은 Amazon Bedrock AgentCore에서 제공하는 기본 브라우저 컨텍스트에서만 작동하는 브라우저 확장을 사용합니다. Playwrightbrowser.new_context()의와 같은 메서드를 사용하여 새 컨텍스트를 생성하면 확장을 사용할 수 없습니다.

해결 방법: 브라우저 세션에 연결할 때 제공되는 기본 브라우저 컨텍스트를 사용합니다. 세션 재생 또는 웹 봇 인증 기능이 필요한 경우 새 컨텍스트 또는 창을 생성하지 마세요.

# ✓ 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.

해결 방법:

저장된 브라우저 프로필을 로드할 때 인증 실패

증상: 저장된 프로필에서 로드된 브라우저 세션은 프로필이 유효한 인증 쿠키와 함께 저장되었더라도 재인증이 필요합니다.

원인: 브라우저 프로필에 저장된 쿠키가 만료되었습니다. 웹 사이트는 쿠키(예: 인증 토큰)에 만료 시간을 설정하고 브라우저는 이러한 만료 날짜에 따라 만료된 쿠키를 자동으로 제거합니다. 프로필을 로드하면 프로필이 저장된 이후 만료된 쿠키는 사용할 수 없습니다.

해결 방법:

루트 인증 기관 문제 해결

다음 표에서는 Amazon Bedrock AgentCore Browser에 대한 루트 CA 인증서를 구성할 때 발생하는 일반적인 오류와 해결 방법을 설명합니다.

브라우저 프록시 문제 해결

프록시로 세션을 시작할 때 발생하는 오류

증상: 로 시작하는 메시지와 함께 HTTP 400 오류를 StartBrowserSession 반환합니다Failed to set up browser proxy:.

원인: 프록시 구성 또는 보안 인증 암호가 잘못되었습니다.

해결 방법:

브라우저의 프록시 연결 오류

증상: 브라우저 세션이 성공적으로 시작되지만 HTTP 502 오류 또는가 있는 프록시 도메인의 경우 페이지 탐색이 실패합니다net::ERR_INVALID_AUTH_CREDENTIALS.

원인: 브라우저가 프록시 서버에 연결할 수 없거나 프록시 서버가 제공된 자격 증명을 거부합니다. 이는 AWS API 오류가 아닌 Chromium 네트워크 오류입니다.

해결 방법:

InvokeBrowser OS 작업 문제 해결

다음 표에서는 OS 수준 브라우저 작업에 InvokeBrowser API를 사용할 때 발생하는 일반적인 오류를 설명합니다.

해결 방법: