Best Usage Guide for ZenAI and ZenAI NLP Search

Prev Next

AI Searches in Zenople by Aqore

Zenople by Aqore provides two AI-powered search options to help you find candidates or customers quickly:

  • ZenAI NLP Search – Type natural, conversational queries in plain English.

  • ZenAI Search – Select or enter specific search fields for a structured approach.

Both features can be enabled per user through the “EnableAIFeatures” option property. Once enabled, the search options are accessible via the Advanced Search dropdown.

Key Differences

  • ZenAI NLP Search supports both Customer and Person searches.

  • ZenAI Search supports only Person searches.

Once the features are enabled, the AI Search options can be accessed by clicking the Advanced Search dropdown button. From there, select the desired AI Search option from the Search Type dropdown, as shown in the attachment.

ZenAI NLP Search

ZenAI NLP Search allows users to search using natural language queries instead of fixed parameters.

  • Person vs Customer Search:

    • Person Search: Searches for applicant, employees, or new hires.

      • Example: “Find candidates in Arizona skilled in accounting.”

    • Customer Search: Searches for organizations or customers.

      • Example: “Find customers in Arizona with invoices due.”

ZenAI NLP Search automatically detects whether your query refers to a person or a customer. This distinction allows users to seamlessly search across both people and organizations using the same natural language interface.

How to Use ZenAI NLP Search in best way

To achieve the most accurate and relevant results when using ZenAI NLP Search, follow these best practices:

  • Use clear and natural language: Write queries in a straightforward and conversational manner to ensure the system can accurately interpret your intent. Wording and language choice is your’s but intent needs to be understandable.

  • Can utilize multi-sentence input: You can enter multiple sentences or clauses within a single query. The system is capable of understanding and processing them contextually.

  • Be specific where necessary: Clearly mention skills, experience duration, locations, job titles, or other relevant attributes to refine results effectively.

  • Differentiate between city and office searches: As our system office name normally resembles with city name, sometime confusion might occur between office name and location related criteria so it always recommended to use office keyword for such kind of office name to make difference.
         – “People from Dallas” will search based on the city = Dallas.
         – “People from Dallas office” will search based on the Dallas office.

  • Specify status using the 'status' keyword: As our system status could be any like ‘applicant’ so it might create confusion between person type and status. So, it is always recommended to specify status keyword for such kind of status. However, general status like active can be used normally.
         – “Find applicant applicant” will search by Person Type = Applicant only.
         – “Find applicant status applicant” will search by both Person Type = Applicant and Status = Applicant.

  • What to Avoid:

    • Avoid using only abbreviations (e.g., “CDL”, “RN”)

    • Avoid keyword-based search as the engine perform better with natural understandable queries

    • Avoid very short queries with little context

Instead, use descriptive queries like:

  • Find candidates with CDL license

  • Show me registered nurses (RN) in Chicago

  • Find forklift drivers with warehouse experience

ZenAI NLP Person Search Criteria

Currently, ZenAI NLP Person Search only supports the following Criteria:

  • Person ID: Allows users to search for a candidate using their unique Person ID.  Supported Query Examples:

      • Find candidate with the person ID 53355

      • Person ID: 53355

  • Full Name: Allows users to search for candidates by their full name or partial name. Supported Query Examples:

      • Candidate named John Doe

      • Candidates named John

      • John Doe

      • John

  • Person Type: Allows you to filter candidates by their role: Applicant, Employee, or New Hire. The system also recognizes common shortcuts or abbreviations—for example, “ATS” means Applicant, “EIS” means Employee, and “NHO” means New Hire—so you don’t need to type the full word every time. Supported Query Examples:

    • Find applicants named John

    • Find Java developers in EIS

    • Find new hires named Jane

  • Status: Allows you to filter candidates based on their current status in the system.

Note: We must include the word “status” in your search because there are multiple fields that contain the word “status” (like WOTC status, E-Verify status, TaskStatus, etc.). Including the keyword ensures ZenAI searches specifically for the candidate’s status.

Supported Query Examples:

  • Status: Allows you to search for candidates based on their person status. ZenAI recognizes the status you type and gives higher priority to records that match the mentioned status. Supported Query Examples:

    • Find applicants whose status is inactive

    • Find candidates with DNA status

    • Find employees whose status is working

  • Skill: Allows you to search for candidates based on their skills. ZenAI recognizes the skills you type and gives higher priority to candidates who match more of the skills in your search.

    Supported Query Examples:

    • Find candidates skilled in forklift driving

    • Find candidates with accounting experience

    • Show me candidates with customer service or Helpdesk support skills

    • Find candidates skilled in forklift driving or inventory management

  • Job Title: Allows you to search for candidates by their job title. ZenAI recognizes the titles you type and also finds related skills automatically. For example, searching for “Driver” will match candidates with the job title Driver and the skill Driving. Candidates who match multiple titles or skills are ranked higher in the results.  

    Supported Query Examples:

    • Find data entry clerk candidates

    • Show me applicants who are Warehouse Managers

    • Find candidates who are Drivers or Forklift Operators

    • Show me Nurses or Medical Assistants with CPR skills

    • Find candidates experienced as an Accountant with Excel and QuickBooks skills

  • Employer: Allows users to search for candidates based on their organization or workplace.

    Supported Query Examples:

    • Find candidates who work at Acme Corp

    • Show me employees who have worked at Tech Solutions before

    • Find applicants employed by Global Logistics

  • Is Available to Work: Allows users to filter candidates based on their current availability. This includes whether a candidate is ready to take on work or currently placed on an assignment.

    Supported Query Examples:

    • Find candidates whose status is active and who are available to work

    • Find candidates who are not available to work

    • Find employees who are currently on assignment

    • Show me candidates currently available for work

  • Email Address: Allows users to search for candidates using their email address.

    Supported Query Examples:

    • john.doe@mail.com

    • Find a candidate with the email john.doe@mail.com

  • Phone Number: Allows users to search for candidates using their phone number.

    Supported Query Examples:

    • 123-456-7890

    • Find candidates with the phone number 123-456-7890

  • Office: Allows you to search for candidates based on their office location. The query must include the word “office”.

    Supported Query Examples:

    • Find applicants of XYZ office who are currently not working

    • Show me employees in the ABC office

    • Find candidates whose status is active from the Downtown office

Note: Including the word “office” is important because some office names may be the same as city names. Without it, ZenAI might confuse the office with a location.

  • Resume: Allows users to filter candidates based on whether they have a resume uploaded in Zenople.

    Supported Query Examples:

    • Find employees who have resumes

    • Find candidates who are available to work and have resumes on file

    • Show me applicants with no resumes from XYZ office

  • Experience: Allows users to search for candidates based on their years of work experience. Supports specifying exact years or a range of years.

    Supported Query Examples:

    • Find candidates with 5 years of experience and are skilled in data entry.

    • Show me employees with 3 to 7 years of experience and are skilled in data entry or quickbooks.

    • Find applicants who have more than 10 years of experience and have worked at XYZ Motors.

  • Rating: Allows users to search for candidates based on their profile rating. Supports a single integer value from 1 to 5.

    Supported Query Examples:

    • Find candidates with a rating of 5

    • Show me employees with a rating of 3

    • Find people rated 4

  • Degree: Allows users to search for candidates based on their educational degree. Supported values are School, Bachelors, Masters, and Doctoral.

    Supported Query Examples:

    • Find candidates with a bachelor’s degree

    • Show me employees with a master’s degree

    • Find applicants with a Doctoral degree

    • Candidates with School-level education

  • Location: Allows users to search for candidates based on their address. Searches can target City, State, Zip Code, or full/partial street address (Address1).

    Supported Query Examples:

    • Candidates located in Michigan state who are currently working

    • Candidates located in Phoenix, AZ who are skilled in inventory management

    • Find employees in 10001 ZIP code whose status is DNA.

    • Show me candidates from 123 Main Street, Los Angeles, CA who are currently not working.

    • Find applicants in Austin, TX with forklift skills

  • Geo-Location: Allows users to search for candidates based on proximity to a location. ZenAI calculates the distance between the specified location and candidate addresses to return results within the given radius.

    Supported Query Examples:

    • Find forklift drivers who are located 20 miles near Phoenix, AZ

    • Show me candidates within 10 miles of 123 Main Street, Los Angeles, CA who have are currently available to work and their status is active.

    • Find applicants within 5 miles of Austin, TX skilled in farming.

    • Candidates who are located 15 miles around Chicago, IL with a minimum of 4 years of experience in bee keeping.

  • Person Created Date: Allows users to search for candidates based on when they were created in Zenople. Supports exact dates, date ranges, and relative date terms like this year, last quarter, or last week.

    Supported Query Examples:

    • Find candidates who were created in 2025

    • Find applicants created between 05/01/2025 - 05/01/2026

    • Find applications created in the last quarter

    • Find applications created this year

  • Desired Pay Rate: Allows users to search for candidates based on the pay rate they are willing to accept. Supports exact values or ranges and can be combined with other filters like location or skills.

    Supported Query Examples:

    • Find candidates who are willing to accept pay rate between $18 - $25 per hour

    • Show me applicants in Austin, TX with data entry skills willing to accept $15/hour

    • Candidates in Chicago, IL skilled in warehouse management willing to accept $22-$30/hour

  • E-Verify Status: Allows users to search for candidates based on their current E-Verify status. The query must include the phrase “e-verify status” for proper detection. Supported status values are: authorized, awaiting response, incomplete, not verified, unauthorized, unresolved.

    Supported query examples:

    • Find candidates whose e-verify status is Authorized

    • Show me candidates with e-verify status NotVerified

    • Find candidates with e-verify status AwaitingResponse

  • WOTC Status: Allows users to search for candidates based on their WOTC status. The query must include the phrase “WOTC status” for proper detection. Supported status values are: eligible, ineligible, not screened.

    Supported query examples:

    • Find candidates whose WOTC status is Eligible

    • Show me candidates with WOTC status Ineligible

    • Find candidates with WOTC status Not Screened

  • Document Details: ZenAI detects documents mentioned in a query and organizes them into Available and Unavailable documents.  Does not include task related and resume documents.

    Each document can include:

    • Document Name – The exact name of the document if mentioned

    • Document Type – The type of document (like I9SupportingDocument, Professional License/Certification, Subpoena) if no specific name is given

    • Document Insert Date – When the document was uploaded, if explicitly mentioned

    • Document Validity Date – Expiration or validity date, if explicitly mentioned.

    Supported query examples:

    • Find candidates with I-9 documents valid until 2027.

    • Find candidates with files called “XYZ_Custom_Document_2026” which was inserted in February of 2026.

    • Find candidates skilled in data entry and have the “ConfidentialityAgreement” document valid until this quarter.

    • Find candidates who do not have the “ConfidentialityAgreement” document.

    • Find candidates who do not have the file called “ClientUploadedFile_XYZ”.

  • Task Details: Allows users to search for tasks assigned to a candidate. ZenAI detects tasks mentioned in a query and lists them with the following details:

    • Task – The name of the task (if explicitly mentioned)

    • Task Status – The current status of the task, such as Approved, Completed, Assigned, or Rejected

    • Task Completion Date – When the task was completed, if explicitly stated

    • Task Due Date – The deadline for the task, if explicitly stated

    Supported query examples:

    • Show me employees who have tasks due by 03/31/2026.

    • Show me candidates who have been assigned the task called: “XYZ” and the task is due by this month.

    • Show me candidates who have been assigned the task called “abc-task” and the task’s status is rejected.

    • Find employees who have been assigned the task called “onboarding task” and is due this week.

  • Assessment Details: Allows users to search for candidate assessments. ZenAI Search detects assessments mentioned in a query and lists them with their name, status, and relevant dates. Only explicitly mentioned assessment names are considered.

    • Assessment – The name of the assessment (if explicitly mentioned)

    • Assessment Status – Possible values: Qualified or Unqualified (only when clearly stated)

    • Assessment Issue Date – When the assessment was issued, if explicitly mentioned

    • Assessment Validity Date– Expiration or validity date, if explicitly mentioned

    Supported query examples:

    • Find candidates with the assessment: Drug screening issued last year

    • Employees who have the assessment called Employment verification with status qualified.

    • Employees who were created this year and have the assessment: DISC Assessment completed

    • Employees who were issued the Myers-Briggs assessment this quarter.

  • Background Check Details: Allows users to search for candidate background checks. ZenAI detects background checks mentioned in a query and lists them with their package name, status, and relevant dates. Only explicitly mentioned package names are considered.

    • Package – The name of the background check package (if explicitly mentioned)

    • Background Check Status – Status values are: Pending, Complete, Canceled, Error, Initiate, or Redirect (only when clearly stated)

    • Background Check Order Date – When the background check was ordered, if explicitly mentioned

    • Background Check Validity Date– Expiration or validity date, if explicitly mentioned

    Supported query examples:

    • Find candidates with background check “Standard Package” and status is complete.

    • Show me applicants with background check: Premium Package with status as Pending and order date is in this year.

    • Find candidates with background check “Level 2 Screening” ordered last month

    • Show me employees with background check: Basic Package valid until 12/31/2026

Real-World Advanced NLP Search Examples for Person Search

  • Find Shipping clerks in a 10 mile radius of San Bernardino, ca

  • Give me a list of candidates skilled in book keeping in Sioux falls, SD

  • Find “mig welders” located in Sioux Falls, SD

  • Find me registered nurses located in a 10 mile radius of Walker, Michigan area

  • Find applicants who were created in 2026 and do not have resumes on file.

  • Find candidates that have worked at Autozone or Napa Auto Parts.

  • Find people with lead and supervisor experience.

  • Practical nurses in Savannah area

  • I need administrative assistant candidates near Bastrop, TX 78602

  • I need candidates with accounts payable experience

  • Looking for CNC Operators within 25 miles of Tampa Florida. Must have Mills and Lathes, quality control, doing set up, doing minor adjustments on code. First shift $27 per hour

  • Coding specialist in Savannah area

  • Find candidates whose status is DNA

  • Find candidates in Phoenix, AZ with forklift skills, 5+ years of experience, and who are available to work

  • Show me candidates in Texas with accounting or finance skills and whose e-verify status is Authorized

  • Find employees who are Drivers or Forklift Operators in Chicago, IL, who have the “Standard Package” background check and its status is Complete

  • Find new hires who have completed onboarding tasks, whose WOTC status is Eligible, and whose desired pay rate is under $30/hour

  • Find new hires who have completed "XYZ_onboarding" task, whose WOTC status is Eligible, and whose desired pay rate is under $30/hour

ZenAI NLP Customer Search Criteria

Currently, ZenAI NLP Customer Search only supports the following parameters:

  • Organization’s Name: Search by full or partial company name.

    Supported Query Examples:

    • Find customers named “Acme Corp”

    • Find customers with “Tech” in the name

  • Organization’s Office: Search by specific office location.

    Supported Query Examples:

    • Find Customers in the “Dallas office”

    • Find Customers in the “San Jose office”

  • Organization’s Insert Date: Search by the date the organization was added.

    Supported Query Examples:

    • Customers added between 01/01/2025 and 12/31/2025

    • Customers added this quarter

  • Organization’s Address: Search by city, state, zip code, or full address.

    Supported Query Examples:

    • Customers located at 123 Main Street, Austin, TX

    • Customers in Phoenix, AZ

  • Organization’s Status: Filter by the organization’s current status (Active, Inactive, Disqualified, etc.).

    Supported Query Examples:

    • Find organizations with status Active

    • Find organizations with status Prospect

  • Organization’s Type: Filter by type – Customer, New Customer, Lead, or Target.

    Supported Query Examples:

    • Find customers of type Leads created this year

    • Find New Customers

  • Assignments: Shows if the organization has employees assigned to jobs.

    Supported Query Examples:

    • Customers with active assignments

    • Customers with no active assignments

  • Industry Sector: Filter by the organization’s industry. Requires the keyword “sector”.

    Supported Query Examples:

    • Organizations in Healthcare sector

    • Find targets in Manufacturing sector

  • Sales Level: Search by sales category or tier.

    Supported Query Examples:

    • Customers with Hot sales level

    • Customers with Cold sales level

  • Revenue: Search by revenue range.

    Supported Query Examples:

    • Customers with revenue of over $1,000,000

    • Customers with revenue of less than $50,000

  • Last Comment Date: Search by most recent comment or note.

    Supported Query Examples:

    • Organizations with last comments after 01/01/2026

    • Organizations with last comments this month

  • Time Approval: Shows if timesheets or work hours are pending approval.

    Supported Query Examples:

    • Customers with pending time approvals

    • Customers with all approvals completed

  • Demanded Skills: Search by skills required in the organization’s jobs.

    Supported Query Examples:

    • Customers requiring forklift driving, and inventory management skills

    • Customers needing accounting skills

  • Job Title: Search by titles of jobs requested.

    Supported Query Examples:

    • Customers who are offering jobs for Warehouse Manager or Warehouse Assistant

    • Find customers who have jobs for Administrative Assistant

  • Job Status: Filter by status of jobs (Open, Closed, Filled).

    Supported Query Examples:

    • Customers who have jobs with status Open

    • Find customers with jobs with status Filled

  • Job Start Date: Search by job start date.

    Supported Query Examples:

    • Customers who have jobs starting after 03/01/2026

    • Customers who have jobs starting this year

  • Job End Date: Search by job end date.

    Supported Query Examples:

    • Customers who have jobs ending before 06/30/2026

    • Find customers with jobs ending this month

  • Time Taken to Fill Job (In Minutes): Search by how long it took to fill a position.

    Supported Query Examples:

    • Find customers with jobs filled in less than 12 hours

    • Organizations with jobs filled in more than 24 hours

  • Job Type: Filter by Temp, Direct, or Scheduled Jobs.

    Supported Query Examples:

    • Find customers with Temp jobs that are offering warehouse manager jobs

    • Find organizations with Direct jobs that are offering Forklift driver jobs starting this week

  • Required Number of Employees for Job: Search by number of employees needed.

    Supported Query Examples:

    • Find customers having jobs requiring 5 or more employees

    • Find organizations having jobs requiring 2 employees

  • Job’s Address: Search by job location.

    Supported Query Examples:

    • Customers with Jobs at 456 Industrial Way, Chicago, IL

    • Customers with Jobs in Houston, TX

  • Assignment Start Date: Filter by employee assignment start date.

    Supported Query Examples:

    • Customers with Assignments starting after 03/01/2026

    • Customers with Assignments starting this week

  • Assignment End Date: Filter by employee assignment end date.

    Supported Query Examples:

    • Customers with Assignments ending before 06/30/2026

    • Customers with Assignments ending this month

  • Invoice Number: Search by invoice number.

    Supported Query Examples:

    • Customers having the Invoice number 11012950

    • Customer having the Invoice number 11012967

  • Balance: Filter by total balance due.

    Supported Query Examples:

    • Customers with balance over $5,000

    • Customers with balance under $1,000

  • Remaining Balance: Filter by unpaid balance.

    Supported Query Examples:

    • Customers with remaining balance more than $1,000

    • Customers with remaining balance less than $500

  • Invoice Due Date: Search by invoice due date.

    Supported Query Examples:

    • Customers with Invoices due before 04/15/2026

    • Customers with Invoices due this week

  • Accounting Period: Search by financial period.

    Supported Query Examples:

    • Customers with Invoices that fall under Q1 2026’s accounting period

    • Customers with Invoices whose accounting period is 2020-07-19

  • Invoice Insert Date (Invoice Date): Filter by invoice creation date.

    Supported Query Examples:

    • Customers with Invoices created between 01/01/2026 – 03/31/2026

    • Organizations with Invoices created last month

  • Has Invoice Due: Shows if the organization has pending invoices.

    Supported Query Examples:

    • Customers with invoices due

    • Customers with no invoices due

  • Latest Invoice Date: Filter by the most recent invoice date.

    Supported Query Examples:

    • Customers with latest invoice after 02/01/2026

    • Customers with latest invoice before 01/01/2026

Note: Any other criteria detected in the user’s search prompt (other than what’s been listed above) will be ignored by ZenAI NLP Search, which may result in inaccurate results. To ensure optimal accuracy, users are advised to search only within the parameters listed above.

Upon entering a search prompt, ZenAI NLP Search retrieves and displays the top matching candidates, ranking them according to an AI-generated score.

Semantic Search Option in ZenAI NLP Search

ZenAI NLP Search (Person Based Search) also can be further be enhanced by enabling the “Semantic Search”. Semantic Search enhances ZenAI NLP Search by further understanding the meaning and context of user queries. It identifies related concepts to deliver more accurate and contextually relevant search results. Basically, it rescores the matched result based on the advance semantic meaning. When Semantic Search is enabled, the system limits the output to the top 50 most relevant results to maintain precision and performance.

Semantic Search can be enabled or disabled using the “EnableSemanticSearch” option property at the person level.

Note: for semantic search to work, ZenAI NLP Search feature must already be enabled for the same user. Upon enabling the “EnableSemanticSearch” option property, a toggle will be visible which will give users the ability to perform semantic search.

Recent Search Option in ZenAI NLP search

The Recent Search feature is available only in ZenAI NLP Search. It stores the searches performed by users in the Recent Search dropdown list. Each entry in the list displays both the search query and the type of search it was — either a Standard AI Search or a Semantic Search.

Selecting any value from this list retrieves the previously fetched data count from the database. For example, if a user searched for “find me candidates skilled in data entry” five days ago and the result returned 45 candidates, selecting that same search from the Recent Search list will still display the same 45 candidates — even if new candidates with the data entry skill have been added since then.

To view the most up-to-date results, users can click the “Refresh Search Results” button. This action fetches the latest data without incurring any additional cost.

ZenAI Search (Parameterized AI Search)

ZenAI Search is a parameterized version of the ZenAI NLP Search. It provides users with a more structured and guided interface. Instead of typing a natural language query, users can directly select or enter specific parameters supported by ZenAI NLP Search, making it easier to perform precise searches without relying on phrasing or context interpretation.

The key difference is that ZenAI Search includes a “Keyword” field, which allows users to search for an exact keyword across all supported fields. This enables broader matching when the specific field associated with a keyword is unknown. The Keyword field allows users to search for an exact word or phrase across all supported fields, even if the field it belongs to is unknown. This is especially useful when searching for abbreviations, acronyms, or partial terms that may not be recognized as a standard skill, job title, or certification.

Best Practices for the Keyword field:

  • Use exact words or phrases you want to find, including abbreviations or acronyms (e.g., CDL, RN, CPR)

  • Use this field when you are not sure which field the term belongs to.