This endpoint parses unstructured text, evaluates that text, and produces a detailed competencies profile, with work activities arranged in a hierarchical tree where relevancy scores are contextualized to branches of the tree.

Explanation

Profiler's response JSON includes a variety of arrays, each containing information Profiler has derived from the provided text. The analysis includes:

  • Occupations (ranked and ordered)
  • General Work Activities (as a hierarchy, ranked and ordered)
    • Intermediate Work Activities
      • Detailed Work Activities
  • Workplace Basics (ranked and ordered)
  • Knowledges (ranked and ordered)
  • Skills (ranked and ordered)
  • Abilities (ranked and ordered)
  • Tools and Technologies (ranked and ordered)

Note that the work activities are presented as a hierarchy of nested arrays, each containing many hashes. This is because General, Intermediate, and Detailed work activities are associated in a hierarchical structure and the analysis is intended to preserve those valuable relationships. Developers can, of course, extract information from this structure and aggregate, roll-up, re-sort, etc. as they see fit for use in their own application.

Analysis Elements

Profiler's response JSON includes several elements:

Metadata

Notes some basic metadata about this specific analysis...

"metadata": {
  "text_size": 12345,
  "state_code": "TX",
  "parse_time": 0.243965
}

Occupations

O*NET Standard Occupational Classification codes, titles, and relevancy scores.

"occupations": [
  {
    "code": "51-4121",
    "title": "Welders, Cutters, Solderers, and Brazers",
    "score": 63.12
  },
  {
    "code": "51-4122",
    "title": "Welding, Soldering, and Brazing Machine Setters, Operators, and Tenders",
    "score": 36.88
  }
]

Work Activities Tree

A work activity describes how major units of time are organized on the job. Every statement theoretically has distinctive starting and ending points. Each is observable and produces results susceptible to being measured. Each array includes a General high-level statement, more specific Intermediate statement and, finally, the Detailed Work Activity. Each Detailed Work Activity includes an action verb (required), object (required), and contextual modifiers.

"general_work_activities": [
  {
    "score": 36.35,
    "title": "Handling and Moving Objects",
    "intermediate_work_activities": [
      {
        "score": 49.57,
        "title": "Assemble equipment or components.",
        "detailed_work_activities": [
          {
            "score": 43.64,
            "title": "Construct patterns or templates for welding projects"
          },
          {
            "score": 37.22,
            "title": "Adjust equipment or instruments to specification"
          },
          ...
        ]
      },
      ...
    ]
  },
  ...
]

Workplace Essentials

Workplace Essentials (aka “soft skills”) are specific behaviors and characteristics that demonstrate general strengths in areas such as teamwork, attention to detail, communication and customer service. SkillsEngine uses 30 statements to describe the most important social and behavioral characteristics.

"workplace_essentials": [
  [ "Attention to Detail", 93.74 ],
  [ "Work Ethic", 28.68 ],
  [ "Information Gathering", 10.06 ],
  [ "Following Directions", 8.29 ],
  ...
]

Knowledges, Skills, and Abilities

Knowledges, Skills and Abilities can be assigned both to people and to jobs making them valuable indicators in the job matching process. Knowledges are principles, bodies of content and facts generally applied within academic domains. A Skill is a developed capacity like time management or information gathering that facilitates performance of various tasks and activities across occupations or the rapid acquisition of relevant knowledge. An Ability is an attribute of an individual that can influence performance on the job.

"knowledges": [
  [ "Mechanical", 92.01 ],
  [ "Production and Processing", 32.67 ],
  [ "Building and Construction", 15.87 ],
  ...
]
"skills": [
  [ "Operation and Control", 63.38 ],
  [ "Equipment Selection", 44.57 ],
  [ "Reading Comprehension", 39.63 ],
  ...
]
"abilities": [
  [ "Manual Dexterity", 93.06 ],
  [ "Deductive Reasoning", 18.82 ],
  [ "Information Ordering", 17.77 ],
  ...
]

Tools and Technologies (experimental)

🚧

Tools and Technologies output is currently considered an experimental feature and is only intended for use in early stage development and prototyping.

"tools_techs": [
  {
    "score": 89.08,
    "type": "Tools",
    "title": "Speed sensors",
    "example": "Wire feed rate measurement instruments"
  },
  {
    "score": 59.39,
    "type": "Tools",
    "title": "Desktop computers",
    "example": "Desktop computers"
  },
  {
    "score": 29.69,
    "type": "Technology",
    "title": "Analytical or scientific software",
    "example": "Scientific Software Group Filter Drain FD"
  },
  ...
]

Relevancy Scores

Our scoring mechanisms are based on a number of factors, including result frequencies and proprietary weights. The intent is to provide the consumer of the data with a simple way to sort and compare general relevance of a particular element with other elements of the same type. Within a group of elements of the same type, higher scores indicate greater relevance of that element to the overall analysis than lower scores.

📘

Scores are relative only to elements of the same type (General Work Activity scores have no relevance to Detailed Work Activity scores, for example)

Language
Click Try It! to start a request and see the response here!