Skip to main content

Overview

Vega AI’s job matching system uses advanced AI to analyze the compatibility between your profile and job postings. The system provides a comprehensive match score (0-100%) along with detailed insights about your strengths, weaknesses, and key highlights.
Match analysis is performed using Google’s Gemini AI model, which analyzes your complete profile against the job requirements in under 30 seconds.

How It Works

1

Profile Analysis

The AI analyzes your complete profile including work experience, education, skills, certifications, and career summary.
2

Job Requirements Extraction

Job descriptions are parsed to identify required skills, qualifications, experience level, and key responsibilities.
3

Compatibility Scoring

A sophisticated algorithm compares your profile against job requirements and generates a 0-100% match score.
4

Detailed Insights

The AI provides specific strengths, areas for improvement, key highlights, and personalized feedback.

Match Score Categories

Vega AI categorizes match results into six tiers:

Excellent Match (90-100%)

Outstanding fit. Your profile strongly aligns with all major requirements. Apply with confidence.

Strong Match (80-89%)

Great fit. You meet most requirements with minor gaps. Strong candidate.

Good Match (70-79%)

Solid fit. You satisfy core requirements with some development areas.

Fair Match (60-69%)

Moderate fit. You have relevant experience but significant gaps exist.

Partial Match (50-59%)

Limited fit. Major skill or experience gaps present.

Poor Match (0-49%)

Weak fit. Profile doesn’t align with core requirements.
Jobs with match scores of 70% or higher are marked as “Matched” and highlighted in your dashboard for easy identification.

Analysis Components

Match Score

The primary metric (0-100%) indicating overall compatibility:
type MatchResult struct {
    MatchScore int      `json:"matchScore"`  // 0-100 percentage
    Strengths  []string `json:"strengths"`
    Weaknesses []string `json:"weaknesses"`
    Highlights []string `json:"highlights"`
    Feedback   string   `json:"feedback"`
}

Strengths

Positive aspects of your profile that align with the job:
  • Relevant work experience
  • Matching technical skills
  • Appropriate education level
  • Industry experience
  • Certifications that add value

Weaknesses

Areas where your profile may not fully meet requirements:
  • Missing skills or technologies
  • Experience level gaps
  • Industry transition challenges
  • Education requirements not met
  • Location or availability constraints

Highlights

Key standout points that make you competitive:
  • Unique qualifications
  • Exceptional achievements
  • Rare skill combinations
  • Leadership experience
  • Special projects or contributions

Feedback

Personalized narrative analysis providing:
  • Overall assessment summary
  • Application recommendations
  • Suggestions for improvement
  • Interview preparation tips
  • Areas to emphasize in your application

Running a Match Analysis

1

Complete Your Profile

Ensure your profile includes work experience, education, skills, and a career summary. Incomplete profiles receive an error message.
2

Navigate to Job Details

Open the job you want to analyze from your dashboard.
3

Click Analyze Job

Click the “Analyze Job Match” button on the job details page.
4

Wait for Analysis

The AI processes your profile and job description (typically 15-30 seconds).
5

Review Results

View your match score, strengths, weaknesses, highlights, and personalized feedback.
Match analysis requires a complete profile with at least a career summary, skills, and either work experience or education. You’ll receive a validation error if your profile is incomplete.

Match History

Vega AI maintains a complete history of all match analyses:

Why Track History?

Profile Evolution

See how your match scores improve as you update your profile with new skills and experience.

Compare Results

Compare different analysis runs to understand how profile changes affect compatibility.

Re-analysis

Run multiple analyses as your profile evolves without affecting your quota (re-analyses are free).

Historical Context

Review past analyses to track your job search journey.

Accessing Match History

From any job details page:
  1. Click “View Match History” in the AI analysis section
  2. See all previous analyses with timestamps
  3. Compare scores and insights across different profile versions
  4. Delete old analyses if needed
type MatchResult struct {
    ID         int       `json:"id"`
    UserID     int       `json:"user_id"`
    JobID      int       `json:"job_id"`
    MatchScore int       `json:"match_score"`
    Strengths  []string  `json:"strengths"`
    Weaknesses []string  `json:"weaknesses"`
    Highlights []string  `json:"highlights"`
    Feedback   string    `json:"feedback"`
    CreatedAt  time.Time `json:"created_at"`
}

Quota System

Match analysis operations are subject to quota limits in cloud mode:

Free Tier Quota

Monthly Quota

Cloud users receive a monthly quota for AI operations. The exact limit depends on your subscription tier.

Quota Rules

The first time you analyze a job, it counts against your monthly quota.
Re-analyzing a job you’ve already analyzed doesn’t count against your quota. Update your profile and re-analyze as many times as needed.
The job details page shows your current quota usage and remaining analyses.
Quotas reset at the beginning of each month.
type QuotaCheckResult struct {
    Allowed bool   `json:"allowed"`
    Reason  string `json:"reason"`
    Status  QuotaStatus `json:"status"`
}

type QuotaStatus struct {
    Used  int `json:"used"`
    Limit int `json:"limit"` // -1 for unlimited
}

Profile Requirements

For accurate match analysis, your profile must include:
  • First Name and Last Name
  • Career Summary (at least 50 characters)
  • Skills (at least 3 skills)
  • Work Experience OR Education (at least one entry)

AI Analysis Details

Analysis Timeout

Match analysis has a 30-second timeout:
// Add timeout to prevent indefinite waiting on AI operations
// Job analysis is complex but should complete within 30 seconds
aiCtx, cancel := context.WithTimeout(ctx, 30*time.Second)
defer cancel()

response, err := j.model.Generate(aiCtx, llm.GenerateRequest{
    Prompt:       *prompt,
    ResponseType: llm.ResponseTypeMatchResult,
})

Validation

Results are validated before being displayed:
func (j *JobMatcherService) validateMatchResult(result *models.MatchResult) {
    // Ensure score is 0-100
    if result.MatchScore < 0 || result.MatchScore > 100 {
        result.MatchScore = 0
    }
    
    // Ensure arrays are never empty
    if len(result.Strengths) == 0 {
        result.Strengths = []string{"No specific strengths identified"}
    }
    
    if len(result.Weaknesses) == 0 {
        result.Weaknesses = []string{"No specific weaknesses identified"}
    }
    
    if len(result.Highlights) == 0 {
        result.Highlights = []string{"No specific highlights identified"}
    }
}

Best Practices

Before running any match analyses, ensure your profile is comprehensive and up-to-date. Incomplete profiles produce less accurate results.
Keep your skills list current. Add new technologies and frameworks as you learn them to improve match accuracy.
Include specific achievements and technologies used in each role. This helps the AI identify relevant experience.
Your career summary is crucial for AI analysis. Include your expertise areas, years of experience, and career goals.
After adding new experience or skills, re-analyze your saved jobs to see improved match scores.
Prioritize applications for jobs with 70%+ match scores. These have the highest probability of success.

Error Handling

Common errors and solutions:
ErrorCauseSolution
Profile IncompleteMissing required profile fieldsComplete your profile with career summary, skills, and experience
Profile Summary RequiredCareer summary is empty or too shortAdd a detailed career summary (50+ characters)
AI Service UnavailableTemporary AI service issueTry again in a few moments
Quota ExceededMonthly quota limit reachedWait for monthly reset or upgrade your plan
TimeoutAnalysis took too longTry again; contact support if issue persists

Next Steps

Profile Management

Learn how to build a comprehensive profile for accurate matching.

Document Generation

Generate tailored CVs and cover letters based on match analysis.

Build docs developers (and LLMs) love