Job Search Workflow

Envoy's primary function begins with intelligently searching for job opportunities that align with your career goals. This section outlines how Envoy discovers jobs, applies initial policy filters, and presents suitable opportunities for your review.

The job search workflow is designed to be autonomous yet review-first, ensuring you only see relevant positions that have passed an initial automated screening.

1. Initiating a Search

The process starts within the Portal (your user interface). You provide keywords (e.g., "Python Engineer", "Data Scientist") and a location. Once you click "Run Search", the Portal sends this request to the Agent.

Portal: enter keywords + location → click "Run Search"

2. Job Discovery & Data Extraction

Upon receiving the search request, the Agent orchestrates the job discovery. It communicates with the Tools service, which is responsible for browser automation and parsing. The Tools service, using Playwright, navigates to specified job boards (e.g., SEEK, Indeed, LinkedIn), performs the search, and fetches the listing pages.

Key details are then extracted from each job listing, including:

Job Title
Company Name
Location
Salary Range (if available)
Work Type (e.g., Full-time, Contract)
Relevant Tags and Keywords
Key Bullet Points from the description

  Agent: POST /workflows/search
    → calls Tools: POST /tools/providers/seek/search
      → Playwright fetches SEEK listing pages
      → parser extracts: title, company, location, salary, work type, tags, bullet points

3. Automatic Policy Filtering

Before any job is presented to you, the Agent applies a set of pre-defined policy filters. These filters automatically block jobs that don't meet your configured criteria, such as:

Internships
Graduate programs
Roles below a certain seniority
Roles that explicitly mention undesirable technologies or industries

This step significantly reduces noise, ensuring that only potentially relevant opportunities proceed to your review queue.

    → policy filter: blocks internships, grad programs, etc.

4. Persisting and Presenting Opportunities

Jobs that successfully pass the policy filters are then persisted to Envoy's local SQLite database with a discovered status. These jobs are immediately reflected in the Portal as individual job cards.

Each job card provides a concise overview, allowing you to quickly decide whether to Review the job further or Ignore it.

    → persists new jobs to SQLite (state: discovered)
  Portal: shows job cards with Review / Ignore buttons

This completes the Job Search Workflow, leading directly into the Prepare workflow where Envoy begins drafting a personalized application for jobs you choose to review.