AI Transparency
Model Cards
Every AI model Syrka uses is documented here. We show what each model does, its limitations, and how we guard against bias.
/api/students/job-recommendationsdeepseek-chatRecommend 6 real job roles based on student skills, sector-agnostic
Inputs
- Student skills array
- Country
Outputs
- Job title
- Match %
- Salary range
- Search URLs
temp: 0.5max_tokens: 2000
Limitations: May hallucinate salary ranges in smaller markets. Does not verify employer existence.
Bias Controls: Sector-agnostic prompt — no national vision weighting. Pure skill-match scoring.
Human-in-Loop: None — recommendations shown directly to student.
Data Retention: Request/response metadata logged to ai_audit_log. No PII stored.
/api/students/evaluate-offerdeepseek-chat10-dimension weighted evaluation of a job offer
Inputs
- Job title
- Company
- Salary offered
- Student skills
- Country
Outputs
- Dimension scores
- Overall weighted score
- Grade
- Negotiation points
temp: 0.4max_tokens: 1500
Limitations: Salary benchmarks may lag behind real-time market. Company reputation scoring is approximate.
Bias Controls: Weighted scoring with transparent dimension weights shown to student.
Human-in-Loop: Student decides — evaluation is advisory only.
Data Retention: Overall score and grade logged. Full evaluation not persisted.
/api/students/generate-cv-briefdeepseek-chatGenerate tailored CV brief with headline, ATS keywords, and cover letter opening
Inputs
- Job title
- Company
- Description
- Student skills
- Country
Outputs
- Headline
- Skills to highlight/downplay
- ATS keywords
- Cover letter opening
temp: 0.5max_tokens: 1200
Limitations: Cover letter tone may not match all cultures. ATS keyword relevance is model-inferred.
Bias Controls: Vision alignment statement contextualised to student country.
Human-in-Loop: Student edits CV before submitting — brief is a starting point.
Data Retention: Headline logged for audit. Full brief not persisted.
/api/students/assess-ai-usagedeepseek-chatEvaluate student submissions for AI collaboration sophistication
Inputs
- Submission text (max 3000 chars)
- Assignment brief
- Student skills
Outputs
- 5 dimension scores
- Overall AI literacy score
- Grade
- Feedback
temp: 0.4max_tokens: 1500
Limitations: Cannot verify claimed AI usage. Assessment is inference-based from text patterns.
Bias Controls: Measures AI collaboration skill, NOT penalises AI use. Epistemic transparency is scored.
Human-in-Loop: Faculty reviews assessment before it affects grades.
Data Retention: Overall score and grade logged. Submission text not stored.
/api/students/adaptive-pathdeepseek-chatGenerate personalised 90-day learning path aligned with national vision
Inputs
- Skills
- Completed modules
- Time available
- Target role
- Country
Outputs
- Week ranges with actions
- Velocity assessment
- Bottleneck
- Shortcut
temp: 0.5max_tokens: 2000
Limitations: Resource links may be stale. Time estimates are approximate.
Bias Controls: Velocity assessment uses neutral ahead/on_track/behind framework.
Human-in-Loop: Student chooses whether to follow recommendations.
Data Retention: Velocity and bottleneck logged. Full path not persisted.
/api/students/outcomesdeepseek-chatGenerate learning signal from application outcome data
Inputs
- Job title
- Company
- Status
- Rejection details
- Skills gaps
Outputs
- Priority skill to learn
- Resource recommendation
- Trajectory adjustment
temp: 0.4max_tokens: 800
Limitations: Learning signal quality depends on student-reported rejection details.
Bias Controls: Focuses on actionable skill gaps, not employer blame.
Human-in-Loop: Student logs outcomes voluntarily.
Data Retention: Priority skill logged. Full signal stored with outcome.
/api/university/evolve-curriculumdeepseek-chatGenerate updated reading recommendations with provenance data
Inputs
- Course name
- Course code
- Description
Outputs
- 3 recommendations with sources
- Freshness score
- ESCO skill codes
temp: 0.6max_tokens: 1000
Limitations: Sources are model-generated — may contain hallucinated DOIs. Faculty verification required.
Bias Controls: Freshness scoring penalises stale sources. Provenance verification flag defaults to false.
Human-in-Loop: Faculty must approve before recommendations go live.
Data Retention: Full recommendations and sources stored in curriculum_evolution_log.
/api/students/orchestration-scorelocal-calculationCalculate AI orchestration readiness score from skills portfolio
Inputs
- Skills array
- AI assessment score
Outputs
- Weighted score
- Breakdown by 4 dimensions
- Level
- Next milestone
Limitations: Static skill lists may miss emerging AI tools. Score is formulaic, not adaptive.
Bias Controls: Transparent weight breakdown (30% AI skills, 25% breadth, 30% assessment, 15% vision).
Human-in-Loop: None — deterministic calculation.
Data Retention: Score and level logged to audit.