LiyaEngine

hiring is a fully built-out sample domain available for testing and learning. It is not the production domain LiyaEngine expects tenants to use for their own products. For production, create your own domains, intents, agents, workflows, and knowledge base from the dashboard or API.

The sample defines 17 intents covering the full talent lifecycle — from job description analysis and candidate screening to career coaching and interview preparation. The same patterns apply to any domain you build yourself; see Building a custom domain to create your own.

Call any intent with: POST /v1/run ({ "domain": "hiring", "intent": "...", "input": {...} }), or the equivalent path form POST /v1/hiring/{intent}.

Intents

Recruiter intents

Intent	Endpoint	Required inputs
resume-analysis	`/v1/hiring/resume-analysis`	`resume`
job-fit-analysis	`/v1/hiring/job-fit-analysis`	`resume`, `job_description`
candidate-prescreen	`/v1/hiring/candidate-prescreen`	`profile`, `job_description`
candidate-scoring	`/v1/hiring/candidate-scoring`	`profile`, `job_description`
`jd-analysis`	`/v1/hiring/jd-analysis`	`job_description`
`knockout-question-generation`	`/v1/hiring/knockout-question-generation`	`job_description`
`interview-question-generation`	`/v1/hiring/interview-question-generation`	`profile`, `job_description`

Candidate intents

Intent	Endpoint	Required inputs
resume-improvement	`/v1/hiring/resume-improvement`	`profile`
`cover-letter-generation`	`/v1/hiring/cover-letter-generation`	`profile`, `job_description`
`intro-script-generation`	`/v1/hiring/intro-script-generation`	`profile`, `job_description`
career-assessment	`/v1/hiring/career-assessment`	`profile`
skill-gap-analysis	`/v1/hiring/skill-gap-analysis`	`profile`
career-path-planning	`/v1/hiring/career-path-planning`	`profile`
career-transition-planning	`/v1/hiring/career-transition-planning`	`profile`, `career_goals`
mock-interview	`/v1/hiring/mock-interview`	`profile`
coaching-session	`/v1/hiring/coaching-session`	—
general-chat	`/v1/hiring/general-chat`	—

Request structure

All hiring intents share the same top-level request envelope:

{
  "input": {
    "user_id": "usr_123",           // required — your platform's user ID
    "message": "...",               // optional free-text message / question
    "resume": { ... },              // ResumeInput — see below
    "profile": { ... },             // ProfileInput
    "job_description": { ... },     // JobDescriptionInput
    "career_goals": { ... },        // CareerGoalsInput
    "interview_context": { ... }    // InterviewContextInput
  },
  "session_id": "ses_abc",          // optional — continue an existing session
  "preferences": {                  // optional request options
    "language": "en",
    "include_confidence": true,
    "include_reasoning": false,
    "max_tokens": 4000
  }
}

Common input schemas

ResumeInput

{
  "text": "John Smith\nSoftware Engineer...",   // required, min 100 chars
  "contact_section": "...",                      // optional parsed sections
  "experience_section": "...",
  "education_section": "...",
  "skills_section": "...",
  "file_type": "pdf",                            // "pdf" | "docx" | "txt" | "html"
  "original_filename": "john_smith_resume.pdf"
}

ProfileInput

{
  "name": "Jane Doe",
  "title": "Senior Software Engineer",
  "years_of_experience": 8,
  "experience_level": "senior",                  // "entry" | "mid" | "senior" | "lead" | "executive"
  "skills": ["TypeScript", "React", "Node.js"],
  "work_experiences": [
    {
      "title": "Senior Engineer",
      "company": "Acme Corp",
      "start_date": "2020-01-01",
      "end_date": null,                          // null = current role
      "achievements": ["Led migration to microservices, reducing latency by 40%"]
    }
  ],
  "educations": [
    {
      "degree": "BSc",
      "field": "Computer Science",
      "institution": "MIT",
      "graduation_year": 2016
    }
  ]
}

JobDescriptionInput

{
  "title": "Staff Engineer",
  "description": "We are looking for...",        // required, min 50 chars
  "company_name": "Stripe",
  "required_skills": ["Go", "Kubernetes"],
  "required_experience_years": 7,
  "work_arrangement": "hybrid",                  // "remote" | "hybrid" | "onsite"
  "employment_type": "full_time"
}

CareerGoalsInput

{
  "target_role": "Engineering Manager",
  "timeline": "1_year",    // "immediate" | "3_months" | "6_months" | "1_year" | "2_years" | "exploratory"
  "remote_preference": "hybrid_ok",
  "priorities": ["growth", "leadership"]         // "compensation" | "growth" | "work_life_balance" | "learning" | "impact" | "leadership" | "stability" | "flexibility"
}

Response structure

{
  "success": true,
  "data": {
    "output": { ... },              // intent-specific structured output
    "session_id": "ses_abc",
    "message_id": "msg_xyz"
  },
  "metadata": {
    "intent": "resume_analysis",
    "domain": "hiring",
    "model_used": "gpt-4o-mini",
    "tokens_used": 1240,
    "cost_usd": 0.00062,
    "latency_ms": 820,
    "cached": false
  },
  "usage": {
    "requests_remaining": 847,      // null if unlimited
    "tokens_remaining": 998760
  }
}

Knowledge sources

Upload documents to enrich hiring intelligence with your own data:

Source type	Namespace	Use case
Resume	`hiring:resume`	Candidate profiles for retrieval
Job Description	`hiring:job_description`	JD library for fit scoring
Policy	`hiring:policy`	Hiring policies and compliance rules
Profile	`hiring:profile`	Structured candidate profiles
Session Summary	`hiring:session_summary`	AI-generated session memory

Example Domain Walkthrough