Executable AI Methods

domain = "hr_screening"
description = "Analyze a job offer to build a scorecard, batch process CVs"
main_pipe = "screen_candidates"

# ── Concepts ──────────────────────────────────────────────

[concept.Criterion]
description = "A single evaluation criterion for scoring candidates"

[concept.Criterion.structure]
name = {type = "text", required = true}
description = {type = "text", required = true}
weight = {type = "number", description = "Importance 1-10", required = true}

[concept.Scorecard]
description = "Evaluation scorecard built from a job offer"

[concept.Scorecard.structure]
job_title = {type = "text", required = true}
company = {type = "text"}
required_skills = {type = "list", item_type = "text"}
criteria = {type = "list", item_type = "concept", item_concept_ref = "hr_screening.Criterion"}

[concept.CvEvaluation]
description = "Complete evaluation of a candidate CV"

[concept.CvEvaluation.structure]
candidate_name = {type = "text", required = true}
overall_score = {type = "number", required = true}
fit = {type = "text", required = true, choices = ["yes", "no"]}
strengths = {type = "list", item_type = "text"}
weaknesses = {type = "list", item_type = "text"}

# ── Main Pipe ─────────────────────────────────────────────

[pipe.screen_candidates]
type = "PipeSequence"
inputs = {job_offer = "Document", cvs = "Document[]"}
output = "CvResult[]"
steps = [
    {pipe = "extract_job_offer", result = "job_pages"},
    {pipe = "build_scorecard", result = "scorecard"},
    {pipe = "evaluate_cv", batch_over = "cvs", result = "results"},
]

[pipe.build_scorecard]
type = "PipeLLM"
inputs = {job_pages = "Page[]"}
output = "Scorecard"
model = "$writing-factual"
prompt = """Analyze this job offer and build a scorecard..."""

[pipe.evaluate_cv]
type = "PipeSequence"
inputs = {cv = "Document", scorecard = "Scorecard"}
output = "CvResult"
steps = [
    {pipe = "extract_cv", result = "cv_pages"},
    {pipe = "score_cv", result = "evaluation"},
    {pipe = "route_by_fit", result = "cv_result"},
]

[pipe.score_cv]
type = "PipeLLM"
inputs = {cv_pages = "Page[]", scorecard = "Scorecard"}
output = "CvEvaluation"
prompt = """Score the candidate on EACH criterion..."""

# ── Conditional Routing ───────────────────────────────────

[pipe.route_by_fit]
type = "PipeCondition"
inputs = {evaluation = "CvEvaluation", scorecard = "Scorecard"}
output = "CvResult"
expression = "evaluation.fit"

[pipe.route_by_fit.outcomes]
yes = "handle_fit"
no = "handle_rejection"