Configuração de várias bases de conhecimento e segmentação de conteúdo - Amazon Connect
Como configurar seu agente de orquestração para consultar várias bases de conhecimentoSegmentação de conteúdo

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.

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

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

  3. Associe a base de conhecimento existente à Ferramenta de Recuperação. O agente de IA usará essa base de conhecimento como padrão

    Escolha da associação assistente para a ferramenta de recuperação.

  4. Adicione uma ferramenta adicional, escolha Amazon Connect como namespace e escolha Recuperar o tipo de ferramenta de IA

    Selecionar a ferramenta de recuperação.

  5. Agora, selecione a base de conhecimento adicional que você deseja associar além da base de conhecimento padrão

    Escolha da associação assistente para a ferramenta de recuperação.

  6. Nomeie cada ferramenta de recuperação adicional começando com “Recuperar” (por exemplo, Recuperar2, Recuperar3,,). RetrieveProducts RetrievePolicies

    Nomeando a ferramenta de recuperação

  7. 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 seletivamente as bases de conhecimento.

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

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

    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

  2. Clique no botão Criar e você será direcionado para uma página na qual poderá modificar o prompt.

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

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

    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

  2. Clique no botão Criar e você será direcionado para uma página na qual poderá modificar o prompt.

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

Marcar 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 Amazon Connect. Essa API permite que você adicione 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.

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.

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

    • 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

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

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.

Para outros tipos de fonte de dados, consulte Transformação personalizada durante a ingestão 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.