Interroga una knowledge base e recupera i dati

Dopo aver configurato la knowledge base, è possibile interrogarla e recuperare parti dai dati di origine pertinenti alla query utilizzando il RetrieveAPIoperazione. Puoi anche utilizzare un modello di riclassificazione al posto del ranker predefinito di Amazon Bedrock Knowledge Bases per classificare i blocchi di origine in base alla pertinenza durante il recupero.

Per imparare a interrogare la tua knowledge base, scegli la scheda corrispondente al metodo che preferisci, quindi segui i passaggi:

Console

Per testare la tua knowledge base

1. Accedi all' AWS Management Console utilizzo di un IAMruolo con le autorizzazioni di Amazon Bedrock e apri la console Amazon Bedrock all'indirizzo. https://console.aws.amazon.com/bedrock/

2. Nel riquadro di navigazione a sinistra, scegli Knowledge base.

3. Nella sezione Basi di conoscenza, esegui una delle seguenti azioni:

   • Scegli il pulsante di opzione accanto alla knowledge base che desideri testare e seleziona Testa knowledge base. Una finestra di test si espande da destra.

   • Scegli la knowledge base che desideri testare. Una finestra di test si espande da destra.

4. Nella finestra di test, deseleziona Genera risposte per la tua query per restituire le informazioni recuperate direttamente dalla tua knowledge base.

5. (Facoltativo) Seleziona l'icona delle configurazioni ( ) per aprire Configurazioni. È possibile modificare le seguenti configurazioni:

   • Tipo di ricerca: specifica in che modo viene richiesta la tua knowledge base. Per ulteriori informazioni, consulta Tipo di ricerca.

   • Numero massimo di risultati recuperati: specifica il numero massimo di risultati da recuperare. Per ulteriori informazioni, consulta Numero massimo di risultati recuperati.

   • Filtri: specifica fino a 5 gruppi di filtri e fino a 5 filtri all'interno di ciascun gruppo da utilizzare con i metadati dei file. Per ulteriori informazioni, consulta Filtraggio manuale dei metadati.

6. Inserisci una query nella casella di testo della finestra di chat e seleziona Esegui per restituire le risposte dalla knowledge base.

7. I blocchi di origine vengono restituiti direttamente in ordine di pertinenza. Le immagini estratte dall'origine dati possono anche essere restituite come blocco di origine.

8. Per visualizzare i dettagli sui blocchi restituiti, seleziona Mostra i dettagli della fonte.

   • Per visualizzare le configurazioni impostate per la query, espandi Configurazioni di query.

   • Per visualizzare i dettagli su un blocco di origine, espandetelo scegliendo la freccia destra ( ) accanto ad esso. È possibile visualizzare le seguenti informazioni:

     • Il testo non elaborato dal blocco di origine. Per copiare questo testo, scegliete l'icona di copia ( ). Se hai utilizzato Amazon S3 per archiviare i tuoi dati, scegli l'icona del link esterno ( ) per accedere all'oggetto S3 contenente il file.

     • I metadati associati al blocco di origine, se hai utilizzato Amazon S3 per archiviare i tuoi dati. Le chiavi e i valori degli attributi/campi sono definiti nel .metadata.json file associato al documento di origine. Per ulteriori informazioni, consulta la sezione Metadati e filtri in. Configura e personalizza le interrogazioni e la generazione di risposte

Opzioni di chat

• Passa alla generazione di risposte in base ai blocchi di origine recuperati attivando Genera risposte. Se modifichi l'impostazione, il testo nella finestra della chat verrà completamente cancellato.

• Per cancellare la finestra della chat, seleziona l'icona a forma di scopa ().

• Per copiare tutto l'output nella finestra di chat, seleziona l'icona di copia ( ).

API

Per interrogare una knowledge base e restituire solo il testo pertinente dalle fonti di dati, invia un Retrieverichiesta con un endpoint di runtime Agents for Amazon Bedrock.

I seguenti campi sono obbligatori:

Campo	Descrizione di base
knowledgeBaseId	Per specificare la base di conoscenza da interrogare.
retrievalQuery	Contiene un text campo per specificare l'interrogazione.
guardrailsConfiguration	Includi guardrailsConfiguration campi come guardrailsId e guardrailsVersion da usare il guardrail nella richiesta

I seguenti campi sono opzionali:

Campo	Caso d'uso
nextToken	Per restituire il successivo batch di risposte (vedi i campi di risposta di seguito).
retrievalConfiguration	Per includere configurazioni di query per personalizzare la ricerca vettoriale. Per ulteriori informazioni, consulta KnowledgeBaseVectorSearchConfiguration.

Puoi utilizzare un modello di riclassificazione rispetto al modello di classificazione predefinito di Amazon Bedrock Knowledge Bases includendo il rerankingConfiguration campo nel. KnowledgeBaseVectorSearchConfiguration Il rerankingConfiguration campo è mappato su un VectorSearchRerankingConfigurationoggetto, in cui è possibile specificare il modello di riclassificazione da utilizzare, eventuali campi di richiesta aggiuntivi da includere, gli attributi dei metadati per filtrare i documenti durante la nuova classificazione e il numero di risultati da restituire dopo la nuova classificazione. Per ulteriori informazioni, consulta VectorSearchRerankingConfiguration.

Nota

Se il numberOfRerankedResults valore specificato è maggiore del valore in KnowledgeBaseVectorSearchConfiguration, il numero massimo di risultati che verranno restituiti è il numberOfResults valore per. numberOfResults Un'eccezione è rappresentata dall'utilizzo della decomposizione delle query (per ulteriori informazioni, vedere la sezione Modifiche alle query in. Configura e personalizza le interrogazioni e la generazione di risposte Se si utilizza la decomposizione delle query, numberOfRerankedResults può essere fino a cinque volte superiore. numberOfResults

La risposta restituisce i blocchi di origine dall'origine dati come matrice di KnowledgeBaseRetrievalResultoggetti sul campo. retrievalResults Ciascuno KnowledgeBaseRetrievalResultcontiene i seguenti campi:

Campo	Descrizione
contenuto	Contiene un blocco di origine di testo nel campo text o un blocco di origine dell'immagine nel byteContent campo. Se il contenuto è un'immagine, i dati URI del contenuto con codifica base64 vengono restituiti nel seguente formato:. data:image/jpeg;base64,${base64-encoded string}
metadata	Contiene ogni attributo di metadati come chiave e il valore dei metadati come valore a cui la chiave è mappataJSON.
posizione	Contiene l'URIor URL del documento a cui appartiene il blocco di origine.
punteggio	Il punteggio di pertinenza del documento. È possibile utilizzare questo punteggio per analizzare la classifica dei risultati.

Se il numero di blocchi di origine supera quello che può essere contenuto nella risposta, nel campo viene restituito un valore. nextToken Usa quel valore in un'altra richiesta per restituire il successivo batch di risultati.

Se i dati recuperati contengono immagini, la risposta restituisce anche le seguenti intestazioni di risposta, che contengono i metadati per i blocchi di origine restituiti nella risposta:

• x-amz-bedrock-kb-byte-content-source— Contiene l'Amazon S3 URI dell'immagine.

• x-amz-bedrock-kb-description— Contiene la stringa codificata in base64 per l'immagine.

Nota

Non è possibile filtrare in base a queste intestazioni di risposta ai metadati durante la configurazione dei filtri dei metadati.

Nota

Se ricevi un errore che indica che il prompt supera il limite di caratteri durante la generazione delle risposte, puoi abbreviare il prompt nei seguenti modi:

• Riduci il numero massimo di risultati recuperati (in questo modo si accorcia ciò che viene inserito per il segnaposto $search_results$ in). Modelli di prompt della Knowledge Base: orchestrazione e generazione

• Ricrea la fonte di dati con una strategia di suddivisione in blocchi che utilizza blocchi più piccoli (in questo modo si accorcia ciò che viene inserito per il segnaposto $search_results$ in). Modelli di prompt della Knowledge Base: orchestrazione e generazione

• Abbrevia il modello di prompt.

• Abbrevia la query dell'utente (in questo modo si accorcia ciò che viene compilato per il segnaposto $query$ in). Modelli di prompt della Knowledge Base: orchestrazione e generazione