Consulte uma base de conhecimento e gere respostas com base nos dados recuperados - Amazon Bedrock

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á.

Consulte uma base de conhecimento e gere respostas com base nos dados recuperados

Depois que sua base de conhecimento estiver configurada, você poderá consultá-la e gerar respostas com base nos fragmentos recuperados dos dados de origem usando o RetrieveAndGenerateAPIoperação. As respostas são retornadas com citações aos dados da fonte original. Você também pode usar um modelo de reclassificação em vez do classificador padrão do Amazon Bedrock Knowledge Bases para classificar os trechos de origem quanto à relevância durante a recuperação.

nota

As imagens retornadas da Retrieve resposta durante o RetrieveAndGenerate fluxo são incluídas no prompt para geração de resposta. A RetrieveAndGenerate resposta não pode incluir imagens, mas pode citar as fontes que contêm as imagens.

Para saber como consultar sua base de conhecimento, escolha a guia do seu método preferido e siga as etapas:

Console
Como testar a base de conhecimento

  1. Faça login no AWS Management Console usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

  2. No painel de navegação esquerdo, escolha Bases de conhecimento.

  3. 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.

  4. 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é.

  5. Para escolher um modelo a ser usado para geração de resposta, escolha Selecionar modelo. Selecione Aplicar.

  6. (Opcional) Selecione o ícone de configurações ( ) para abrir Configurações. É possível modificar as seguintes configurações:

    • Tipo de pesquisa: especifique como sua base de conhecimento é consultada. Para obter mais informações, consulte Tipo de pesquisa.

    • Número máximo de resultados recuperados: especifique o número máximo de resultados a serem recuperados. Para obter mais informações, consulte Número máximo de resultados recuperados.

    • Filtros: especifique até cinco grupos de filtros e até cinco filtros em cada grupo para uso com os metadados dos arquivos. Para obter mais informações, consulte Filtragem manual de metadados.

    • Modelo de solicitação da base de conhecimento — Você pode substituir o modelo de solicitação padrão pelo seu próprio para personalizar a solicitação enviada ao modelo para geração de resposta. Para obter mais informações, consulte Modelos de prompt da base de conhecimento: orquestração e geração.

    • Guardrails — Você pode testar como os guardrails funcionam com as instruções e respostas da sua base de conhecimento. Para obter mais informações, consulte Proteções.

  7. Insira uma consulta na caixa de texto da janela de chat e selecione Executar para retornar respostas da base de conhecimento.

  8. Selecione uma nota de rodapé para ver um trecho da fonte citada para essa parte da resposta. Escolha o link para navegar até o objeto do S3 que contém o arquivo.

  9. Para ver detalhes sobre os fragmentos retornados, 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 ( ) 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 ( ). Se você usou o Amazon S3 para armazenar seus dados, escolha o ícone do link externo ( ) para navegar até o 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 chaves e valores de atributo/campo são definidos no .metadata.json arquivo associado ao documento de origem. Para obter mais informações, consulte a seção Metadados e filtragem em. Configurar e personalizar consultas e geração de respostas

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.

  • Alterne para recuperar partes 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 ( ).

  • Para copiar toda a saída na janela de chat, selecione o ícone de cópia ( ).

API

Para consultar uma base de conhecimento e usar um modelo básico para gerar respostas com base nos resultados das fontes de dados, envie um RetrieveAndGeneratesolicitação com um endpoint de tempo de execução do Agents for Amazon Bedrock.

A RetrieveAndGenerateStreamAPIretorna dados em um formato de streaming e permite que você acesse as respostas geradas em partes sem esperar pelo resultado inteiro.

Os campos a seguir são obrigatórios:

Campo Descrição básica
input Contém um text campo para especificar a consulta.
retrieveAndGenerateConfiguração Contém um RetrieveAndGenerateConfiguration, 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 continuar essa sessão e manter o contexto dela para o modelo.
sessionConfiguration Para incluir uma KMS chave personalizada para criptografia da sessão.

Inclua o knowledgeBaseConfiguration campo no RetrieveAndGenerateConfiguration. Esse campo é mapeado para um KnowledgeBaseRetrieveAndGenerateConfigurationobjeto, que contém os seguintes campos:

  • Os campos a seguir são obrigatórios:

    Campo Descrição básica
    knowledgeBaseId O ID da base de conhecimento a ser consultada.
    modelArn O modelo básico ou perfil ARN de inferência a ser usado para geração.

  • Os seguintes campos são opcionais:

    Campo Caso de uso
    retrievalConfiguration Para incluir configurações de consulta para personalizar a pesquisa vetorial. Para obter mais informações, consulte KnowledgeBaseRetrievalConfiguration.
    orchestrationConfiguration Para especificar as configurações de como o modelo processa o prompt antes da recuperação e geração. Para obter mais informações, consulte GenerationConfiguration.
    generationConfiguration Para especificar configurações para geração de resposta. Para obter mais informações, consulte OrchestrationConfiguration.

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. KnowledgeBaseVectorSearchConfigurationKnowledgeBaseRetrievalConfiguration O rerankingConfiguration campo mapeia para um VectorSearchRerankingConfigurationobjeto, 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.

nota

Se o numberOfRerankedResults valor especificado for maior que o numberOfResults valor no KnowledgeBaseVectorSearchConfiguration, o número máximo de resultados que serão retornados será o valor paranumberOfResults. Uma exceção é se você usar a decomposição de consultas (para obter mais informações, consulte a seção Modificações de consulta emConfigurar e personalizar consultas e geração de respostas. Se você usar a decomposição de consultas, o numberOfRerankedResults pode ser até cinco vezes o. numberOfResults

A resposta retorna a resposta gerada no output campo e os fragmentos de origem citados como uma matriz no citations campo. Cada objeto Citation contém os seguintes campos.

Campo Descrição básica
generatedResponsePart No textResponsePart campo, está incluído text o campo ao qual a citação se refere. O span campo fornece os índices para o início e o fim da parte da saída que tem uma citação.
retrievedReferences Uma matriz de RetrievedReferenceobjetos, 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, os dados URI do conteúdo codificado em base64 serão retornados no seguinte formato:. data:image/jpeg;base64,${base64-encoded string}

A resposta também retorna um sessionId valor, que você pode reutilizar em outra solicitação para manter a mesma conversa.

Se você incluiu um guardrailConfiguration na solicitação, o guardrailAction campo informa se o conteúdo foi bloqueado ou não.

Se os dados recuperados contiverem imagens, a resposta também retornará os seguintes cabeçalhos de resposta, que contêm metadados para partes de origem retornadas na resposta:

  • x-amz-bedrock-kb-byte-content-source— Contém o Amazon S3 URI da imagem.

  • x-amz-bedrock-kb-description— Contém a string codificada em base64 para a imagem.

nota

Você não pode filtrar esses cabeçalhos de resposta de metadados ao configurar 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: