Amazon Q Business 웹 경험에 “Sorry, I could not find relevant information to complete your request”라는 오류 메시지가 표시되는 이유는 무엇입니까?

해결 방법

“Sorry, I could not find relevant information to complete your request” 오류 메시지는 다음과 같은 이유로 발생할 수 있습니다.

• 문서에 잘못된 프롬프트를 사용하고 있습니다.
• 문서에 대한 액세스 제어 목록(ACL) 문제가 있습니다.

프롬프트가 올바른지 확인

Amazon Q Business는 메타 또는 집계 프롬프트에 대한 응답을 반환하지 않으며 ID 또는 이름으로 특정 문서 또는 프로젝트를 쿼리하는 것을 허용하지 않습니다.

예를 들어, Amazon Q 비즈니스는 다음과 같은 프롬프트에 응답할 수 없습니다.

• “현재 몇 장의 티켓이 열려 있습니까?”
• "내 프로젝트와 관련된 Jira 티켓 목록을 인쇄하십시오."
• “어떤 데이터 소스가 인덱싱되었습니까?”
• “데이터에는 무엇이 포함되어 있습니까?”

“프로젝트 XYZ에서 문서를 찾아 요약하십시오”와 유사한 쿼리를 보내면 Amazon Q Business는 특정 문서를 찾을 수 없습니다. 하지만 Amazon Q Business는 프로젝트 XYZ를 언급한 모든 문서에 응답한 다음 내용을 요약할 수 있습니다.

특정 문서를 대상으로 하는 프롬프트 생성

프롬프트를 구성할 때는 다음과 같은 구조적 요소를 사용하는 것이 좋습니다.

• 주요 요구 사항: Amazon Q Business에서 제공하기를 원하는 작업 또는 정보.
• 컨텍스트: Amazon Q Business가 요청을 완료하는 데 필요할 수 있는 추가 컨텍스트.
• 입력 데이터: 응답에 영향을 줄 수 있는 추가 데이터 요소
• 출력 요청: Amazon Q Business가 응답을 제공하기를 원하는 형식.

다음 예제 프롬프트에서는 Windows 랩톱 사용 설명서 PDF 파일을 데이터 소스로 사용합니다.

“Wi-Fi에 연결할 수 없는 Windows 랩톱의 문제 해결 단계는 무엇입니까? 업데이트하고 Wi-Fi 드라이버를 재설정하려고 시도했지만 문제가 계속되고 있습니다. 단계를 글머리 기호로 서식 지정하십시오.”

위 프롬프트에는 다음과 같은 네 가지 요소가 포함되어 있습니다.

• 주요 요구 사항: 문제 해결 단계
• 컨텍스트: Wi-Fi에 연결할 수 없는 Windows 랩톱
• 입력 데이터: 업데이트하고 Wi-Fi 드라이버를 재설정하려고 시도했지만 문제가 계속됨
• 출력 요청: 단계를 글머리 기호로 서식 지정

참고: 샘플 프롬프트를 보려면 Amazon Q Business에서 빠른 프롬프트를 활성화하십시오.

특정 문서를 대상으로 하는 프롬프트를 만들려면 다음 단계를 완료하십시오.

1. Amazon Q Business 콘솔을 엽니다.
2. 탐색 창에서 Applications(애플리케이션)을 선택하고, 애플리케이션 이름을 선택합니다.
3. Enhancements(개선 사항)에서 Data sources(데이터 소스)를 선택합니다.
4. Dats source(데이터 소스)에서 데이터 소스 이름을 검색하고 Last sync status(마지막 동기화 상태)가 Completed(완료됨)인지 확인합니다.
5. Index(인덱스)에서 문서 수 속성을 검사하여 인덱스에 문서를 추가했는지 확인합니다.
6. 동기화 실행 기록 보고서를 검토하여 문서가 동기화되었는지 확인합니다.
7. 문서 본문의 정보와 관련된 프롬프트를 생성합니다.
8. 프롬프트를 Amazon Q Business에 보낸 다음 응답을 기다립니다.
9. Amazon Q Business가 올바른 문서를 참조하는지 확인하려면 Amazon Q Business가 응답에서 반환하는 인용을 확인하십시오.

문서의 ACL 확인

참고: AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류가 발생하면 AWS CLI의 오류 해결을 참조하십시오. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.

유효한 프롬프트를 사용하는데도 여전히 오류가 발생하는 경우 소스 문서의 ACL을 확인하십시오. 커넥터의 ACL을 활성화하면 Amazon Q Business는 문서의 ACL에 사용자 이름이 포함된 문서만 반환합니다.

참고: ACL을 비활성화할 수 있습니다. 하지만 데이터 소스를 삭제하고 다시 생성해야 합니다.

소스 문서가 ACL에 나타나는지 확인하려면 다음 단계를 완료하십시오.

1. Amazon Q Business 콘솔을 엽니다.
2. 탐색 창에서 Applications(애플리케이션)을 선택하고, 애플리케이션 이름을 선택합니다.
3. 탐색 창의 Enhancements(개선 사항)에서 Data sources(데이터 소스)를 선택합니다.
4. Data source(데이터 소스)에서 데이터 소스 이름을 검색한 다음 데이터 소스를 선택합니다.
5. Sync run history(동기화 실행 기록) 탭을 선택한 다음 Actions(작업) 열에서 View report(보고서 보기)를 선택하여 Amazon CloudWatch Logs Insights의 새 탭을 엽니다.
6. Run query(쿼리 실행)를 선택합니다.
7. 보고서에서 소스 문서를 찾은 다음 문서의 ACL에 대한 ACL 열을 확인합니다.
8. ACL을 확인하여 사용자 이름이 AWS IAM Identity Center의 이메일 ID와 일치하는지 확인하십시오.
9. 사용자 이름과 이메일 ID가 일치하지 않는 경우 ACL의 사용자 이름을 포함하도록 User Store에서 별칭을 업데이트하십시오. update-user AWS CLI 명령을 실행합니다.

   aws qbusiness update-user \
     --application-id your_q_business_application_id \
     --user-id your_q_business_user_email \
     --user-aliases-to-update '[{"userId": "your_user_id_from_data_source"}]'

   참고: your_q_business_application_id를 애플리케이션 ID로, your_q_business_user_email을 사용자 이메일 주소로, your_user_id_from_data_source를 데이터 소스의 사용자 ID로 바꾸십시오.
10. (선택 사항) 별칭이 업데이트되었는지 확인하려면 get-user AWS CLI 명령을 실행합니다.

aws qbusiness get-user --application-id your_q_business_application_id --user-id your_q_business_user_email

참고: your_q_business_application_id를 애플리케이션 ID로, your_q_business_user_email을 사용자 이메일 주소로 바꾸십시오. 데이터 소스를 동기화하여 문서의 ACL을 업데이트하십시오.