UserSkillAnalyzer - Global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • A API UserSkillAnalyzer 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 o plug-in Gestão de habilidades (com.snc.skills_management), que você pode ativar se tiver a função de administrador.

    Consulte Como qualificar e classificar 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 - analiseUserByID (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, lacuna de nível de habilidade e 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 usado 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].
    isSkillLevelEnforced 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 as habilidades obrigatórias.
    • opcional_skill_level_gap: número. Fornece lacuna de nível de habilidade somente para habilidades opcionais. Auxilia os endpoints a distinguir entre o nível de habilidade total e a lacuna de nível de habilidade opcional.

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

    		 
    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 - analiseUserBySkills (cadeia de caracteres "needSkillsJson", cadeia de caracteres "userSkillsJson", booliano isSkillLevelEnforced)

    Analisa as habilidades do usuário em relação às habilidades necessárias e define o número de habilidades correspondentes, lacuna de nível de habilidade e 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].
    isSkillLevelEnforced Booliano Verdadeiro se o usuário precisar ter o 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 as habilidades obrigatórias.
    • opcional_skill_level_gap: número. Fornece lacuna de nível de habilidade somente para habilidades opcionais. Auxilia os endpoints a distinguir entre o nível de habilidade total e a lacuna de nível de habilidade opcional.

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

    		 
    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);