HR Assistant

AI-powered HR assistant providing intelligent support for HR operations, employee queries, and automated insights.

Features

• Employee Query Assistance - Answer common employee questions about policies, benefits, and procedures
• HR Policy Lookup - Intelligent search and retrieval of HR policies and documentation
• Automated HR Insights - Generate insights from HR data including turnover analysis and engagement metrics
• Natural Language HR Queries - Query HR data using conversational language
• Onboarding Support - Automated guidance for new employee onboarding

Requirements

Requirement	Details
Dependencies	AICore
PHP Version	8.2+
AI Provider	At least one AI provider configured in AI Core

Installation

1. Ensure AI Core module is installed and enabled
2. Enable the HR Assistant module in Settings > Modules
3. Configure HR knowledge base and data access permissions

Configuration

Navigate to Settings > AI Core > HR Assistant to configure:

• Knowledge Base - Upload HR policies, handbooks, and documentation
• Data Access - Configure which HR data the assistant can access
• Response Style - Set formal or conversational tone
• Language - Configure supported languages for responses

Usage

Employee Self-Service

Employees can ask questions through the HR portal:

• "What is the vacation policy?"
• "How do I submit an expense report?"
• "What are the health insurance options?"
• "When is the next performance review cycle?"

HR Manager Insights

HR managers can query for insights:

use Modules\HRAssistant\Services\HRAssistantService;

$assistant = app(HRAssistantService::class);

$insights = $assistant->analyze([
    'query' => 'What are the turnover trends in the engineering department?',
    'context' => ['department' => 'Engineering', 'period' => 'last_12_months'],
]);

Policy Lookup

$response = $assistant->findPolicy([
    'topic' => 'remote work',
    'include_related' => true,
]);

API Endpoints

Method	Endpoint	Description
POST	/api/v1/hr-assistant/query	Submit HR query
GET	/api/v1/hr-assistant/policies	Search policies
POST	/api/v1/hr-assistant/insights	Generate HR insights

Capabilities

Capability	Description
Policy Q&A	Answer questions about company policies
Leave Guidance	Explain leave policies and balances
Benefits Info	Provide benefits information
Onboarding Help	Guide new employees through onboarding
Turnover Analysis	Analyze and explain turnover metrics

Notes

• Responses are based on configured knowledge base and HR data
• All interactions are logged for audit and improvement
• Assistant can be trained with organization-specific policies
• Supports multiple languages based on AI provider capabilities