Interroga una knowledge base e recupera i dati

Importante

I guardrail vengono applicati solo all'input e alla risposta generata dal LLM. Non vengono applicati ai riferimenti recuperati dalle Knowledge Base in fase di esecuzione.

Dopo aver configurato la Knowledge Base, è possibile interrogarla e recuperare dai dati di origine parti pertinenti alla query utilizzando il RetrieveFunzionamento tramite API. 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 ruolo IAM con autorizzazioni 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. Per informazioni sulle configurazioni, vedere. Configura e personalizza le interrogazioni e la generazione di risposte

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 rilevanza. Le immagini estratte dall'origine dati possono anche essere restituite come blocco di origine.

8. Per visualizzare i dettagli sui blocchi restituiti, seleziona Mostra dettagli di origine.

   • 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. Puoi visualizzare le seguenti informazioni:

     • Il testo non elaborato dal blocco sorgente. 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.
Query di recupero	Contiene un text campo per specificare la query.
Configurazione Guardrail	Includi campi GuardrailsConfiguration come guardrailsId e guardrailsVersion per utilizzare il tuo 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).
Configurazione di recupero	Per includere configurazioni di interrogazione per personalizzare la ricerca vettoriale. Per ulteriori informazioni, consulta KnowledgeBaseVectorSearchConfiguration.

Puoi utilizzare un modello di riposizionamento 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, l'URI dei dati del contenuto con codifica base64 viene restituito 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 JSON a cui la chiave è mappata.
posizione	Contiene l'URI o l'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'URI Amazon S3 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