HR & Recruiting

How to build an AI HR policy assistant

The short answer

An AI HR policy assistant answers employee questions in Slack or Microsoft Teams from your approved handbook and policies, filtered to the employee's state and employment type, with a citation for every answer. It must detect sensitive topics such as harassment, leave, accommodations and pay disputes and hand them to a person in HR instead of answering.

What this automation does

Employees ask in the chat tool they already use and get an answer that quotes the policy, or a fast handoff to a person.

  1. Ask. An employee messages the assistant in Slack or Teams, for example “How much bereavement leave do we get for a grandparent?”
  2. Identify. The assistant maps the chat user to the HRIS record and loads only the attributes it needs: work state, entity, employment type, exempt status.
  3. Screen for sensitive topics. A classifier checks the question first. Sensitive topics skip retrieval entirely and go to the HR handoff path.
  4. Retrieve. The assistant searches only the policy chunks that apply to this employee’s attributes and pulls the top matches.
  5. Answer with a citation. The model answers in plain language, quotes the relevant line and links to the section. If the retrieved text does not answer the question, it says so.
  6. Personal lookups. “How much PTO do I have?” is answered from the HRIS for that employee only, or with a link to self-service if you prefer not to expose balances in chat.
  7. Learn from gaps. Unanswered questions are collected weekly so HR can see where the handbook is silent or unclear.

When it is worth building

The signal is an HR inbox full of the same questions: holidays, PTO accrual, expense rules, benefits enrollment windows, remote work equipment. If one HR generalist spends a day or more a week answering questions already covered by written policy, an assistant gives that time back.

It is also worth building when you operate in several states, because that is where a static FAQ page falls apart. It is not worth building if your policies are not written down or are badly out of date. Fix the handbook first; an assistant will repeat whatever the documents say.

Architecture

LayerWhat we useWhy
InterfaceSlack app or Microsoft Teams botNo new tool to learn, and identity comes from the workspace login
Source documentsSharePoint, Google Drive or Notion, one approved folderHR controls exactly what is indexed by controlling one location
Applicability tagsMetadata per chunk for state, entity and employment typeFiltering before search is more reliable than asking the model to sort it out
RetrievalPostgres with pgvector, or Pinecone for larger librariesMost HR libraries are small enough that pgvector is simpler to run
Employee contextBambooHR or your HRIS API, read-only and field-limitedThe assistant knows where someone works without seeing their pay or reviews
ModelClaude or OpenAI’s GPT models through the APIStrong at answering only from supplied text and citing it
HandoffPrivate case in your HR ticketing tool or a direct message to HRSensitive questions reach a person quickly and stay confidential
LoggingQuestion, retrieved chunks, answer and feedback, with restricted accessLets HR audit answers; treat logs as HR records

For the general pattern behind this, see our guide to building a RAG knowledge assistant. An HR assistant is that pattern with stricter access control and a mandatory escalation path.

How to build it

  1. Inventory the documents. Collect the current handbook, state addenda, benefits summaries and policy memos. Remove drafts, superseded versions and anything with individual employee data.
  2. Chunk by policy section. Split on headings so each chunk is one rule with its title. Tag each chunk with applicability and an effective date.
  3. Define the sensitive-topic list with HR. Write examples of each category, including indirect phrasing such as “my manager keeps commenting on my appearance”. Test the classifier against 100 or more examples before launch.
  4. Write the answer rules. Answer only from retrieved text, quote it, link it, never speculate about legal rights, and say “I don’t know, here is who to ask” when the text is silent.
  5. Connect identity and the HRIS. Map workspace users to employee records and limit the fields the assistant can read.
  6. Pilot with one department. Have HR review every answer for two weeks and mark each one correct, incomplete or wrong.
  7. Roll out with a clear notice. Tell employees what the assistant is, that conversations are logged and reviewed by HR, and that it does not replace talking to a person.

What breaks in production

  • Stale policy versions. Someone saves last year’s handbook PDF into the indexed folder. Index only from one controlled location and show the effective date in answers.
  • Confidential disclosures in the wrong place. An employee describes a harassment incident in a public channel where the bot is mentioned. The bot should move the conversation to a private message and alert HR without repeating details.
  • Answers that sound like promises. “You are entitled to” reads as a commitment. Phrase answers as what the policy says, and keep your handbook’s disclaimer language intact.
  • Questions about other people. “Is Sam out next week?” should be refused unless the policy and the data allow it.
  • Year-specific facts. Holiday calendars, open enrollment dates and contribution limits change every year. Tag them with a year and set a reminder to replace them.
  • Over-escalation. If the classifier is too cautious, ordinary questions about PTO go to HR and the assistant saves no time. Tune with real examples and review weekly.

Timeline and cost

A single-entity assistant in Slack or Teams usually takes three to six weeks including the HR review period. Lumeor builds this in the range of $12,000 to $30,000, depending on the number of states and entities, whether personal HRIS lookups are included, and how much reporting HR wants. Model and hosting costs for a company of a few hundred people are typically small; see what a RAG knowledge assistant costs for how running costs scale.

How to measure success

  • Share of questions answered without an HR follow-up
  • HR-graded accuracy on a weekly sample of answers
  • Sensitive-topic recall: of the questions HR judges sensitive, how many the assistant routed correctly
  • Median time to answer, compared with the old HR inbox
  • Top unanswered topics each month, and how quickly the handbook is updated to cover them
  • Employee thumbs-up rate, read alongside the accuracy sample rather than on its own

Frequently asked questions

Can an AI HR assistant give employees legal advice?

It should not. The assistant explains what your company's written policies say and links to the source. Questions about legal rights, such as whether a situation counts as retaliation or whether someone qualifies for protected leave, are routed to HR, and HR involves counsel when needed.

Which topics should go straight to a human?

At minimum harassment, discrimination, retaliation, workplace safety complaints, medical conditions and accommodation requests, protected leave, pay disputes, immigration status and anything about a termination. The assistant acknowledges the question, explains that HR will follow up privately, and opens a confidential case.

How do you handle employees in different states?

Each policy chunk is tagged with the states, employment types and entities it applies to, and the assistant filters by the asking employee's attributes from the HRIS before it searches. A California employee and a Pennsylvania employee asking about sick leave can get different, correctly cited answers.

Is it safe to put our handbook into an AI model?

Use API access rather than consumer chat apps. OpenAI and Anthropic do not train on API data by default. The bigger risks are internal, such as indexing a draft policy or a folder with salary data, so control exactly which documents are indexed and who can see what.

Do we need fine-tuning to make it sound like our company?

No. Retrieval over your current documents keeps answers tied to the latest approved text and lets you update a policy by replacing a file. Fine-tuning bakes old wording into the model and makes citations impossible to trust.

Could a simpler tool do this?

If your handbook is short and you have one location, a well-organized intranet page or an FAQ chatbot can answer most questions. Build the full assistant when policies vary by state or entity, when employees ask about their own balances, or when routing sensitive topics reliably matters.

Next steps