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

# Implantar a base de conhecimento para a aplicação de IA
<a name="knowledge-base-deploy"></a>

Para implantar uma base de conhecimento para a aplicação, configure-a para fazer solicitações [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) ou [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) à base de conhecimento. Para consultar como usar essas operações de API para consultar e gerar respostas, consulte [Testar a base de conhecimento com consultas e respostas](knowledge-base-test.md).

Você também pode associar a base de conhecimento a um agente, e o agente a invocará quando necessário durante a orquestração. Para obter mais informações, consulte [Automatizar tarefas em sua aplicação usando agentes de IA](agents.md).

Configure e sincronize uma ou mais fontes de dados com a base de conhecimento para poder implantá-las. Consulte [Fontes de dados compatíveis](https://docs.aws.amazon.com/bedrock/latest/userguide/data-source-connectors.html).

Escolha a guia correspondente ao método de sua preferência e siga as etapas:

------
#### [ Console ]

**Como associar uma base de conhecimento 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 **Agents**.

1. Escolha o agente ao qual deseja adicionar uma base de conhecimento.

1. Na seção **Rascunho de trabalho**, escolha **Rascunho de trabalho**.

1. Na seção **Bases de conhecimento**, selecione **Adicionar**.

1. Escolha uma base de conhecimento na lista suspensa em **Selecionar base de conhecimento** e especifique as instruções para o agente em relação à base de conhecimento.

**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 **Agents**.

1. Escolha o agente ao qual deseja adicionar uma base de conhecimento.

1. Na seção **Rascunho de trabalho**, escolha **Rascunho de trabalho**.

1. Na seção **Bases de conhecimento**, escolha uma base de conhecimento.

1. Selecione **Excluir**.

------
#### [ 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).
+ Inclua uma `description` detalhada para fornecer instruções sobre como o agente deve interagir com a base de conhecimento e exibir os resultados.
+ Defina `knowledgeBaseState` como `ENABLED` para permitir que o agente consulte a base de conhecimento.

É possível atualizar uma base de conhecimento associada a um agente enviando uma solicitação [UpdateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentKnowledgeBase.html). Por exemplo, talvez você queira definir `knowledgeBaseState` como `ENABLED` para solucionar um problema. Como todos os campos serão substituídos, inclua os campos que deseja atualizar e aqueles que deseja manter iguais.

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

------