As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Consultar uma base de conhecimento e gerar respostas com base nos dados recuperados **Importante** As barreiras de proteção são aplicadas somente à entrada e à resposta gerada pelo LLM. Elas não são aplicados às referências recuperadas das bases de conhecimento em runtime. Depois de configurar a base de conhecimento, você pode consultá-la e gerar respostas baseadas nos fragmentos recuperados dos dados da fonte usando a operação de API [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html). As respostas são exibidas com citações dos dados da fonte original. Também é possível [usar um modelo de reclassificação](rerank.md) em vez do classificador padrão das Bases de Conhecimento do Amazon Bedrock para classificar os fragmentos de origem quanto à relevância durante a recuperação. **Limitações de conteúdo multimodal** `RetrieveAndGenerate`tem suporte limitado para conteúdo multimodal. Ao usar o Nova Multimodal Embeddings, a funcionalidade do RAG é restrita apenas ao conteúdo de texto. Para suporte multimodal completo, incluindo processamento de áudio e vídeo, use o BDA com modelos de incorporação de texto. Para obter detalhes, consulte [Crie uma base de conhecimento para conteúdo multimodal](kb-multimodal.md). **nota** As imagens exibidas da resposta `Retrieve` durante o fluxo `RetrieveAndGenerate` são incluídas no prompt para geração de resposta. A resposta `RetrieveAndGenerate` não pode incluir imagens, mas pode citar as fontes que contêm as imagens. Para saber como consultar uma base de conhecimento, escolha a guia correspondente ao método de sua preferência e siga as etapas: ------ #### [ Console ] **Como testar a base de conhecimento** 1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. No painel de navegação à esquerda, selecione **Bases de conhecimento**. 1. Na seção **Bases de conhecimento**, execute uma das ações a seguir. + Escolha o botão de opção ao lado da base de conhecimento que deseja testar e selecione **Testar base de conhecimento**. Uma janela de teste é expandida à direita. + Escolha a base de conhecimento que deseja testar. Uma janela de teste é expandida à direita. 1. Para gerar respostas com base em informações recuperadas da base de conhecimento, ative a opção **Gerar respostas para a consulta**. O Amazon Bedrock gerará respostas com base nas fontes de dados e citará as informações fornecidas com notas de rodapé. 1. Para escolher um modelo para usar para geração de respostas, escolha **Selecionar um modelo**. Selecione **Aplicar**. 1. (Opcional) Selecione o ícone de configurações (![\[Three horizontal sliders with adjustable circular controls for settings or parameters.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/configurations.png)) para abrir **Configurações**. Para ter mais informações configurações, consulte [Configurar e personalizar consultas e geração de respostas](kb-test-config.md). 1. Insira uma consulta na caixa de texto da janela de chat e selecione **Executar** para retornar respostas da base de conhecimento. 1. Selecione uma nota de rodapé para ver um trecho da fonte citada por essa parte da resposta. Escolha o link para navegar até o objeto do S3 que contém o arquivo. 1. Para ver detalhes sobre os fragmentos exibidos, selecione **Mostrar detalhes da fonte**. + Para ver as configurações que definiu para a consulta, expanda **Configurações de consulta**. + Para ver detalhes sobre um fragmento de origem, expanda-o escolhendo a seta para a direita (![\[Play button icon with a triangular shape pointing to the right.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/caret-right-filled.png)) ao lado dele. É possível editar as seguintes informações: + O texto bruto do fragmento de origem. Para copiar esse texto, escolha o ícone de cópia (![\[Icon representing a crop or resize function, with two overlapping rectangles.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/copy.png)). Se tiver usado o Amazon S3 para armazenar os dados, escolha o ícone de link externo (![\[Icon of a square with an arrow pointing outward from its top-right corner.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/external.png)) para navegar ao objeto do S3 que contém o arquivo. + Os metadados associados ao fragmento de origem, se você usou o Amazon S3 para armazenar seus dados. As attribute/field chaves e os valores são definidos no `.metadata.json` arquivo associado ao documento de origem. Para ter mais informações, consulte a seção **Metadados e filtragem** em [Configurar e personalizar consultas e geração de respostas](kb-test-config.md). **Opções do chat** + Para usar um modelo diferente para geração de resposta, selecione **Alterar modelo**. Se você alterar o modelo, o texto na janela de chat será completamente apagado. + Opte por recuperar fragmentos de origem diretamente desmarcando **Gerar respostas**. Se você alterar a configuração, o texto na janela de chat será completamente apagado. + Para limpar a janela de chat, selecione o ícone de vassoura (![\[Magnifying glass icon with a checkmark inside, symbolizing search or inspection.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/broom.png)). + Para copiar toda a saída na janela de chat, selecione o ícone de cópia (![\[Icon representing a crop or resize function, with two overlapping rectangles.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/copy.png)). ------ #### [ API ] Para consultar uma base de conhecimento e usar um modelo de base para gerar respostas de acordo com os resultados das fontes de dados, envie uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) com um [endpoint de runtime do Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). A API [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateStream.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateStream.html) exibe os dados em um formato de streaming e permite acessar as respostas geradas em fragmentos sem esperar pelo resultado completo. Os seguintes campos são obrigatórios: **nota** A resposta da API contém eventos de citação. O membro `citation` foi descontinuado. Em vez disso, recomendamos usar os campos `generatedResponse` e `retrievedReferences`. Para referência, consulte [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CitationEvent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CitationEvent.html). **** | Campo | Descrição básica | | --- | --- | | input | Contém um campo text para especificar a consulta. | | retrieveAndGenerateConfiguração | Contém um [RetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateConfiguration.html), que especifica configurações para recuperação e geração. Veja mais detalhes abaixo. | Os seguintes campos são opcionais: **** | Campo | Caso de uso | | --- | --- | | sessionId | Use o mesmo valor de uma sessão anterior para dar continuidade a essa sessão e manter o contexto dela para o modelo. | | sessionConfiguration | Para incluir uma chave personalizada do KMS para criptografia da sessão. | Inclua o `knowledgeBaseConfiguration` campo no [RetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateConfiguration.html). Esse campo é mapeado para um [KnowledgeBaseRetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrieveAndGenerateConfiguration.html)objeto, que contém os seguintes campos: + Os seguintes campos são obrigatórios: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/kb-test-retrieve-generate.html) + Os seguintes campos são opcionais: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/kb-test-retrieve-generate.html) Você pode usar um modelo de reclassificação em relação ao modelo de classificação padrão do Amazon Bedrock Knowledge Bases incluindo o `rerankingConfiguration` campo no. [KnowledgeBaseVectorSearchConfiguration[KnowledgeBaseRetrievalConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseVectorSearchConfiguration.html) O `rerankingConfiguration` campo mapeia para um [VectorSearchRerankingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_VectorSearchRerankingConfiguration.html)objeto, no qual você pode especificar o modelo de reclassificação a ser usado, quaisquer campos de solicitação adicionais a serem incluídos, atributos de metadados para filtrar documentos durante a reclassificação e o número de resultados a serem retornados após a reclassificação. Para obter mais informações, consulte [VectorSearchRerankingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_VectorSearchRerankingConfiguration.html). **nota** Se o `numberOfRerankedResults` valor especificado for maior que o `numberOfResults` valor no [KnowledgeBaseVectorSearchConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseVectorSearchConfiguration.html), o número máximo de resultados que serão retornados será o valor para`numberOfResults`. Uma exceção é se você usar a decomposição de consultas (para ter mais informações, consulte a seção **Modificações de consulta** em [Configurar e personalizar consultas e geração de respostas](kb-test-config.md). Se você usar a decomposição de consultas, `numberOfRerankedResults` pode ser até cinco vezes o valor de `numberOfResults`. A resposta exibe resposta gerada no campo `output` e os fragmentos de origem citados como uma matriz no campo `citations`. Cada objeto [citação](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Citation.html) contém os campos a seguir. **** | Campo | Descrição básica | | --- | --- | | generatedResponsePart | No campo textResponsePart, o text ao qual a citação pertence está incluído. O campo span fornece os índices para o início e o fim da parte da saída que tem uma citação. | | retrievedReferences | Uma matriz de [RetrievedReference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievedReference.html)objetos, cada um contendo o fragmento content de origem metadata associado ao documento e o URI ou URL location do documento na fonte de dados. Se o conteúdo for uma imagem, o URI de dados do conteúdo codificado em base64 será exibido no seguinte formato: data:image/jpeg;base64,\$1\$1base64-encoded string\$1. | A resposta também exibe um valor `sessionId` que é possível reutilizar em outra solicitação para manter a mesma conversa. Se você incluiu uma `guardrailConfiguration` na solicitação, o campo `guardrailAction` informará se o conteúdo foi bloqueado ou não. Se os dados recuperados contiverem imagens, a resposta também exibirá os seguintes cabeçalhos de resposta, que contêm metadados para fragmentos de origem exibidos na resposta: + `x-amz-bedrock-kb-byte-content-source`: contém o URI do Amazon S3 da imagem. + `x-amz-bedrock-kb-description`: contém a string codificada em base64 da imagem. **nota** Não é possível filtrar esses cabeçalhos de resposta de metadados ao [configurar](kb-test-config.md) filtros de metadados. ------ **nota** Se você receber um erro informando que o prompt excede o limite de caracteres ao gerar respostas, é possível encurtar o prompt das seguintes maneiras: Reduza o número máximo de resultados recuperados (isso reduz o que é preenchido para o espaço reservado \$1search\$1results\$1 no [Modelos de prompt da base de conhecimento: orquestração e geração](kb-test-config.md#kb-test-config-prompt-template)). Recrie a fonte de dados com uma estratégia de fragmentação que usa fragmentos menores (isso reduz o que é preenchido para o espaço reservado \$1search\$1results\$1 no [Modelos de prompt da base de conhecimento: orquestração e geração](kb-test-config.md#kb-test-config-prompt-template)). Encurte o modelo do prompt. Encurte a consulta do usuário (isso reduz o que é preenchido para o espaço reservado \$1query\$1 no [Modelos de prompt da base de conhecimento: orquestração e geração](kb-test-config.md#kb-test-config-prompt-template)).