Envio de segmentos manuais por meio de plug-ins
Os desenvolvedores de aplicações da unidade de negócios podem enviar segmentos manuais com suas aplicações para fornecer pesquisas salvas específicas do domínio que funcionam a partir do momento em que o app é instalado.
Visão geral do envio
Os segmentos manuais são a maneira recomendada de 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, e o LLM é instruído a reter todos os seus filtros, a menos que sejam completamente irrelevantes, enquanto os filtros de segmento automatizados são criticados individualmente.
O envio de segmentos manuais com seu plug-in garante que os usuários possam fazer perguntas de linguagem natural imediatamente sobre os dados da sua aplicação usando terminologia de negócios, sem esperar que segmentos automatizados sejam gerados a partir de padrões de uso.
Como enviar segmentos manuais
- Crie seus registros de configuração de segmento manuais em uma instância de desenvolvimento.
- Verifique se eles são sincronizados corretamente e produzem os resultados de pesquisa esperados.
- Incluir o. sn_query_gen_segment_table_config registros no conjunto de atualizações do app.
Comportamento de instalação do plug-in
Entender como os segmentos manuais se comportam durante a instalação do plug-in é importante para definir expectativas adequadas:
- As regras de negócio são ignorado durante a instalação do plug-in, a sincronização assíncrona não será acionada automaticamente no momento da instalação.
- Os registros serão sincronizados com sn_query_gen_segment da próxima vez Gerar camada semântica o trabalho agendado é executado (pós-instalação) ou quando semanalmente Sincronizar segmentos execuções de trabalho.
- Certifique-se de que seu plug-in não envie registros duplicados. Não há restrição exclusiva no nível do banco de dados. Os administradores devem garantir que não haja nomes duplicados por entidade.
Exemplo: Configuração completa de uma tabela
O exemplo a seguir mostra segmentos manuais para incidente Tabela que pode ser enviada com uma aplicação de ITSM:
Pré-requisito: . incidente a tabela deve ter um registro em sn_query_gen_table_config com enable_semantic_generation = truee uma entidade ativa.
| 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/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) |
Práticas recomendadas para segmentos de envio
- Foco em tabelas de alto valor e alto tráfego
- Concentre segmentos manuais nas tabelas que seus usuários mais perguntam. Alguns segmentos bem elaborados nas tabelas primárias do seu app terão mais impacto do que uma ampla cobertura em tabelas raramente consultadas.
- Use linguagem de negócios, não códigos técnicos
- Os nomes dos segmentos devem corresponder à forma como os usuários falam naturalmente sobre seu domínio. "Incidentes críticos em aberto" é melhor do que "p1_OPEN_inc".
- Forneça descrições para desambiguação
- Se você enviar vários segmentos para a mesma tabela, as descrições ajudarão o LLM a escolher o correto. Sem descrições, o LLM pode escolher arbitrariamente entre correspondências semelhantes.
- Teste antes do envio
- Verifique em um ambiente de teste se os segmentos são sincronizados corretamente e aparecem nos resultados da pesquisa para enunciados relevantes. Verifique os logs de consulta para confirmar o comportamento correspondente.
- Evite duplicar segmentos automatizados
- Antes de criar um segmento manual, verifique se um segmento automatizado já cobre o mesmo filtro. Se existir um nome, mas tiver um nome ruim, considere melhorar a fonte em vez de criar uma duplicata.
Check-list antes do envio
Verifique o seguinte antes de incluir segmentos manuais no plug-in:
- Cada tabela de destino tem uma entidade ativa na camada semântica ( sn_query_gen_table_config com enable_semantic_generation = true)
- Os nomes dos segmentos são escritos em linguagem simples do usuário, não em uma abreviação técnica
- As descrições são fornecidas para segmentos em que o nome sozinho pode ser ambíguo
- Os filtros são consultas codificadas válidas e com menos de 2 000 caracteres para inclusão ideal de prompt de LLM
- Não existem registros duplicados (mesmo nome e combinação de tabela) no seu conjunto de atualizações
- Todos sn_query_gen_segment_table_config os registros estão incluídos no conjunto de atualizações do app
- Você verificou em um ambiente de teste que os segmentos são sincronizados corretamente e aparecem nos resultados de pesquisa para enunciados relevantes
Monitoramento após a implantação
Após enviar segmentos manuais com sua aplicação:
- Monitore quais segmentos estão sendo correspondidos nos logs de consulta
- Verifique se as consultas geradas estão corretas para os casos de uso pretendidos
- Colete feedback do usuário sobre a precisão e a cobertura da consulta
- Itere nos nomes e descrições do segmento com base nos padrões de uso
Se um segmento estiver correspondente, mas produzindo resultados errados, o problema geralmente é o nome ser genérico demais ou o filtro ser muito amplo. Refine o nome e a descrição antes de ajustar as propriedades do sistema.