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á.
# Aumentar a geração de respostas do agente com a base de conhecimento
O Amazon Bedrock Knowledge Bases ajuda você a aproveitar as vantagens da geração aumentada via recuperação (RAG), uma técnica conhecida que envolve extrair informações de um datastore para aumentar as respostas geradas por grandes modelos de linguagem (LLMs). Quando você configura uma base de conhecimento com a fonte de dados e o armazenamento de vetores, a aplicação pode consultar a base de conhecimento para exibir informações e responder à consulta com citações diretas das fontes ou com respostas naturais geradas com base nos resultados da consulta.
Para usar o Amazon Bedrock Knowledge Bases com seu agente do Amazon Bedrock, você precisará primeiro criar uma base de conhecimento para associar ao agente. Se você ainda não tiver criado uma base de conhecimento, consulte [Recuperar dados e gerar respostas de IA com as Bases de Conhecimento do Amazon Bedrock](knowledge-base.md) para saber sobre bases de conhecimento e criar uma. É possível associar uma base de conhecimento durante ou depois da [criação do agente](agents-create.md). Para associar uma base de conhecimento a um agente existente, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como especificar uma 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 do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.
1. Escolha **Editar no Construtor de agentes**.
1. Na seção **Bases de conhecimento**, escolha **Adicionar**.
1. Escolha uma base de conhecimento criada e forneça instruções sobre como o agente deve interagir com ela.
1. Escolha **Adicionar**. Um banner de sucesso é exibido na parte superior.
1. Para aplicar as alterações feitas no agente antes de testá-lo, escolha **Preparar** antes do teste.
------
#### [ API ]
Para associar uma base de conhecimento a um agente, envie uma solicitação [AssociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_AssociateAgentKnowledgeBase.html) a um [endpoint de tempo de compilação do Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
A seguinte lista descreve os campos na solicitação:
+ 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/agents-kb-add.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/agents-kb-add.html)
------
É possível modificar as [configurações de consulta](kb-test-config.md) de uma base de conhecimento anexada ao agente usando o campo `sessionState` na solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) ao invocar o agente. Para obter mais informações, consulte [Controlar o contexto da sessão do agente](agents-session-state.md).
# Visualizar informações sobre uma base de conhecimento associada a um agente
Para saber como visualizar informações sobre uma base de conhecimento, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como visualizar informações sobre uma base de conhecimento associada a um agente**
1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.
1. Escolha **Editar no Construtor de agentes**.
1. Na seção **Bases de conhecimento**, selecione a base de conhecimento da qual você deseja visualizar as informações.
------
#### [ API ]
Para obter informações sobre uma base de conhecimento associada a um agente, envie uma solicitação [GetAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentKnowledgeBase.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique os seguintes campos:
Para listar informações sobre as bases de conhecimento associadas a um agente, envie uma solicitação [ListAgentKnowledgeBases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentKnowledgeBases.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique o `agentId` e a `agentVersion` para os quais você deseja ver as bases de conhecimento associadas.
****
| Campo | Descrição breve |
| --- | --- |
| maxResults | O número máximo de resultados a serem apresentados em uma resposta. |
| nextToken | Se houver mais resultados do que o número especificado no campo maxResults, a resposta exibirá um valor de nextToken. Para ver o próximo lote de resultados, envie o valor de nextToken em outra solicitação. |
[Consulte exemplos de código](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-agent_example_bedrock-agent_ListAgentKnowledgeBases_section.html)
------
# Modificar a associação entre um agente e uma base de conhecimento
Para associar modificar uma associação entre agente e base de conhecimento, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como modificar uma associação entre agente e 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 do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.
1. Escolha **Editar no Construtor de agentes**.
1. Na seção **Grupos de ação**, selecione um grupo de ação para edição. Em seguida, escolha **Editar**.
1. Edite os campos existentes conforme for necessário. Para obter mais informações, consulte [Aumentar a geração de respostas do agente com a base de conhecimento](agents-kb-add.md).
1. Para controlar se o agente pode usar a base de conhecimento, selecione **Habilitado** ou **Desabilitado**. Use essa função para ajudar a solucionar problemas de comportamento do agente.
1. Para permanecer na mesma janela para testar sua alteração, escolha **Salvar**. Para retornar à página **Rascunho de trabalho**, escolha **Salvar e sair**.
1. Para aplicar as alterações feitas no agente antes de testá-lo, escolha **Preparar** na janela **Teste** ou na parte superior da página **Rascunho de trabalho**.
------
#### [ API ]
Para modificar a configuração de uma base de conhecimento associada a um agente, envie uma solicitação [UpdateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentKnowledgeBase.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Como todos os campos serão substituídos, inclua os campos que deseja atualizar e aqueles que deseja manter iguais. É possível especificar o campo `agentVersion` como `DRAFT`. Para obter mais informações sobre parâmetros obrigatórios e opcionais, consulte [Aumentar a geração de respostas do agente com a base de conhecimento](agents-kb-add.md).
Para aplicar as alterações ao rascunho de trabalho, envie uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Inclua o `agentId` na solicitação. As alterações se aplicam à versão do `DRAFT` para a qual o alias do `TSTALIASID` aponta.
------
# Desassociar uma base de conhecimento de um agente
Para associar dissociar uma base de conhecimento de um agente, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como desassociar uma base de conhecimento de um agente**
1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.
1. Escolha **Editar no Construtor de agentes**.
1. Na seção **Bases de conhecimento**, escolha o botão opção ao lado da base de conhecimento que você deseja excluir. Escolha **Excluir**.
1. Confirme a mensagem exibida e escolha **Excluir**.
1. Para aplicar as alterações feitas no agente antes de testá-lo, escolha **Preparar** na janela **Teste** ou na parte superior da página **Rascunho de trabalho**.
------
#### [ API ]
Para desassociar uma base de conhecimento de um agente, envie uma solicitação [DisassociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DisassociateAgentKnowledgeBase.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique o `knowledgeBaseId` e o `agentId` e a `agentVersion` do agente do qual desassociar.
Para aplicar as alterações ao rascunho de trabalho, envie uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Inclua o `agentId` na solicitação. As alterações se aplicam à versão do `DRAFT` para a qual o alias do `TSTALIASID` aponta.
------