Seleziona le tue preferenze relative ai cookie

Utilizziamo cookie essenziali e strumenti simili necessari per fornire il nostro sito e i nostri servizi. Utilizziamo i cookie prestazionali per raccogliere statistiche anonime in modo da poter capire come i clienti utilizzano il nostro sito e apportare miglioramenti. I cookie essenziali non possono essere disattivati, ma puoi fare clic su \"Personalizza\" o \"Rifiuta\" per rifiutare i cookie prestazionali.

Se sei d'accordo, AWS e le terze parti approvate utilizzeranno i cookie anche per fornire utili funzionalità del sito, ricordare le tue preferenze e visualizzare contenuti pertinenti, inclusa la pubblicità pertinente. Per continuare senza accettare questi cookie, fai clic su \"Continua\" o \"Rifiuta\". Per effettuare scelte più dettagliate o saperne di più, fai clic su \"Personalizza\".

Interroga una knowledge base e recupera i dati

Modalità Focus
Interroga una knowledge base e recupera i dati - Amazon Bedrock

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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.

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 ( ).

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:

PrivacyCondizioni del sitoPreferenze cookie
© 2025, Amazon Web Services, Inc. o società affiliate. Tutti i diritti riservati.