기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 문제 해결 및 Q&A
<a name="emr-spark-upgrade-agent-troubleshooting"></a>

## 문제 해결
<a name="spark-upgrade-agent-troubleshooting-common"></a>

업그레이드 프로세스의 오류 메시지는 다양한 MCP 클라이언트에 대해 다양한 방식으로 사용할 수 있습니다. 이 페이지에서는 Amazon EMR용 Apache Spark 업그레이드 에이전트를 사용할 때 발생할 수 있는 일반적인 문제에 대한 몇 가지 일반적인 지침을 나열합니다.

**Topics**
+ [오류: SMUS 관리형 MCP 서버를 로드하지 못함](#spark-upgrade-agent-mcp-server-failed)
+ [관찰 : 느린 도구 로드](#spark-upgrade-agent-slow-tool-loading)
+ [오류: 도구 호출 실패 및 조절 오류](#spark-upgrade-agent-throttling-error)
+ [오류: 도구가 사용자 오류로 응답](#spark-upgrade-agent-user-error)
+ [오류: 도구가 내부 오류로 응답](#spark-upgrade-agent-internal-error)

### 오류: SMUS 관리형 MCP 서버를 로드하지 못함
<a name="spark-upgrade-agent-mcp-server-failed"></a>
+  MCP 구성이 올바르게 구성되었는지 확인합니다.
+ **JSON 구문 검증**:
  + 구문 오류 없이 JSON이 유효한지 확인
  + 누락된 쉼표, 따옴표 또는 대괄호 확인
+ 로컬 AWS 자격 증명을 확인하고 MCP IAM 역할에 대한 정책이 올바르게 구성되었는지 확인합니다.
+ /mcp를 실행하여 `Kiro-CLI` 사례에 대한 MCP 서버 가용성 확인

### 관찰 : 느린 도구 로드
<a name="spark-upgrade-agent-slow-tool-loading"></a>
+ 서버를 처음 시작할 때 도구를 로드하는 데 몇 초 정도 걸릴 수 있습니다.
+ 도구가 표시되지 않으면 채팅을 다시 시작해 보십시오.
+ `/tools` 명령을 실행하여 도구 가용성을 확인합니다.
+ 서버가 오류 없이 시작`/mcp`되면를 실행합니다.

### 오류: 도구 호출 실패 및 조절 오류
<a name="spark-upgrade-agent-throttling-error"></a>

서비스 한도에 도달한 경우 제한 예외가 표시되면 몇 초 정도 기다렸다가 도구 호출을 실행하십시오.

### 오류: 도구가 사용자 오류로 응답
<a name="spark-upgrade-agent-user-error"></a>
+ AccessDeniedException - 오류 메시지를 확인하고 권한 문제를 수정합니다.
+ InvalidInputException - 오류 메시지를 확인하고 도구 입력 파라미터를 수정합니다.
+ ResourceNotFoundException - 오류 메시지를 확인하고 리소스 참조를 위해 입력 파라미터를 수정합니다.

### 오류: 도구가 내부 오류로 응답
<a name="spark-upgrade-agent-internal-error"></a>
+ 표시되는 경우 몇 초 후에 도구 호출을 다시 시도`The service is handling high-volume requests`하세요.
+ 분석 ID, 도구 이름, mcp 로그 또는 도구 응답에서 사용할 수 있는 오류 메시지, 선택적으로 삭제된 대화 기록을 문서화하고 AWS 지원 팀에 문의`INTERNAL SERVICE EXCEPTION`하세요.

## Q&A
<a name="spark-upgrade-agent-qa"></a>

### 1. 도구에 대해 기본적으로 "신뢰" 설정을 활성화해야 합니까?
<a name="spark-upgrade-agent-qa-trust-setting"></a>

처음에는 모든 도구 호출에 대해 기본적으로 "신뢰" 설정을 켜지 않고 git 버전 빌드 환경에서 작동합니다. 각 도구 실행을 검토하여 변경 사항을 파악합니다. 예를 들어 동의를 제공하기 전에 업그레이드 계획을 검토합니다. Kiro 또는 에이전트의 `fs_write` 도구를 신뢰하지 마세요.이 도구는 프로젝트 파일을 수정하므로 변경 사항을 저장/커밋하기 전에 항상 검토해야 합니다. 일반적으로 제안된 모든 파일 변경 사항을 기록하도록 허용하기 전에 검토합니다. git을 사용하여 버전 변경을 수행하고 업그레이드 프로세스 전반에 걸쳐 체크포인트를 생성합니다. 점진적으로 신뢰 구축 - 시스템을 여러 업그레이드에 반복적으로 사용하고 도구에 대한 신뢰를 얻은 경우 특정 도구를 선택적으로 신뢰할 수 있습니다.

### 2. 업그레이드 도구를 활용하기 위한 일반적인 예제 프롬프트는 무엇입니까?
<a name="spark-upgrade-agent-qa-prompt-examples"></a>

업그레이드 도구 활용에 대한 프롬프트 예제[Spark 업그레이드 에이전트에 대한 프롬프트 예제](emr-spark-upgrade-agent-prompt-examples.md)는 섹션을 참조하세요.