Scheduling Agent App Overview
Ask about your work schedule, find open shifts, check team availability, and request shift swaps — all through a conversational AI assistant integrated directly into Ask AI.
What is the Scheduling Agent?
The Scheduling Agent is an AI-powered scheduling assistant inside MangoApps Workforce. It connects to the Ask AI sidebar so employees can query their work schedules, browse open shifts, check who else is working on a given day, and initiate shift swaps or drop requests — all through natural language conversation instead of navigating through multiple screens.
Under the hood, the agent uses an agentic LLM-with-tools architecture: when you ask a scheduling question, the AI selects the right tool (view schedule, check availability, find open shifts, etc.), executes it against live business data, and returns a formatted, conversational response. Risky actions like claiming an open shift or dropping a shift require explicit confirmation before execution.
The Scheduling Agent is a core platform agent — it is always enabled when shift scheduling is active for your business.
Core Value Proposition:
- View Your Schedule — Check your shifts for today, this week, or any date range with hours and location details
- Find Open Shifts — Browse available open shifts you can pick up, filtered by date range, location, or role
- Check Availability — See which team members are available on a specific date
- Shift Swaps & Drops — Request shift swaps with coworkers or submit shift drop requests, all through conversation
At a Glance
| Schedule Viewing | Open Shifts | Availability | Swaps & Drops |
|---|---|---|---|
| View your shifts for any date range with times, hours, and locations | Browse open shifts available for claiming | Check team availability by date | Request shift swaps and submit drop requests |
Perfect For:
- Employees — Quickly check upcoming shifts, find extra hours, and manage swap requests without opening multiple pages
- Managers — Check team availability and coverage at a glance through Ask AI
- All Users — Get instant schedule answers in natural language instead of navigating calendars
How It Works
Agent Flow
┌──────────────────────────────────────────────────────────────────┐
│ SCHEDULING AGENT FLOW │
├──────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ Ask AI │───▶│ Context │───▶│ Scheduling Agent │ │
│ │ Sidebar │ │ Router │ │ (Agentic LLM) │ │
│ └──────────┘ └──────────────┘ └──────────────────────┘ │
│ │ │ │ │
│ User asks a Router detects Agent selects the │
│ scheduling scheduling intent right tool and │
│ question and delegates queries live data │
│ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ Response │◀───│ Formatted │◀───│ Tool Result │ │
│ │ in Chat │ │ Answer │ │ (shifts, hours, │ │
│ └──────────┘ └──────────────┘ │ availability) │ │
│ └──────────────────────┘ │
│ │
│ Risky actions (claim shift, drop shift) require confirmation │
│ before execution — the agent asks you to confirm first. │
│ │
└──────────────────────────────────────────────────────────────────┘
Key Capabilities & Tools
The Scheduling Agent registers seven tools that the AI can invoke based on your question:
| Tool | Description | Risky? |
|---|---|---|
| view_schedule | View your work schedule for a date range (today, this week, next week, upcoming 30 days) | No |
| view_shifts | View details of a specific shift by ID or date | No |
| view_open_shifts | Browse available open shifts that can be claimed, with optional location and role filters | No |
| check_availability | Check which team members are available on a specific date and time | No |
| request_shift_swap | Initiate a shift swap request with another employee | No |
| claim_open_shift | Claim an available open shift (requires confirmation) | Yes |
| drop_shift | Request to drop an assigned shift with a reason (requires manager approval) | Yes |
Date Range Intelligence
The agent understands natural date references in your questions:
| You Say | Agent Interprets |
|---|---|
| “today” | Current date only |
| “tomorrow” | Next day only |
| “this week” | Monday through Sunday of current week |
| “next week” | Monday through Sunday of next week |
| “upcoming” or “my shifts” | Next 30 days (default for open-ended queries) |
| Specific dates | “March 15 to March 22” parsed as custom range |
Configurable Capabilities
Administrators can toggle specific capability groups through the app settings. Each capability controls which tools are available:
| Capability | Tools Controlled | Default |
|---|---|---|
| Shift Creation | view_shifts, claim_open_shift, drop_shift, request_shift_swap | Enabled |
| Team Calendar | view_schedule | Enabled |
| Availability | check_availability | Enabled |
When a capability is disabled, its associated tools are hidden from the agent and cannot be invoked.
Example Conversations
Checking Your Schedule:
You: “What’s my schedule this week?”
Agent: “You have 4 shifts this week totaling 32.0 hours:
- Monday: 9:00 AM – 5:00 PM at Main Office (8.0 hrs)
- Tuesday: 9:00 AM – 5:00 PM at Main Office (8.0 hrs)
- Thursday: 7:00 AM – 3:00 PM at Warehouse (8.0 hrs)
- Friday: 9:00 AM – 5:00 PM at Main Office (8.0 hrs)”
Finding Open Shifts:
You: “Show me open shifts I can pick up next week”
Agent: “I found 3 open shifts for next week:
- Monday: 2:00 PM – 10:00 PM at Downtown Store (8.0 hrs)
- Wednesday: 6:00 AM – 2:00 PM at Warehouse (8.0 hrs)
- Saturday: 9:00 AM – 5:00 PM at Main Office (8.0 hrs)
Would you like to claim any of these?”
Checking Team Availability:
You: “Who is working tomorrow morning?”
Agent: “On March 8, 5 team members are scheduled. 10 team members are available, including Sarah Chen (Engineering), Mark Rodriguez (Operations), and 8 others.”
Dropping a Shift:
You: “I need to drop my Friday shift — I have a doctor’s appointment”
Agent: “I’ve submitted your drop request for Friday, March 14 (9:00 AM – 5:00 PM). Your manager will be notified for approval. You can check the status in Shift Drop Requests.”
User Roles & Permissions
| Role | What You Can Do |
|---|---|
| Employee | View own schedule, browse open shifts, check team availability, request swaps, claim shifts, drop shifts |
| Manager | All employee capabilities plus view team schedules and broader availability data |
| HR / Admin | All capabilities plus configure agent settings and capability toggles |
All queries are scoped to the current business — users can only see schedules, shifts, and availability within their organization.
Mobile Support
The Scheduling 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 scheduling question — Type naturally: “What’s my schedule this week?” or “Show me open shifts”
- Follow up conversationally — Refine with “What about next week?” or “Any shifts at the Downtown location?”
- Take action — When prompted, confirm shift claims or swap requests directly in the conversation
The Scheduling Agent is enabled automatically when shift scheduling is active for your business. No additional setup is needed for employees.
Admin Setup:
- Navigate to the Scheduling Agent app in the Marketplace
- Toggle individual capabilities (Shift Creation, Team Calendar, Availability) on or off
- The agent respects published schedules only — draft schedules are not visible to employees
Related Resources
| Resource | Description |
|---|---|
| Ask AI | The conversational AI sidebar where you interact with the Scheduling Agent |
| Shift Marketplace | Browse and claim open shifts through a dedicated marketplace interface |
| Calendar | Visual calendar view of your schedule and team availability |
| Time & Attendance | Clock in/out and attendance tracking that complements scheduling data |
