Por que a minha Experiência Web do Amazon Q Business me retorna a seguinte mensagem de erro: “Sorry, I could not find relevant information to complete your request”?

Resolução

A mensagem de erro “Sorry, I could not find relevant information to complete your request” poderá ocorrer pelos seguintes motivos:

• Está utilizando prompts incorretos para o documento.
• Há problemas na lista de controle de acesso (ACL) no documento.

Verifique se há prompts válidos

O Amazon Q Business não retorna respostas para prompts meta ou de agregação e nem permite consultar documentos ou projetos específicos através do ID ou nome.

Por exemplo, o Amazon Q Business não é capaz de responder aos seguintes prompts:

• “Quantos tickets estão abertos no momento?”
• “Exiba uma lista de tickets do Jira relacionados ao meu projeto.”
• “Quais fontes de dados foram indexadas?”
• “O que está contido nos dados?”

Quando enviar uma consulta semelhante a “Encontre o documento no projeto XYZ e o resuma”, o Amazon Q Business não conseguirá encontrar o documento específico. No entanto, o Amazon Q Business pode dar uma resposta que contenha todos os documentos que mencionam o projeto XYZ, e em seguida, resumir o conteúdo.

Criar prompts direcionados a documentos específicos

Ao estruturar um prompt, seria uma prática recomendada, criá-lo utilizando os seguintes elementos estruturais:

• Pedido principal: A ação ou as informações que você deseja que o Amazon Q Business forneça.
• Contexto: O contexto adicional, no qual o Amazon Q Business pode exigir para que ele conclua a solicitação.
• Dados de entrada: Pontos de dados adicionais que podem influenciar na resposta.
• Solicitação de saída: O formato em que deseja que o Amazon Q Business forneça a resposta.

O exemplo de prompt a seguir utiliza um arquivo PDF do manual de usuário do laptop Windows como fonte de dados:

“Quais são as etapas que podem ajudar a solucionar problemas em um laptop Windows que não consegue se conectar ao Wi-Fi? Tentei atualizá-lo e redefinir os drivers do Wi-Fi, mas os problemas ainda persistem. Formate as etapas como marcadores.”

O prompt anterior contem os quatro elementos a seguir:

• Pedido principal: Quais são as etapas para solucionar problemas
• Contexto: Em um laptop Windows que não consegue se conectar ao Wi-Fi
• Dados de entrada: Tentei atualizá-lo e redefinir os drivers do Wi-Fi, mas os problemas ainda persistem
• Solicitação de saída: Formate as etapas como marcadores

Observação: Para ver exemplos de prompts, ative os Prompts instantâneos no Amazon Q Business.

Para criar prompts direcionados a documentos específicos, conclua as seguintes etapas:

1. Abra o Console Amazon Q Business.
2. No painel de navegação, selecione Aplicações e em seguida selecione o nome da sua aplicação.
3. Em Aprimoramentos, selecione Fontes de dados.
4. Em Fonte de dados pesquise o nome da fonte de dados e confirme se o Último status de sincronização está como Concluído.
5. Em Índice, verifique o atributo de contagem de documentos para confirmar se adicionou os documentos ao índice.
6. Revise o Relatório do histórico de execução de sincronização para confirmar se o documento foi sincronizado.
7. Crie prompts específicos com as informações no corpo do documento.
8. Envie o prompt para o Amazon Q Business e aguarde por uma resposta.
9. Para confirmar que o Amazon Q Business faz referência ao documento correto, verifique a citação que o Amazon Q Business retorna na resposta.

Verifique os documentos nas ACLs

Observação: Se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está utilizando a versão mais recente da AWS CLI.

Caso estiver usando prompts válidos e ainda assim experienciar o erro, verifique as ACLs dos seus documentos de origem. Quando ativar as ACLs para seu conector, o Amazon Q Business retorna somente documentos que incluem seu nome de usuário na ACL do documento.

Observação: É possível desativar as ACLs. No entanto, deverá excluir a fonte de dados e recriá-la.

Para confirmar que os documentos de origem aparecem nas ACLs, conclua as seguintes etapas:

1. Abra o Console Amazon Q Business.
2. No painel de navegação, selecione Aplicações e em seguida selecione o nome da sua aplicação.
3. No painel de navegação, em Aprimoramentos, selecione Fontes de dados.
4. Em Fonte de dados, pesquise o nome da fonte de dados e então selecione a sua fonte de dados.
5. Selecione a guia Histórico de execução de sincronização e logo a seguir, selecione Exibir relatório na coluna Ações para abrir uma nova guia para o Amazon CloudWatch Logs Insights.
6. Selecione Executar consulta.
7. Encontre o documento de origem no relatório e posteriormente, verifique a coluna ACL para ver as ACLs do seu documento.
8. Verifique a ACL para garantir que seu nome de usuário corresponda ao seu ID de e-mail no centro de identidade do AWS IAM.
9. Caso o nome de usuário e o ID de e-mail não corresponderem, atualize o alias no repositório de usuários para incluir o nome de usuário da ACL. Execute o comando update-user da 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"}]'

   Observação: Substitua your\ _q\ _business\ _application\ _id pelo ID da aplicação, your\ _q\ _business\ _user\ _email pelo endereço de e-mail do usuário e your_user\ _id\ _from\ _data\ _source pelo ID do usuário da sua fonte de dados.
10. (Opcional) Para verificar se o alias foi atualizado, execute o comando get-user da AWS CLI:

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

Observação: Substitua your\ _q\ _business\ _application\ _id pelo ID da aplicação e your_q_business_user_email com o endereço de e-mail do usuário. Sincronize sua fonte de dados para atualizar as ACLs dos seus documentos.