Compensation Agent App Overview
View your salary details, review compensation history, check upcoming pay review dates, and get a complete compensation summary — all through natural language conversations with the Ask AI assistant.
What Is the Compensation Agent?
The Compensation Agent is an AI-powered compensation assistant inside MangoApps Workforce. It connects to the Compensation Management module and lets employees query their pay information, salary history, and review schedules through conversational chat in Ask AI — no navigation to HR portals or payroll systems required.
Instead of filing a request with HR to see your compensation details or digging through old emails for your last raise date, you simply ask: “What is my current salary?” or “When was my last pay change?” The agent retrieves live data from your employment and compensation records, formats it clearly, and responds with a confidentiality reminder.
The Compensation Agent is a system module agent — it extends Ask AI with domain-specific tools for compensation data. All compensation information is treated as confidential and the agent reminds users not to share results externally.
Core Value Proposition:
- 💰 Current Compensation — View your salary, hourly rate, pay type, currency, and pay frequency in one question
- 📈 Compensation History — Review a chronological log of every compensation change with dates, reasons, and who approved it
- 📅 Review Date Tracking — Check when your next compensation review is scheduled (or estimated from your hire anniversary)
- 📊 Compensation Summary — Get a consolidated snapshot: pay type, total changes on record, last change date, and tenure
At a Glance
| 💰 Current Pay | 📈 Pay History | 📅 Review Dates | 📊 Summary |
|---|---|---|---|
| Salary, hourly rate, currency, pay frequency, effective date | Chronological change log with reasons and approvers | Next scheduled or estimated review date with countdown | Tenure, total changes, last change date |
| 🔒 Confidential | 🤖 Ask AI Integration | 📱 Mobile Support | ⚙️ Configurable |
|---|---|---|---|
| All responses include confidentiality reminders | Conversational access through the Ask AI sidebar | Mobile dashboard, capabilities, and activity views | Per-capability toggles for granular control |
Perfect For:
- 👩💼 Employees — Check your current pay, review salary history, and know when your next review is coming
- 👨💼 Managers — Quickly verify compensation details before review conversations
- 🏢 HR Teams — Provide employees with self-service access to compensation data, reducing HR ticket volume
- ⚙️ Admins — Configure which compensation capabilities are available, manage agent settings
How It Works
Compensation Agent Request Flow
┌──────────────────────────────────────────────────────────────────────┐
│ COMPENSATION AGENT REQUEST FLOW │
├──────────────────────────────────────────────────────────────────────┤
│ │
│ ┌───────────┐ ┌──────────────┐ ┌──────────────────────────┐ │
│ │ USER │ │ ASK AI │ │ COMPENSATION AGENT │ │
│ │ MESSAGE │───▶│ ROUTER │───▶│ (Agentic LLM) │ │
│ │ │ │ │ │ │ │
│ │ "What is │ │ Detects │ │ Selects the right tool │ │
│ │ my │ │ salary/pay │ │ based on user intent │ │
│ │ salary?" │ │ keywords │ │ │ │
│ └───────────┘ └──────────────┘ └──────────┬───────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────┐ │
│ │ TOOL EXECUTION │ │
│ │ │ │
│ │ • view_current_comp │ │
│ │ • view_comp_history │ │
│ │ • view_next_review │ │
│ │ • view_comp_summary │ │
│ └──────────┬───────────────┘ │
│ │ │
│ ┌──────────────┐ ▼ │
│ │ STREAMING │ ┌──────────────────────────┐ │
│ │ RESPONSE │◀───│ LLM FORMATS RESULTS │ │
│ │ │ │ │ │
│ │ + Confiden- │ │ Tool data → readable │ │
│ │ tiality │ │ answer + privacy note │ │
│ │ reminder │ │ │ │
│ └──────────────┘ └──────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────┘
Intent Detection
The Compensation Agent responds to questions containing keywords like:
- salary, compensation, pay raise, pay review, wage, hourly rate
- Phrases like “my salary”, “my compensation”, “my pay”, “pay review”, “compensation history”, “compensation summary”, “how much do I make”, “how much do I earn”
When Ask AI detects these patterns, it routes the request to the Compensation Agent with high confidence (0.85).
Key Capabilities
Registered Tools
The Compensation Agent provides four specialized tools that the LLM selects automatically based on your question:
| Tool | Description | Capability Gate | Parameters |
|---|---|---|---|
| view_current_compensation | View your current compensation details including salary, hourly rate, and pay type | salary_management |
None |
| view_compensation_history | View the history of compensation changes | compensation_analysis |
limit (integer, default: 10) |
| view_next_review_date | Check when the next compensation review is scheduled | audit_trail |
None |
| view_compensation_summary | View a summary of compensation data including tenure and change count | compensation_analysis |
None |
Each tool can be independently enabled or disabled through the capability gate configuration.
💰 View Current Compensation
See your complete current compensation details in a single response.
| Data Field | Description |
|---|---|
| Compensation Type | Salaried, hourly, or other pay classification |
| Salary | Annual salary amount (for salaried employees) |
| Hourly Rate | Hourly pay rate (for hourly employees) |
| Currency | Payment currency (defaults to USD) |
| Pay Frequency | How often you are paid (weekly, bi-weekly, semi-monthly, monthly) |
| Effective Date | When the current compensation took effect |
All responses include a confidentiality notice reminding users that compensation information is sensitive.
Use Case — Pre-Review Preparation:
Before a one-on-one with your manager, you ask “What is my current salary?” and receive your full compensation details — pay type, amount, currency, frequency, and the date your current rate became effective.
📈 View Compensation History
Review a chronological log of all compensation changes on your record, including when each change happened, who made it, and why.
| Data Field | Description |
|---|---|
| Effective Date | When the change took effect |
| Change Date | When the change was recorded in the system |
| Change Type | Summary description of the change |
| Direction | Whether the change was an increase, decrease, or lateral |
| Reason | Reason for the compensation change (promotion, annual review, etc.) |
| Changed By | Name of the person who authorized the change |
Results are ordered from most recent to oldest, with a configurable limit (default: 10 records).
Use Case — Salary History Review:
An employee asks “Show my salary history” and receives a timeline of all changes: their starting salary, a raise after probation, an annual review increase, and a promotion adjustment — each with the effective date and who approved it.
📅 Next Review Date
Check when your next compensation review is scheduled. If no explicit review date is set, the agent estimates it based on your hire date anniversary.
| Data Field | Description |
|---|---|
| Next Review Date | Scheduled or estimated date of next compensation review |
| Days Until Review | Countdown in days |
How the Date Is Determined:
- If a
next_review_dateis explicitly set on your employment record, that date is used - Otherwise, the agent calculates your next hire date anniversary as an estimated review date
- If neither is available, you receive a message suggesting you contact your manager
Use Case — Planning Ahead:
An employee asks “When is my next pay review?” The agent responds: “Your next compensation review is estimated for June 15, 2026 (100 days from now), based on your hire anniversary.”
📊 Compensation Summary
Get a consolidated snapshot of your compensation profile — total changes on record, when the last change occurred, and your tenure with the company.
| Data Field | Description |
|---|---|
| Compensation Type | Current pay classification |
| Total Changes | Number of compensation changes on your record |
| Last Change Date | When the most recent compensation change was recorded |
| Tenure (Years) | Your tenure with the company, calculated from hire date |
Use Case — Quick Overview:
An employee asks “Give me a compensation summary” and receives: “You’re a salaried employee with 3.2 years of tenure. You have 4 compensation changes on record, the most recent on January 15, 2026.”
Example Conversations
Checking Current Pay
You: What is my current compensation?
Compensation Agent: Here are your current compensation details:
- Type: Salaried
- Annual Salary: $85,000.00
- Currency: USD
- Pay Frequency: Semi-monthly
- Effective Since: January 15, 2026
🔒 This information is confidential. Please do not share it externally.
Reviewing Pay History
You: Show my salary history
Compensation Agent: You have 3 compensation changes on record:
- Jan 15, 2026 — Annual review increase (Changed by: Sarah Chen)
- Jul 1, 2025 — Promotion adjustment (Changed by: Marcus Johnson)
- Mar 1, 2024 — Starting salary (Changed by: HR Admin)
🔒 This information is confidential.
Next Review Date
You: When is my next pay review?
Compensation Agent: Your next compensation review is scheduled for June 15, 2026 — that’s 100 days from now.
I’d suggest preparing any discussion points or achievements you’d like to highlight before the review.
Getting a Summary
You: Give me a compensation overview
Compensation Agent: Here’s your compensation summary:
- Pay Type: Salaried
- Total Changes on Record: 3
- Last Change: January 15, 2026
- Tenure: 2.1 years
🔒 This information is confidential.
User Roles & Permissions
| Role | Capabilities |
|---|---|
| Employee | View own current compensation, own history, own review date, own summary |
| Manager | Same as employee (views own data through the conversational interface) |
| HR | Same access through conversational interface; broader access through the Compensation Management module directly |
| Admin | All capabilities plus configure agent settings, enable/disable individual capability gates |
Data access is enforced at the tool level — all queries are scoped to the current user’s employment record and the current business. Compensation history records include the changed_by field for audit purposes but only show the user’s own records.
Configuration
Capability Gates
Admins can enable or disable individual capabilities through the marketplace app configuration:
| Capability Key | Controls | Default |
|---|---|---|
capability_salary_management |
view_current_compensation tool |
Enabled |
capability_compensation_analysis |
view_compensation_history and view_compensation_summary tools |
Enabled |
capability_audit_trail |
view_next_review_date tool |
Enabled |
When a capability is disabled, its associated tools are removed from the agent’s tool set and the LLM will not attempt to use them.
Prerequisites
The Compensation Agent requires the Compensation Management module to be enabled for the business (business.compensation_management_enabled?). If the module is disabled, the agent will not appear in the Ask AI agent roster.
Mobile Support
The Compensation Agent includes mobile web views accessible through the MangoApps native app:
| View | Description |
|---|---|
| Dashboard | Overview with usage statistics, enabled capabilities count, and recent agent actions |
| Capabilities | List of available capability gates and their current status |
| Activity Log | Chronological log of agent actions with filters for status and autonomous/manual source |
The activity log supports infinite scroll pagination and XHR-based partial loading for smooth mobile performance.
Data Privacy & Confidentiality
Compensation data is treated with the highest level of sensitivity:
- All agent responses include a confidentiality reminder advising users not to share compensation information externally
- The system prompt instructs the LLM that all compensation information is CONFIDENTIAL
- Data access is strictly scoped to the requesting user’s own records
- All queries are filtered by the current business to prevent cross-tenant data leakage
- Compensation history includes an audit trail showing who authorized each change
Getting Started
- Verify Prerequisites — Ensure the Compensation Management module is enabled for your business
- Enable the Agent — An admin installs and enables the “Compensation Agent” (
ai-agent-compensation) from the Marketplace - Configure Capabilities — Optionally toggle individual capability gates (all enabled by default)
- Start Asking — Open Ask AI and ask about your compensation
Quick Test Questions:
- “What is my current salary?”
- “Show my compensation history”
- “When is my next pay review?”
- “Give me a compensation summary”
- “How much do I make?”
Related Resources
| Resource | Relationship |
|---|---|
| Ask AI | The Compensation Agent is accessed through the Ask AI conversational interface |
| Payroll | Payroll processing uses compensation data for pay calculations and disbursements |
| Employee Data Management | Employment records (hire date, employment type) feed into compensation tenure and review date calculations |
| Performance Management | Compensation reviews often align with performance review cycles |
