Perché la mia esperienza web Amazon Q Business restituisce il messaggio di errore "Sorry, I could not find relevant information to complete your request"?

Risoluzione

Il messaggio di errore "Sorry, I could not find relevant information to complete your request" può dipendere dai seguenti motivi:

• Stai utilizzando prompt errati per il documento.
• Sono presenti problemi relativi alla lista di controllo degli accessi (ACL) per il documento.

Verifica la presenza di prompt validi

Amazon Q Business non restituisce risposte a prompt di metadati o aggregazione né consente di eseguire query su documenti o progetti specifici per ID o nome.

Ad esempio, Amazon Q Business non può rispondere ai seguenti prompt:

• "Quanti ticket sono attualmente aperti?"
• "Stampa un elenco di biglietti Jira relativi al mio progetto."
• "Quali origini dati sono state indicizzate?"
• "Cosa è contenuto nei dati?"

Quando invii una query simile a "Trova il documento sul progetto XYZ e riassumilo", Amazon Q Business non riesce a trovare il documento specifico. Amazon Q Business potrebbe tuttavia rispondere con tutti i documenti che menzionano il progetto XYZ e quindi riassumerne il contenuto.

Crea prompt destinati a documenti specifici

Quando strutturi il prompt, è consigliabile utilizzare i seguenti elementi strutturali:

• Quesito principale: L'azione o le informazioni che desideri che Amazon Q Business fornisca.
• Contesto: Il contesto aggiuntivo che Amazon Q Business potrebbe richiedere per completare la richiesta.
• Dati di input: Punti dati aggiuntivi che potrebbero influenzare la risposta.
• Richiesta di output: Il formato in cui desideri che Amazon Q Business fornisca la risposta.

Il seguente esempio di prompt utilizza un file PDF del manuale utente di un laptop Windows come origine dati:

"Quali sono i passaggi per la risoluzione dei problemi di un laptop Windows che non riesce a connettersi al Wi-Fi? Ho provato ad aggiornarlo e a ripristinare i driver Wi-Fi, ma i problemi persistono. Formatta i passaggi come punti elenco."

Il prompt precedente contiene i quattro elementi seguenti:

• Quesito principale: Quali sono i passaggi per la risoluzione dei problemi
• Contesto: Di un laptop Windows che non riesce a connettersi al Wi-Fi
• Dati di input: Ho provato ad aggiornarlo e a ripristinare i driver Wi-Fi, ma i problemi persistono
• Richiesta di output: Formatta i passaggi come punti elenco

Nota: per visualizzare esempi di prompt, attiva Quick prompts in Amazon Q Business (Richieste veloci in Amazon Q Business).

Per creare prompt destinati a documenti specifici, completa i seguenti passaggi:

1. Apri la console Amazon Q Business.
2. Nel pannello di navigazione, scegli Applications (Applicazioni), quindi seleziona il nome dell'applicazione.
3. In Enhancements (Miglioramenti), scegli Data sources (Origini dati).
4. In Data source (Origine dati), cerca il nome dell'origine dati e verifica che Last sync status (Stato dell'ultima sincronizzazione) sia Completed (Completata).
5. In Index (Indice), seleziona l'attributo numero di documenti per verificare di aver aggiunto documenti all'indice.
6. Controlla il report sulla cronologia delle sincronizzazioni per verificare che il documento sia stato sincronizzato.
7. Crea prompt specifici per le informazioni contenute nel corpo del documento.
8. Invia il prompt ad Amazon Q Business, quindi attendi una risposta.
9. Per verificare se Amazon Q Business fa riferimento al documento corretto, controlla la citazione che Amazon Q Business restituisce nella risposta.

Controlla le ACL dei documenti

Nota: se ricevi errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta Risoluzione degli errori relativi ad AWS CLI. Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Se utilizzi prompt validi e continui a riscontrare l'errore, controlla le ACL dei documenti di origine. Quando attivi le ACL per il tuo connettore, Amazon Q Business restituisce solo i documenti che includono il tuo nome utente nell'ACL del documento.

Nota: puoi disattivare le ACL. Devi tuttavia eliminare l'origine dati e ricrearla.

Per verificare che i documenti di origine compaiano nelle ACL, completa i seguenti passaggi:

1. Apri la console Amazon Q Business.
2. Nel pannello di navigazione, scegli Applications (Applicazioni), quindi seleziona il nome dell'applicazione.
3. Nel pannello di navigazione, in Enhancements (Miglioramenti), scegli Data sources (Origini dati).
4. In Data source (Origine dati), cerca il nome dell'origine dati e selezionala.
5. Scegli la scheda Sync run history (Cronologia delle sincronizzazioni), quindi apri una nuova scheda per Amazon CloudWatch Logs Insights selezionando View report (Visualizza report) nella colonna Actions (Operazioni).
6. Scegli Esegui una query.
7. Individua il documento di origine nel report, quindi controlla le ACL del documento nella colonna ACL.
8. Controlla l'ACL per assicurarti che il nome utente corrisponda al tuo ID e-mail nel Centro identità AWS IAM.
9. Se il nome utente e l'ID e-mail non corrispondono, aggiorna il tuo alias nello Store utenti per includere il nome utente dell'ACL. Esegui il comando AWS CLI update-user:

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

   Nota: sostituisci your_q_business_application_id con l'ID della tua applicazione, your_q_business_user_email con il tuo indirizzo e-mail utente e your_user_id_from_data_source con il tuo ID utente dell'origine dati.
10. (Facoltativo) Per verificare che l'alias sia aggiornato, esegui il comando AWS CLI get-user:

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

Nota: sostituisci your_q_business_application_id con l'ID della tua applicazione e your_q_business_user_email con il tuo indirizzo e-mail utente. Sincronizza l'origine dati per aggiornare le ACL dei documenti.