Configurar Estrutura de ação de grupo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Configure o GAF (Group Action Framework, Estrutura de ação de grupo) para melhorar a qualidade da resposta, a velocidade de cancelamento e a consistência dos agentes de IA.

    Antes de Iniciar

    Deve haver uma ACL de leitura ml_platform para que o GAF seja configurado. Se não houver ACL de leitura presente, você deverá criá-la e conceder o acesso à função apropriado, como admin, ml_admin ou sn_aia.admin. Isso é necessário para que o GAF acesse tabelas e serviços do aprendizado de máquina. Se sua ACL não estiver configurada corretamente, você poderá ver o erro "Falha ao inicializar pipeline: Falha ao carregar o conjunto de dados message_content. Não há colunas para analisar do arquivo."

    Para acessar o recurso Previsão otimizada do GAF, você pode habilitar Now Assist em Pesquisa com IA. Para obter mais informações, consulte Configure a Pesquisa com IA para Estrutura de ação de grupo .

    Função necessária: sn_aia.admin

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode ativar o GAF para que os agentes de IA usem clusters indexados que executam execuções de LLM em registros representativos em vez de todos os registros. O GAF é usado por alguns agentes de IA e fluxos de trabalho do agente para funcionar de forma ideal. Para obter mais informações sobre o GAF e como ele funciona, consulte Estrutura de ação de grupo .

    Você pode ter diferentes configurações do GAF para diferentes fluxos de trabalho do agente e. Now Assist aplicações. Cada fluxo de trabalho ou aplicação do agente deve ser configurado separadamente.

    Importante:
    A configuração do GAF pode levar algum tempo, entre 10 minutos a uma hora, dependendo do número de registros no agrupamento. O script é executado em segundo plano.

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Scripts - Segundo Plano.
    2. Cole o código a seguir na área de texto.

      Não execute o script até que as variáveis groupSkillID e actionSkillID tenham valores. Os valores são adquiridos nas etapas a seguir.

      var groupSkillId = ""; 
                              var actionSkillId = ""; 
                              var topicSkillId = "43bce9e477e012103f075cea5b5a998f"; 
                              new sn_gaf.GAFUtils().activate(groupSkillId, topicSkillId, actionSkillId, "run_once");

      O topicSkillId é o mesmo para todas as configurações do GAF.

    3. Em uma nova guia do navegador, navegue até Now Assist Configuração de habilidades [sn_nowassist_skill_config] inserindo sn_nowassist_skill_config.list no navegador de filtros.
    4. Em Nome campo, insira * agrupamento e pesquisam para ver os registros de agrupamento associados aos fluxos de trabalho do agente e. Now Assist aplicações.

      Now Assist Tabela Configuração de habilidades filtrada por *agrupando no campo Nome

    5. Abra o registro de agrupamento para o fluxo de trabalho do agente ou aplicação que você deseja configurar.
    6. Em Now Assist Conjunto de variáveis de configuração, abra o registro Entradas de agrupamento.
    7. Confirme se os filtros do agrupamento incluem todos os registros que você deseja indexar.
      Se você quiser adicionar filtros para mudar quais registros estão incluídos na configuração do GAF, faça isso aqui. Mais registros incluídos significa que você tem um tempo de configuração mais longo, mas eles podem ajudar a aumentar a qualidade dos resultados. Você deve ter pelo menos 2000 registros para um cluster bem-sucedido.
      Nota:
      Seu escopo atual deve ser Group-Action Framework para fazer mudanças.

      Now Assist Registro do conjunto de variáveis de configuração de habilidade com variáveis definidas como tabela Incidente, campo de descrição resumida e Estado do filtro encerrado

    8. Retorne ao Now Assist Registro de agrupamento de configuração de habilidades e copie o sys_id.
      Você usa este sys_id e dois outros sys_ids na chamada de função de script em segundo plano.
    9. Na guia do navegador com o script em segundo plano, cole o sys_id no script entre as aspas da variável groupSkillId.

      . GroupSkillId a variável deve estar no mesmo formato que TopicSkillId variável.

    10. Na guia com Now Assist Registro de configuração de habilidade, retorne para Now Assist Tabela de configuração de habilidade e pesquisa estratégia de ação para encontrar a configuração de habilidade de estratégia de ação para a aplicação.
      Certifique-se de que o registro seja para a mesma aplicação. Se você colou o sys_id do agrupamento GAF ITSM, deverá abrir a estratégia de ação GAF ITSM.
    11. Abra o registro de estratégia de ação da aplicação que você está configurando.
    12. Copie o sys_id do registro de estratégia de ação.
    13. Na guia do navegador com o script em segundo plano, cole o sys_id no script entre as aspas da variável actionSkillId.

      . ActionSkillId a variável deve estar no mesmo formato que GroupSkillId e. TopickillId variáveis.

      Script do GAF concluído com todos os três valores preenchidos

    14. Execute o script em segundo plano selecionando Executar script .

      Executar este script em segundo plano cria um trabalho agendado chamado GAF - Executar fluxo off-line. Você pode exibir o trabalho agendado na tabela Execuções de script programadas [sysauto_script]. Se você quiser executar o script imediatamente, abra o registro Execução de script programada e selecione Executar agora .

      O script é executado em segundo plano.

    Resultado

    O GAF está configurado em sua instância para isso Now Assist E podem ser usados por agentes de IA para encontrar registros relacionados.

    O que Fazer Depois

    Para verificar se as saídas de agrupamento e ação foram geradas, vá para a tabela Solução de ML [ml_solution] para verificar se a solução de cluster está em execução ou concluída. Se estiver concluído, verifique as tabelas a seguir para ver se os registros de grupos, registros em cluster e registros de amostra inferior por grupo estão presentes.

    • Grupo de registros do GAF [sn_gaf_record_group]
    • Detalhe do grupo de registros do GAF [sn_gaf_record_group_detail]
    • Resultado da estratégia de ação do GAF [sn_gaf_action_strategy_result]

    Você pode repetir este procedimento para fluxos de trabalho agentic adicionais e. Now Assist aplicações.

    Você pode ver o erro "Falha ao inicializar pipeline: Falha ao carregar o conjunto de dados message_content. Não há colunas para analisar do arquivo." Ao tentar configurar o GAF. Isso pode ocorrer porque sua instância não tem dados na tabela ou filtros que você configurou registros excluídos da tabela. Você pode entrar em contato com Now Support se você não conseguir resolver este erro, obtenha assistência adicional.