
In brief
The phrase “ask anything about the company” sounds useful until a new hire asks about a regional leave rule, a manager asks about a probation exception, or someone requests a colleague's compensation information. A fluent answer can be wrong, out of scope or unauthorized even when the system is working exactly as configured.
An onboarding knowledge base should make the safe path easy: answer from current approved material, show the source, ask for the missing detail, and hand the case to a person when the evidence or authority runs out. It can remove repeated searching. It cannot turn an unresolved HR decision into policy.
Start with questions, not a chatbot
Write down the questions new hires and managers actually repeat. Pull them from helpdesk tickets, onboarding checklists, HR inboxes and manager office hours. Group them by the decision the person is trying to make, not by the software that stores the answer.
For a first pilot, prefer questions such as:
These questions have a possible source and a clear owner. “What should I do about a difficult manager?” does not become safe merely because a language model can produce a sympathetic paragraph. It needs a human route.
AIHR's overview of AI in employee onboarding describes role-specific content, chat-based support, workflow reminders and policy guidance, while also stressing clean data, change management and human review. Those are useful categories for a question inventory, not proof that a particular tool will improve your onboarding.
- Where is the approved security-training checklist for my role?
- Which system do I use to request a laptop or access to a shared drive?
- When is the standard benefits enrollment window, and where is the official guide?
- Who should review a request that does not fit the written policy?
Map the role, source and escalation owner
Do not give every employee the same retrieval scope. A new hire may need the public handbook and their role's setup instructions. A manager may need a team checklist. HR and IT may need queues or administrative procedures that should not appear in a new hire's answer.
Make those boundaries visible before you connect a folder or index. This is a hypothetical starting register, not a customer configuration:
The eligibility column is not a label that the model can enforce by itself. The identity and retrieval layer must check it. If the service cannot show where that check happens, keep the pilot to non-sensitive material.
| Person asking | Useful first questions | Eligible source | Escalate when |
|---|---|---|---|
| New hire | Where do I complete the standard setup step? Which approved guide applies to my role and region? | Current onboarding checklist, approved handbook and role-specific setup guide. | The source is missing, the question concerns an exception, or the answer would reveal another person's data. |
| Manager | Which steps are due before day one? What is the documented handoff route? | Manager checklist, approved process guide and task status the manager is allowed to see. | The request asks for a personnel decision, a sensitive record or an undocumented exception. |
| HR or People Ops | Which questions remain unresolved? Which source needs an owner? | Approved policy library, question log and restricted HR workflow. | A source conflicts, an access rule is stale, or a decision has not been approved. |
| IT or helpdesk | What setup step failed? What diagnostic details may be included in a ticket? | IT setup guides, service catalogue and the user's permitted ticket context. | The action changes privilege, exposes credentials or needs a security review. |
Prepare the source set before indexing it
An onboarding assistant inherits the weaknesses of its source library. Keep an approved current document separate from a draft, a historical policy and a manager's personal note. Record the owner, effective period, audience and source link. The document-preparation checks in the AI knowledge base guide cover extraction, table context, updates and removals in more detail.
For onboarding, source preparation also needs a question-level check. Take a real question such as “Which laptop setup steps apply to a contractor in Region R?” Read the retrieved passage beside the source. Confirm that the role, region, employment type, date and exception survived extraction. A clean-looking answer is not enough if the condition that changes it stayed in another paragraph.
StackAI's onboarding architecture guide puts permissions-aware retrieval, source ownership and evaluation alongside the knowledge layer. That is the right order of concern. A searchable collection of unclassified HR files is not a safe knowledge base.
Define the answer contract
Before you tune prompts, decide what a good response must contain. A short response contract gives reviewers something concrete to test:
The source link is useful for review, but it does not make an unauthorized answer acceptable. Test the same question with the identity of a new hire and an HR administrator. They should not automatically receive the same evidence.
| Situation | Required response shape | Human boundary |
|---|---|---|
| Current source answers the question | Direct answer, applicable scope, effective date and a link or citation to the source. | The reader can verify the rule and report a mismatch. |
| Missing role, region or employment type | Ask for the missing context before selecting a policy. | Do not guess from the most common employee type. |
| Two approved sources conflict | State that the sources conflict and identify their owners or dates. | Route the decision to the policy owner instead of choosing by timestamp. |
| No approved source | Say that the evidence is insufficient and provide the agreed HR or IT route. | Do not fill the gap with general internet advice. |
| Sensitive or exceptional request | Refuse to disclose restricted material and offer a secure handoff. | A manager or HR owner decides; the assistant does not approve. |
| Safe operational action | Show the proposed action and required fields before sending it. | Start read-only. Add writes only with authorization, approval and an audit trail. |
Pilot read-only answers before actions
An onboarding knowledge base can support actions, but action-taking changes the risk. Creating an IT ticket with a user's device type is different from granting that user access to a production system. Updating a checklist is different from approving an exception to a leave policy.
Start with answers and citations. Add a handoff link or a draft ticket that the user can inspect. Only then consider a write action, and require the user's identity, allowed operation, exact payload, confirmation and duplicate protection. Keep credentials and secrets out of the retrieved context.
AWS's published onboarding-agent example and the StackAI guide show why retrieval, workflow steps and actions are often discussed together. They should still be released separately. A prototype that can answer a policy question has not demonstrated that it can safely change an employee record.
Test the new-hire experience and the exceptions
Build a small acceptance set from real questions. Include questions that should answer, questions that need clarification, questions that must escalate and questions that should be refused. Run it as each relevant persona, not only as an administrator.
Measure the failure, not only whether the answer sounded good. Was the wrong source retrieved? Did the permission filter fail? Did the answer omit a condition? Did the user lack the context needed to choose a policy? Keeping those categories separate makes the next fix more useful than rewriting the prompt after every miss.
| Test | Expected result | Evidence to record |
|---|---|---|
| New hire asks for the standard setup checklist | Returns the current role-appropriate checklist and source link. | Retrieved source ID, version, role and answer reviewer. |
| Region is omitted from a policy question | Asks for region or points to the owner instead of choosing a default. | Clarifying question and no unsupported policy value. |
| Manager asks for an employee's restricted record | Refuses and routes to the authorized HR process. | Identity, attempted source and refusal path. |
| A policy source is replaced | New answers use the approved revision after the documented refresh. | Source revision, refresh time and before/after answer. |
| A source is removed or access is revoked | Fresh retrieval no longer uses the old passage; retained context follows the agreed policy. | Permission-change time, test user and observed propagation. |
| A question asks for an exception | States that the assistant cannot approve it and offers the human owner. | Escalation destination and no invented decision. |
| The assistant proposes an IT or HR action | Shows the exact proposed action and waits for authorized confirmation. | Payload, approver and duplicate check. |
Make ownership and freshness visible
Assign a human owner to each onboarding domain: benefits, IT setup, security training, travel, payroll and role-specific procedures. Record when a source was last reviewed and when its derived representation was last refreshed. A modified file is not proof that the indexed answer changed.
Keep a queue for unanswered questions. Some should lead to a new help article. Some should reveal that the process itself is unclear. Others should remain human-only because the answer depends on a conversation or a case-by-case decision.
AIHR's rollout guidance recommends a controlled pilot, measurement and improvement cycle. Use that idea without importing its examples or claimed outcomes. A useful pilot report can show question volume, supported-answer rate, appropriate escalations, stale-source failures and permission failures. It should not claim that ticket volume or time-to-productivity improved until the organization has a baseline and a measured comparison.
The first release artifact
Before connecting another system, produce one small release packet:
If the packet cannot show who may read an answer, which revision supports it, and who handles the exception, the knowledge base is not ready for a wider onboarding rollout. Improve that evidence first. A smaller, well-controlled question set is more useful than an impressive chat window connected to every company folder.
- The top questions for one role or team.
- The source and audience register for those questions.
- The response contract, including “not enough evidence” and escalation.
- A test set run as a new hire, manager, HR user and IT user.
- An owner and refresh path for every approved source.
Put this into a real operating workflow.
Build a Business Brain around authoritative sources, permissions, human review and measurable operating results. Explore AI automation services →
Sources and verification
Primary product, architecture, risk, and security sources checked on 10 September 2026. Product behavior can change, so verify current plan and admin documentation before implementation.
- AIHR: AI in Employee OnboardingAihr
- StackAI: Build an AI-Powered Employee Onboarding AssistantStackai
- AWS: Build AI-powered employee onboarding agentsAws
- LeanOrchestr: Prepare company documents for an AI knowledge baseLeanorchestr
- LeanOrchestr: Connect Slack, Google Drive and CRM to an AI assistantGoogle