Crie um segmento manual

  • Versão de lançamento: Australia
  • Atualizado 10 de abr. de 2026
  • 3 min. de leitura

    • Os segmentos manuais são pesquisas salvas criadas pelo administrador com nomes amigáveis que unem perguntas de linguagem natural e filtros de banco de dados para a camada semântica de Geração de consulta.

    Antes de Iniciar

    Função necessária: sn_query_gen.admin ou superior

    Por Que e Quando Desempenhar Esta Tarefa

    Use segmentos manuais para enviar pesquisas salvas específicas do domínio com sua aplicação. Eles recebem um aumento de prioridade em relação aos segmentos automatizados durante a pesquisa. Este aumento está definido em sn_query_gen.segments.manual_segment_scale_factor. O LLM retém todos os seus filtros, a menos que irrelevantes, enquanto os filtros de segmento automatizados são criticados individualmente.

    Crie segmentos manuais nas seguintes circunstâncias:
    • Sua organização tem terminologia padrão que mapeia para filtros específicos (por exemplo, "Sev1", "Vip", "atrasado")
    • Os usuários fazem repetidamente a mesma pergunta filtrada e o sistema não seleciona automaticamente o filtro correto
    • Você deseja codificar a lógica de negócios que não pode ser inferida somente a partir de valores de campo (por exemplo, "contas em risco": Combinação de várias condições)
    • A terminologia especial da sua organização não foi traduzida com precisão para condições de filtro
    Dica:
    O nome e a descrição correspondem à pesquisa com IA. Use frases naturais que seus usuários diriam. Mantenha um segmento por conceito. Teste fazendo a pergunta e verificando se o segmento aparece nos logs.

    Ao criar nomes de segmento, use o mesmo idioma que um usuário usaria ao fazer uma pergunta. O nome é o campo primário com o qual o LLM corresponde durante a pesquisa semântica. Evite abreviações, códigos internos ou jargão técnico. Pense em como um usuário formularia a pergunta que este segmento responde.

    Diretrizes de nomenclatura

    Siga estas diretrizes ao criar nomes e descrições de segmento:

    Use linguagem simples
    Escreva nomes no mesmo idioma que os usuários usariam ao fazer perguntas. Evite abreviações técnicas ou códigos internos que os usuários não reconheceriam.
    Pense como seus usuários
    Considere como os usuários formulariam perguntas sobre esses dados. O nome do segmento deve corresponder aos padrões de linguagem natural.
    Seja específico, mas claro
    Os nomes devem ser descritivos o suficiente para distinguir de segmentos semelhantes, permanecendo compreensíveis para o seu público.
    Use descrições para contexto
    Quando os nomes de segmento puderem ser ambíguos, use o campo de descrição para fornecer contexto adicional usando termos comumente usados.

    Procedimento

    1. Navegar até Geração de consulta > Administração > Configuração de segmento manual.
    2. Pressione Novo .
    3. No formulário Configuração de segmento manual, preencha as seguintes informações.
      Tabela 1. Formulário de configuração de segmento manual
      Campo Descrição
      Nome da tabela A tabela (entidade) à qual o segmento se aplica. Deve ter uma entidade ativa na camada semântica. O sistema procura a tabela de entidade primeiro e, em seguida, o segmento dentro dessa tabela.
      Nome Nome amigável que descreve o segmento em linguagem simples que um usuário usaria ao fazer uma pergunta. Use o mesmo idioma que um usuário usaria ao fazer uma pergunta. Evite abreviações, códigos internos ou jargão técnico. Máximo de 255 caracteres. Exemplos: "Incidentes críticos em aberto" (bom) em vez de "p1_OPEN_inc" (ruim), "Casos de RH de benefícios ativos" (bom) em vez de "Casos de RH - Ativo, Cat: Benefícios" (ruim).
      Descrição Opcional, mas altamente recomendado. Fornece ao LLM contexto adicional para decidir se um segmento é relevante. Use termos comumente usados e explique o que o segmento captura. Ajuda a diferenciar segmentos semelhantes. Máximo de 4 000 caracteres. Exemplo: "Incidentes de alta prioridade que estão abertos e não resolvidos no momento. Inclui todos os grupos de atribuição. Útil para painéis executivos e relatórios de escalação." (Bom) em vez de "Filtros para prioridade 1". (ruim).
      Filtro Consulta codificada que define as condições de filtro do segmento. Usa o construtor de condições (v2). Máximo de 4 000 caracteres, embora filtros com mais de 2 000 caracteres possam ser truncados no prompt do LLM.
      Ativo Se o sistema usa o segmento. O padrão é Selecionado. Quando desmarcado, o segmento é desativado e excluído da pesquisa.
    4. Pressione Enviar .
      Uma regra de negócio é acionada de forma assíncrona e sincroniza o registro no sn_query_gen_segment tabela, que é consultada no momento da pesquisa.

    Resultado

    O segmento manual está ativo e disponível para Geração de consultas pesquisas.

    Segmentos manuais para a tabela de incidentes

    Os exemplos a seguir mostram segmentos manuais bem criados para o. incidente tabela:

    Tabela 2. Segmentos manuais de exemplo
    Nome Descrição Tabela Filtro
    Incidentes críticos em aberto Incidentes de alta prioridade que estão abertos e não resolvidos no momento. Inclui todos os grupos de atribuição. incidente 1 estado! 7 estado! 8
    Incidentes atrasados da minha equipe Incidentes atribuídos ao grupo do usuário atual que passaram pela data de vencimento do ANS. incidente javascript:getMyGroups() sla_due() javascript:gs.nowDateTime()^state!=7
    Escalações P1 e P2 recentes Incidentes de prioridade 1 e 2 escalados nos últimos 7 dias. incidente 2 escalação 1 sys_updated_on> javascript:gs.daysAgoStart(7)