Leave Management Agent App Overview
Check your leave balances, view pending requests, browse upcoming holidays, see who on your team is off, and manage leave requests — all through natural language conversation in Ask AI.
What is the Leave Management Agent?
The Leave Management Agent is an AI-powered time-off assistant inside MangoApps Workforce. It integrates with the Ask AI sidebar so employees can check their PTO balances, review leave request status, look up upcoming company holidays, see which team members are on leave, and even submit, cancel, or update leave requests — all through natural conversation.
The agent uses an agentic LLM-with-tools architecture with nine specialized tools. Read-only tools (checking balances, viewing holidays) execute immediately, while write actions (submitting, cancelling, or updating leave requests) are flagged as risky and require confirmation or redirect to the Time Off portal for secure processing.
Core Value Proposition:
- Leave Balances — Instantly check available, used, and accrued hours across all leave types (vacation, sick, personal, PTO)
- Request Management — View, submit, cancel, and update leave requests through conversation
- Conflict Detection — Check if team members are already off before submitting your request
- Holiday Calendar — Browse upcoming company holidays with days-until countdowns
- Team Visibility — See which team members have approved leave during any date range
At a Glance
| Leave Balances | Request Management | Conflict Check | Holidays | Team Calendar |
|---|---|---|---|---|
| Available, used, accrued hours per leave type | View, submit, cancel, update requests | Check team conflicts before requesting | Upcoming company holidays | Who is on leave this week |
Perfect For:
- Employees — Quick balance checks and leave request management without navigating through the Leave Management app
- Managers — See team leave calendar and help team members with scheduling around conflicts
- HR / Admin — Configure which leave capabilities the agent exposes and manage leave policies
How It Works
Agent Flow
┌──────────────────────────────────────────────────────────────────┐
│ LEAVE MANAGEMENT AGENT FLOW │
├──────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ Ask AI │───▶│ Context │───▶│ Leave Management │ │
│ │ Sidebar │ │ Router │ │ Agent (Agentic LLM)│ │
│ └──────────┘ └──────────────┘ └──────────────────────┘ │
│ │ │ │ │
│ User asks a Router detects Agent selects the │
│ leave-related leave keywords right tool and │
│ question (PTO, vacation, queries leave data │
│ time off, holiday) │
│ │
│ ▼ ▼ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ TOOL EXECUTION │ │
│ ├──────────────────────────┬───────────────────────────────┤ │
│ │ Read-Only Tools │ Write Tools (Risky) │ │
│ │ ──────────────── │ ───────────────── │ │
│ │ • check_leave_balances │ • submit_leave_request │ │
│ │ • view_leave_requests │ • cancel_leave_request │ │
│ │ • view_upcoming_holidays│ • update_leave_request │ │
│ │ • view_team_leave_cal │ │ │
│ │ • view_leave_usage │ Require confirmation or │ │
│ │ • check_leave_conflicts │ redirect to Time Off portal │ │
│ └──────────────────────────┴───────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────┘
Key Capabilities & Tools
The Leave Management Agent registers nine tools:
| Tool | Description | Risky? |
|---|---|---|
| check_leave_balances | View all leave type balances: available hours, used hours, and accrued hours | No |
| view_leave_requests | View your leave requests with optional status filter (pending, approved, denied, cancelled) | No |
| view_upcoming_holidays | View upcoming company holidays with date, day of week, and days-until countdown | No |
| view_team_leave_calendar | View approved leave for your team (direct reports + self) during a date range | No |
| view_leave_usage_history | View past leave usage for a given year with leave types, dates, and total days | No |
| check_leave_conflicts | Check for scheduling conflicts with department members before submitting leave | No |
| submit_leave_request | Submit a new time-off request (redirects to Time Off portal) | Yes |
| cancel_leave_request | Cancel a pending leave request (only pending requests can be cancelled) | Yes |
| update_leave_request | Update dates or reason on a pending leave request | Yes |
Smart Intent Detection
The agent recognizes leave-related questions through keyword and phrase matching:
| Keywords | Phrases |
|---|---|
| leave, PTO, vacation, time off, holiday, sick day, leave balance, leave request, leave calendar | “who is on leave”, “upcoming holiday”, “leave history”, “how much leave/PTO/vacation” |
Configurable Capabilities
Administrators can toggle capability groups through the app settings:
| Capability | Tools Controlled | Default |
|---|---|---|
| Leave Requests | view_leave_requests, submit_leave_request, cancel_leave_request, update_leave_request, check_leave_conflicts | Enabled |
| Balance Tracking | check_leave_balances | Enabled |
| Holiday Management | view_upcoming_holidays | Enabled |
| Accrual Monitoring | view_team_leave_calendar, view_leave_usage_history | Enabled |
Example Conversations
Checking Leave Balances:
You: “How many vacation days do I have left?”
Agent: “Here are your leave balances:
- Vacation: 64.0 hours available (16.0 used, 80.0 accrued)
- Sick Leave: 36.0 hours available (4.0 used, 40.0 accrued)
- Personal: 16.0 hours available (0.0 used, 16.0 accrued)
You have 3 leave types available.”
Viewing Pending Requests:
You: “Show my pending leave requests”
Agent: “You have 1 pending leave request:
- Vacation: March 24 – March 28 (5 days) — Status: pending
Reason: ‘Family vacation’”
Checking Holidays:
You: “What holidays are coming up?”
Agent: “3 upcoming holidays:
- Memorial Day: May 26, 2026 (Monday) — 80 days away
- Independence Day: July 3, 2026 (Friday) — 118 days away
- Labor Day: September 7, 2026 (Monday) — 184 days away”
Team Leave Calendar:
You: “Who on my team is off next week?”
Agent: “2 team members are on approved leave next week (Mar 10 – Mar 16):
- Sarah Chen: Vacation, Mar 10 – Mar 14
- David Park: Sick Leave, Mar 12 – Mar 12”
Conflict Check Before Requesting:
You: “Check if there are conflicts if I take off March 24 to 28”
Agent: “1 team member is already off during this period:
- James Wilson: Vacation, Mar 22 – Mar 26
Consider checking with your manager if team coverage is sufficient.”
Cancelling a Request:
You: “Cancel my leave request #142”
Agent: “Leave request for Mar 24 – Mar 28, 2026 has been cancelled.”
User Roles & Permissions
| Role | What You Can Do |
|---|---|
| Employee | Check own balances, view own requests, browse holidays, check conflicts, submit/cancel/update own pending requests |
| Manager | All employee capabilities plus view team leave calendar (direct reports) |
| HR / Admin | All capabilities plus configure agent settings and capability toggles |
The team leave calendar scopes to direct reports and self — managers see their team, not the entire organization. All queries are filtered by business.
Mobile Support
The Leave Management Agent includes mobile web views accessible through the MangoApps native app:
| View | Description |
|---|---|
| Dashboard | Agent stats, enabled capabilities count, and recent activity |
| Capabilities | View which agent capabilities are currently enabled |
| Activity Log | Browse past agent actions with status and source filters |
Getting Started
- Open Ask AI — Click the Ask AI icon in your sidebar or navigation bar
- Ask a leave question — Type naturally: “How many vacation days do I have?” or “Who is off next week?”
- Manage requests — Ask to view, cancel, or update pending leave requests
- Plan ahead — Check conflicts and holidays before submitting time-off requests
Prerequisite: The Leave Management module must be enabled for your business. The Leave Management Agent becomes available automatically when Leave Management is active.
Admin Setup:
- Navigate to the Leave Management Agent app in the Marketplace
- Toggle individual capabilities (Leave Requests, Balance Tracking, Holiday Management, Accrual Monitoring) on or off
- All capabilities are enabled by default
Tips & Best Practices
- Check conflicts before requesting — Ask “check for conflicts March 24 to 28” before submitting to avoid scheduling issues with your team
- Review balances first — A quick “what’s my PTO balance?” saves time before planning vacation
- Use status filters — Ask “show my approved leave requests” or “show pending requests” to narrow results
- Plan around holidays — Ask “what holidays are coming up?” to extend weekends with strategic PTO usage
- View history by year — Ask “show my leave usage for 2025” to review past time-off patterns
Related Resources
| Resource | Description |
|---|---|
| Ask AI | The conversational AI sidebar where you interact with the Leave Management Agent |
| Leave Management | The full leave management module with request workflows, approvals, and policy configuration |
| Calendar | Visual calendar view showing your leave alongside shifts and holidays |
| Attendance Agent | AI agent for attendance tracking that complements leave data |
