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

# 에이전트 셀프 서비스 문제 해결
<a name="ts-agentic-self-service"></a>

다음은 [에이전트 셀프 서비스에](agentic-self-service.md) 특정한 문제입니다.

## AI 에이전트가 고객에게 응답하지 않음
<a name="ts-ai-agent-not-responding"></a>

AI 에이전트가 요청을 처리하고 있지만 고객에게 응답이 표시되지 않는 경우 오케스트레이션 프롬프트에 필요한 메시지 형식 지정 지침이 누락되었을 수 있습니다.

오케스트레이터 AI 에이전트는 모델의 응답이 `<message>` 태그로 래핑된 경우에만 고객에게 메시지를 표시합니다. 프롬프트가 이러한 태그를 사용하도록 모델에 지시하지 않으면 응답이 고객에게 렌더링되지 않습니다.

**해결** 방법: 오케스트레이션 프롬프트에 모델이 응답을 `<message>` 태그로 래핑해야 하는 형식 지정 지침이 포함되어 있는지 확인합니다. 자세한 내용은 [메시지 구문 분석](use-orchestration-ai-agent.md#message-parsing) 단원을 참조하십시오.

## MCP 도구 호출 실패
<a name="ts-mcp-tool-failures"></a>

AI 에이전트가 대화 중에 MCP 도구를 호출하지 못하는 경우 다음을 확인하세요.
+ **보안 프로필 권한** - AI 에이전트의 보안 프로필이 필요한 특정 MCP 도구에 대한 액세스 권한을 부여하는지 확인합니다. AI 에이전트는 액세스 권한이 있는 도구만 호출할 수 있습니다.
+ **게이트웨이 연결** - Amazon Bedrock AgentCore Gateway가 올바르게 구성되었고 검색 URL이 유효한지 확인합니다. 인바운드 인증 대상이 게이트웨이 ID로 설정되어 있는지 확인합니다. AgentCore 콘솔에서 게이트웨이 상태를 확인합니다.
+ **API 엔드포인트 상태** - MCP 도구 뒤의 백엔드 API 또는 Lambda 함수가 실행 중이고 올바르게 응답하는지 확인합니다. CloudWatch Logs에서 대상 서비스에 오류가 있는지 확인합니다.

## MCP 도구에 대한 IAM 권한
<a name="ts-mcp-iam-permissions"></a>

MCP 도구 호출이 액세스 거부 오류를 반환하는 경우 IAM 역할에 필요한 권한이 있는지 확인합니다.
+ **Amazon Bedrock AgentCore Gateway 역할** - 게이트웨이의 실행 역할에는 MCP 도구가 연결되는 백엔드 APIs 또는 Lambda 함수를 호출할 수 있는 권한이 있어야 합니다.
+ **Amazon Connect 서비스 연결 역할** - Amazon Connect 서비스 연결 역할에는 Amazon Bedrock AgentCore Gateway를 호출할 수 있는 권한이 있어야 합니다.