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á.
# Configuração de várias bases de conhecimento e segmentação de conteúdo
Ao usar agentes de IA de orquestração, você pode configurar ferramentas de recuperação que permitem que seu agente de IA pesquise bases de conhecimento e retorne informações relevantes para responder às perguntas dos usuários.
Cada ferramenta Retrieve consulta uma única base de conhecimento. Ao configurar várias ferramentas de recuperação, você permite que seu agente de IA consulte várias bases de conhecimento simultaneamente ou selecione de forma inteligente qual delas pesquisar com base na pergunta do usuário. Descrições de ferramentas bem definidas e instruções rápidas permitem que o modelo encaminhe automaticamente as consultas para a base de conhecimento mais relevante.
Você pode controlar como seu agente de IA consulta o conteúdo em dois níveis:
+ **Nível da base de conhecimento:** configure várias ferramentas de recuperação para consultar diferentes bases de conhecimento. Use essa abordagem quando seu conteúdo estiver organizado em várias bases de conhecimento.
+ **Nível de conteúdo:** use a segmentação de conteúdo para consultar somente conteúdo específico em uma única base de conhecimento.
**Topics**
+ [Como configurar seu agente de orquestração para consultar várias bases de conhecimento](#w2aac28c54c13)
+ [Segmentação de conteúdo](#w2aac28c54c15)
## Como configurar seu agente de orquestração para consultar várias bases de conhecimento
Você pode configurar várias ferramentas de recuperação para consultar diferentes bases de conhecimento. Dependendo do seu caso de uso, você pode:
+ Consulte todas as bases de conhecimento simultaneamente (invocação paralela)
+ Consulte bases de conhecimento específicas com base no contexto da solicitação (invocação condicional)
### Configurando várias ferramentas de recuperação
Ambas as configurações exigem a mesma configuração inicial. Conclua essas etapas primeiro e, em seguida, siga as instruções para seu caso de uso específico.
1. No console da AWS, você pode adicionar outras bases de conhecimento escolhendo Adicionar integração e seguindo a experiência guiada. Neste exemplo, adicionamos demo-byobkb como base de conhecimento adicional.
![\[Várias integrações mostradas na página de domínio dos agentes de IA\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-showing-multi-kbs-in-domain-page.png)
1. No AI Agent Designer, crie um novo agente de IA de orquestração e edite a ferramenta de recuperação padrão
![\[Página do criador de agentes de IA\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-ai-agent-builder.png)
1. Associe a base de conhecimento existente à Ferramenta de Recuperação. O agente de IA usará essa base de conhecimento como padrão
![\[Escolher a associação assistente para a ferramenta de recuperação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-picking-assistant-association-in-retrieve-tool.png)
1. Adicione uma ferramenta adicional, escolha Amazon Connect como namespace e escolha Recuperar o tipo de ferramenta de IA
![\[Selecionar a ferramenta de recuperação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-choosing-retrieve-tool.png)
1. Agora, selecione a base de conhecimento adicional que você deseja associar além da base de conhecimento padrão
![\[Escolher a associação assistente para a ferramenta de recuperação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-picking-assistant-association-in-retrieve-tool2.png)
1. Nomeie cada ferramenta de recuperação adicional começando com “Recuperar” (por exemplo, Recuperar2, Recuperar3,,). RetrieveProducts RetrievePolicies
![\[Nomeando a ferramenta de recuperação\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-naming-the-retrieve-tool.png)
1. Em seguida, configure as instruções e os exemplos da ferramenta. A configuração varia de acordo com seu caso de uso. As seções a seguir abrangem dois cenários: consultar todas as bases de conhecimento simultaneamente e consultar bases de conhecimento seletivamente.
### Consultando todas as bases de conhecimento simultaneamente
Use essa configuração quando quiser que o agente pesquise todas as bases de conhecimento simultaneamente para cada consulta.
#### Configurando as instruções da ferramenta
1. Preencha as instruções da ferramenta copiando as instruções e os exemplos da ferramenta Retrieve padrão.
![\[Recupere as instruções da ferramenta\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-retrieve-tool-instructions.png)
1. Clique no botão Adicionar para criar a nova ferramenta Recuperar. Sua lista de ferramentas agora deve ter a nova ferramenta Retrieve.
![\[Lista de ferramentas contendo várias ferramentas de recuperação\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-multiple-retrieve-tools-list.png)
Agora você tem uma segunda ferramenta de recuperação. Para usar todas as ferramentas de Recuperação em conjunto, você deve modificar a solicitação com instruções para invocá-las simultaneamente. Sem essa alteração, somente uma ferramenta de Recuperação será usada.
#### Atualizando seu prompt para invocação paralela
1. Modifique o prompt para instruí-lo a usar várias ferramentas de recuperação. Os prompts de orquestração padrão não podem ser editados diretamente, então você precisará criar uma cópia com suas alterações.
Crie um novo prompt copiando o prompt de orquestração padrão que corresponde ao seu caso de uso. Neste exemplo, copiamos do AgentAssistanceOrchestration prompt.
![\[Criação de uma nova tela AI Prompt\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-creating-new-prompt.png)
1. Clique no **botão Criar** e você será direcionado para uma página na qual poderá modificar o prompt.
1. Modifique seu prompt com base no seu tipo de orquestração:
+
**Para solicitações de orquestração do Agent Assistance:**
Localize a seção de regras numeradas em seu prompt de orquestração. Esta seção começa com uma linha semelhante a:
`Your goal is to resolve the customer's issue while also being responsive. While responding, follow these important rules:`
Adicione o seguinte como a última regra numerada nesta seção:
`CRITICAL - Multiple Retrieve Tools: When multiple Retrieve-type tools are available ([Retrieve], [Retrieve2]), you MUST invoke ALL of them simultaneously for any search request. Never use only one Retrieve tool when multiple are available-always select and invoke them together to ensure comprehensive results from all knowledge sources.`
+
**Para solicitações de orquestração de autoatendimento:**
Encontre a seção `core_behavior`. Adicione a seguinte regra nessa seção:
`CRITICAL - Multiple Retrieve Tools: When multiple Retrieve-type tools are available ([Retrieve], [Retrieve2]), you MUST invoke ALL of them simultaneously for any search request. Never use only one Retrieve tool when multiple are available—always invoke them together to ensure comprehensive results from all knowledge sources.`
**nota**
Substitua os espaços reservados entre colchetes pelos nomes reais de suas ferramentas.
### Consultando bases de conhecimento seletivamente
Use essa configuração quando quiser que o agente selecione a base de conhecimento apropriada com base no tipo de pergunta ou contexto.
#### Configurando as instruções da ferramenta para cada base de conhecimento
Diferentemente da invocação paralela, cada ferramenta Retrieve precisa de instruções distintas que descrevam quando ela deve ser usada. Isso inclui a ferramenta de Recuperação padrão — você deve atualizar suas instruções para diferenciá-la das ferramentas de Recuperação adicionais. Use nomes descritivos que reflitam o conteúdo de cada base de conhecimento (por exemplo, RetrieveProducts, RetrievePolicies) para ajudar o modelo a selecionar a ferramenta correta.
1. Para cada ferramenta de recuperação, incluindo a padrão, escreva instruções específicas que descrevam o conteúdo da base de conhecimento associada e quando usá-la.
![\[Recupere as instruções da ferramenta\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-retrieve-tool-instructions.png)
1. Clique no botão Adicionar para criar a nova ferramenta Recuperar. Sua lista de ferramentas agora deve ter a nova ferramenta Retrieve.
![\[Lista de ferramentas contendo várias ferramentas de recuperação\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-multiple-retrieve-tools-list.png)
Agora você tem uma segunda ferramenta de recuperação. Para que o agente selecione a ferramenta apropriada com base no contexto, você deve modificar o prompt com instruções sobre quando usar cada ferramenta.
#### Atualizando sua solicitação de invocação condicional
1. Modifique o prompt para instruí-lo a escolher a ferramenta de recuperação apropriada com base no contexto. Os prompts de orquestração padrão não podem ser editados diretamente, então você precisará criar uma cópia com suas alterações.
Crie um novo prompt copiando o prompt de orquestração padrão que corresponde ao seu caso de uso. Neste exemplo, copiamos do AgentAssistanceOrchestration prompt.
![\[Criação de uma nova tela AI Prompt\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-creating-new-prompt.png)
1. Clique no **botão Criar** e você será direcionado para uma página na qual poderá modificar o prompt.
1. Modifique seu prompt com base no seu tipo de orquestração:
+
**Para solicitações de orquestração do Agent Assistance:**
Localize a seção de regras numeradas em seu prompt de orquestração. Esta seção começa com uma linha semelhante a:
`Your goal is to resolve the customer's issue while also being responsive. While responding, follow these important rules:`
Adicione o seguinte como a última regra numerada nesta seção:
`CRITICAL - Retrieve Tool Selection: You have multiple Retrieve tools. Each queries a different knowledge base. You MUST select only ONE tool per question based on the topic. - [Retrieve] contains [description]. - [Retrieve2] contains [description]. Evaluate the question, match it to the most relevant tool, and invoke only that tool.`
+
**Para solicitações de orquestração de autoatendimento:**
Encontre a seção `core_behavior`. Adicione a seguinte regra nessa seção:
`CRITICAL - Retrieve Tool Selection: You have multiple Retrieve tools. Each queries a different knowledge base. You MUST select only ONE tool per question based on the topic. - [Retrieve] contains [description]. - [Retrieve2] contains [description]. Evaluate the question, match it to the most relevant tool, and invoke only that tool.`
**nota**
Substitua os espaços reservados entre colchetes pelos nomes, descrições e exemplos de perguntas reais de suas ferramentas.
**Melhores práticas para seleção precisa de ferramentas**
A capacidade do modelo de selecionar a ferramenta de recuperação correta depende de vários fatores: nome da ferramenta, descrição da ferramenta, exemplos de ferramentas e instruções imediatas. Siga estas diretrizes:
**Use nomes descritivos de ferramentas: nomes** como RetrieveProducts ou RetrievePolicies ajudam o modelo a entender a finalidade de cada ferramenta.
**Seja específico nas descrições:** evite descrições vagas, como “informações gerais”. Liste os tópicos específicos, os tipos de documentos ou as categorias de perguntas que cada base de conhecimento trata.
**Adicione exemplos de perguntas:** inclua exemplos de perguntas nas instruções da ferramenta para ajudar o modelo a entender os casos de uso pretendidos.
**Evite sobreposições:** garanta que nomes, descrições e exemplos de ferramentas sejam mutuamente exclusivos. A sobreposição de conteúdo pode fazer com que o modelo escolha de forma inconsistente.
**Combine a terminologia com o idioma do usuário:** use as mesmas palavras e frases que seus usuários normalmente usam, não apenas terminologia interna ou técnica.
Seu caso de uso pode exigir modificações imediatas adicionais além dos exemplos fornecidos aqui.
## Segmentação de conteúdo
A segmentação de conteúdo permite que você marque o conteúdo da sua base de conhecimento e filtre os resultados de recuperação com base nessas tags. Quando sua ferramenta LLM consulta a base de conhecimento, ela pode especificar tags para recuperar somente o conteúdo correspondente a essas tags, permitindo respostas direcionadas de subconjuntos de conteúdo específicos.
**nota**
A segmentação de conteúdo não está disponível com o tipo de fonte de dados do Web crawler.
### Marcação de conteúdo por tipo de fonte de dados
O processo de marcação do conteúdo varia de acordo com o tipo de fonte de dados.
#### S3, Salesforce SharePoint, Zendesk e ServiceNow
Depois de criar sua base de conhecimento, você pode aplicar tags a itens de conteúdo individuais para segmentação. As tags são aplicadas no nível do conteúdo, o que significa que cada parte do conteúdo deve ser marcada individualmente.
Para marcar conteúdo, use a [TagResource API](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_TagResource.html) Amazon Connect. Essa API permite adicionar tags programaticamente ao conteúdo da base de conhecimento, que podem ser usadas para filtragem de segmentação de conteúdo durante a recuperação.
Para exemplos de marcação de conteúdo, consulte o workshop sobre [segmentação de conteúdo](https://catalog.workshops.aws/amazon-q-in-connect/en-US/01-foundation/07-content-segmentation).
##### Usando tags na ferramenta Recuperar
Depois que seu conteúdo for marcado, você poderá filtrar os resultados da recuperação especificando filtros de tag na configuração da ferramenta de recuperação.
1. Na configuração da ferramenta Recuperar, navegue até a seção Substituir valores de entrada.
1. Adicione pares de valores-chave para definir seu filtro de tags. Você precisa de duas substituições para filtrar por uma única tag. Neste exemplo, usamos `equals` como operador de filtro:
+ Defina a chave da propriedade `retrievalConfiguration.filter.equals.key` com o valor como o nome da tag (por exemplo,`number`).
![\[Configurando a substituição da chave de filtro\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-retrieve-tool-filter-key.png)
+ Defina a chave da propriedade `retrievalConfiguration.filter.equals.value` com o valor como valor da tag (por exemplo,`one`).
![\[Configurando a substituição do valor do filtro\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-retrieve-tool-filter-value.png)
Você pode usar qualquer configuração de filtro que comece com `retrievalConfiguration.filter` para definir seus critérios de filtragem de tags.
![\[Configuração concluída do filtro de tags\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-retrieve-tool-filter-complete.png)
#### Base de conhecimento do Bedrock
Para fontes de dados da base de conhecimento Bedrock, o conteúdo não é armazenado como recursos do Amazon Connect, portanto, a marcação por meio da TagResource API não está disponível. Em vez disso, você deve definir campos de metadados diretamente nas fontes de dados da base de conhecimento Bedrock.
Para fontes de dados do S3, consulte a seção Campos de metadados do documento no guia do usuário do conector de [fonte de dados Amazon Bedrock S3](https://docs.aws.amazon.com/bedrock/latest/userguide/s3-data-source-connector.html).
Para outros tipos de fonte de dados, consulte [Transformação personalizada durante a ingestão](https://docs.aws.amazon.com/bedrock/latest/userguide/kb-custom-transformation.html) na documentação do Amazon Bedrock.
##### Usando campos de metadados na ferramenta Recuperar
As bases de conhecimento Bedrock fornecem automaticamente campos de metadados integrados em todos os arquivos. Você pode usar esses campos para filtrar os resultados da recuperação na ferramenta Recuperar usando o mesmo método de configuração mostrado no exemplo acima.
Para recuperar resultados somente de uma fonte de dados específica em sua base de conhecimento do Bedrock, configure as substituições de filtro da seguinte forma:
+ `retrievalConfiguration.filter.equals.key` = `x-amz-bedrock-kb-data-source-id`
+ `retrievalConfiguration.filter.equals.value` = `[your-data-source-id]`
Isso filtra a ferramenta Recuperar para buscar somente os resultados dessa fonte de dados específica. Você também pode filtrar por campos de metadados personalizados que você definiu em suas fontes de dados do Bedrock usando a mesma configuração de substituição.