UserSkillAnalyzer - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • . UserSkillAnalyzer A API fornece métodos para analisar as habilidades do usuário em relação às habilidades necessárias para concluir itens de trabalho.

    Esta API requer Gestão de habilidades plug-in (com.snc.skills_management), que você pode ativar se tiver a função de administrador.

    Consulte Qualifique e classifique usuários com base em habilidades e níveis de habilidade .

    UserSkillAnalyzer - UserSkillAnalyzer()

    Instancia um novo objeto UserSkillAnalyzer.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum 
    
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();

    UserSkillAnalyzer - analyzeUserByID(cadeia de caracteres requiredSkillsJson, cadeia de caracteres UserId, booliano isSkillLevelEnforced)

    Analisa as habilidades do usuário em relação às habilidades necessárias e define o número de habilidades correspondentes, a lacuna de nível de habilidade e a qualificação que podem ser coletadas de uma instância.

    Analisa se um agente está qualificado para trabalhar em uma tarefa verificando se o agente tem as habilidades e os níveis de habilidade necessários para concluir a tarefa. Se um agente estiver qualificado para trabalhar em uma tarefa, a API analisará a lacuna de nível entre as habilidades necessárias e o nível de habilidade do usuário, que pode ser usada pela aplicação para escolher o melhor agente com base na lacuna de nível. Ele também analisa o número total de habilidades com e sem níveis de habilidade que o agente tem para executar essa tarefa.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    RequiredSkillsJson Cadeia de caracteres Lista de habilidades necessárias para comparar com o usuário.
    Cada habilidade é listada como uma entrada JSON no seguinte formato:
    • Sys_id: Cadeia de caracteres. Sys ID da habilidade da tabela Habilidades [cmn_skill].
    • Is_mandatory: Booliano. Sinalizador que indica se a habilidade é obrigatória.
    • Nível: Cadeia de caracteres. Sys ID da tabela Níveis de habilidade [cmn_skill_level].
    userID Cadeia de caracteres Sys ID da tabela Usuário [sys_user].
    IsSkillLevelEnforçado Booliano Verdadeiro se o usuário precisar ter um nível mínimo de habilidade para todas as habilidades obrigatórias necessárias, caso contrário, falso. Padrão: Falso.
    Tabela 3. Retornos
    Tipo Descrição
    Cadeia de caracteres JSON que contém todas as informações necessárias sobre o usuário com base no mapa de habilidades do analisador da seguinte forma:
    • Sys_id: Cadeia de caracteres. Sys ID da tabela Usuário [sys_user].
    • Is_qualified: Booliano. Sinalizador que indica se o usuário está qualificado para as habilidades necessárias.
      • Verdadeiro se o usuário tiver todas as habilidades obrigatórias e o nível de habilidade for imposto.
      • Falso se o usuário não tiver todas as habilidades obrigatórias ou não atender aos requisitos de nível.
    • Num_skills: Número. Habilidades correspondentes às habilidades necessárias.
    • Num_skills_matching_level: Número. Habilidades do usuário correspondentes ao nível de habilidade necessário.
    • Total_skill_level_gap: Número. A lacuna de nível de habilidade ajuda o algoritmo de classificação a encontrar o usuário ideal que atende aos requisitos mínimos de nível de habilidade. Calculado com base na lacuna geral entre o nível de habilidade da tarefa e o nível de habilidade do usuário. O usuário deve ter o nível de habilidade necessário para habilidades obrigatórias.
    • Opcional_skill_level_gap: Número. Fornece lacuna de nível de habilidade somente para habilidades opcionais. Auxilia os endpoints na distinção entre o nível total de habilidade e a lacuna de nível de habilidade opcional.

    Erro se parâmetros imprecisos ou JSON malformado forem fornecidos.

    		 
    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
			  {"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSysID = "a8f98bb0eb32010045e1a5115206fe3a";
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
var result = userSkillAnalyzer.analyzeUserById(JSON.stringify(skills), userSysID, true);
gs.info('Results: ' + result);

    Saída:

    Calling user analyzer
*** Script: Results: {"sys_id":"a8f98bb0eb32010045e1a5115206fe3a","is_qualified":false,"num_skills":0,"num_skills_matching_level":0,"total_skill_level_gap":0,"optional_skill_level_gap":0}

    UserSkillAnalyzer - analyzeUserBySkills(cadeia de caracteres requiredSkillsJson, cadeia de caracteres userSkillsJson, boolian isSkillLevelEnforced)

    Analisa as habilidades do usuário em relação às habilidades necessárias e define o número de habilidades correspondentes, a lacuna de nível de habilidade e a qualificação que podem ser coletadas de uma instância.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    RequiredSkillsJson Cadeia de caracteres Lista de habilidades necessárias para qualificar os usuários.
    Cada habilidade é listada como uma entrada JSON no seguinte formato:
    • Sys_id: Cadeia de caracteres. Sys ID da habilidade da tabela Habilidades [cmn_skill].
    • Is_mandatory: Booliano. Sinalizador que indica se a habilidade é obrigatória.
    • Nível: Cadeia de caracteres. Sys ID da tabela Níveis de habilidade [cmn_skill_level].
    UserSkillsJson Cadeia de caracteres Lista de habilidades do usuário para determinar a qualificação das habilidades necessárias.
    Cada habilidade é listada como uma entrada JSON no seguinte formato:
    • Sys_id: Cadeia de caracteres. Sys ID da habilidade da tabela Habilidades [cmn_skill].
    • Is_mandatory: Booliano. Sinalizador que indica se a habilidade é obrigatória.
    • Nível: Cadeia de caracteres. Sys ID da tabela Níveis de habilidade [cmn_skill_level].
    IsSkillLevelEnforçado Booliano Verdadeiro se o usuário precisar ter um nível mínimo de habilidade para todas as habilidades obrigatórias necessárias, caso contrário, falso. Padrão: Falso.
    Tabela 5. Retornos
    Tipo Descrição
    Cadeia de caracteres JSON que contém todas as informações necessárias sobre o usuário com base no mapa de habilidades do analisador da seguinte forma:
    • Sys_id: Cadeia de caracteres. Sys ID da tabela Usuário [sys_user].
    • Is_qualified: Booliano. Sinalizador que indica se o usuário está qualificado para as habilidades necessárias.
      • Verdadeiro se o usuário tiver todas as habilidades obrigatórias e o nível de habilidade for imposto.
      • Falso se o usuário não tiver todas as habilidades obrigatórias ou não atender aos requisitos de nível.
    • Num_skills: Número. Habilidades correspondentes às habilidades necessárias.
    • Num_skills_matching_level: Número. Habilidades do usuário correspondentes ao nível de habilidade necessário.
    • Total_skill_level_gap: Número. A lacuna de nível de habilidade ajuda o algoritmo de classificação a encontrar o usuário ideal que atende aos requisitos mínimos de nível de habilidade. Calculado com base na lacuna geral entre o nível de habilidade da tarefa e o nível de habilidade do usuário. O usuário deve ter o nível de habilidade necessário para habilidades obrigatórias.
    • Opcional_skill_level_gap: Número. Fornece lacuna de nível de habilidade somente para habilidades opcionais. Auxilia os endpoints na distinção entre o nível total de habilidade e a lacuna de nível de habilidade opcional.

    Erro se parâmetros imprecisos ou JSON malformado forem fornecidos.

    		 
    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
				{"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSkills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
		    {"sys_id":"k, th", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
var result = userSkillAnalyzer.analyzeUserBySkills(JSON.stringify(skills), JSON.stringify(userSkills));
gs.info('Results: ' + result);