Self-Service Agent Tools
Each Self-Service Agent skill is made up of different actions a user can take, called tools. Tools are an abstraction layer over Workday APIs that the agent calls to perform tasks.
This topic contains Self-Service Agent tool names, descriptions, and limitations, grouped by the skill they're associated. You can also access the
View Security for Agent Skill
report to view this information, along with security requirements for each tool. Skill and tool configuration changes can take up to 10 minutes to take effect for Self-Service agent due to caching.
This topic includes the tools for these skills:
ESS - Financial Management - Base
Tool | Description | Limitations |
|---|---|---|
find_projects
| Enables users to search for projects they have security access to. Users can search by name, Project ID, tenant-configured lifecycle statuses, and project start or end date ranges. Users can also search for opportunity, billable, and non-billable projects. Results return only active projects unless otherwise specified. Results include basic project header information. When the search parameters match a large number of projects, the tool may return a partial list and request that the user refine their search criteria. | |
view_expenses
| Retrieves and displays expense report line details for an employee, including expense items, amounts, dates, and line statuses. Enables self-service users to look up a specific expense report line directly by its Workday ID or to search for expense lines across all reports. When searching, users can filter by expense item, trip, expense group or line status. | |
view_orders
| Retrieves and displays the comprehensive details of an employee's purchase requisition, including the status of any associated purchase orders and invoices. Enables self-service users to search for a specific requisition to track its downstream procurement progress. |
ESS - Financial Management - Advanced
Tool | Description | Limitations |
|---|---|---|
create_manual_expense
| Enables workers to manually create expense report lines without uploading a receipt or referencing a credit card transaction by specifying details like expense items, dates, worktags, per diems, and amounts. Supports basic parameters such as expense item, date, quantity, unit cost, currency, and amount. Also supports these expense item attributes:
| Doesn't support complex configurations, mileage route tracking, travel journals or itemizations. |
submit_expenses
| Enables workers to submit unsubmitted expense lines that are in a ready to submit status, with options to review details or add a memo for the approver. |
ESS - Help - Advanced
Tool | Description | Limitations |
|---|---|---|
create_a_case
| Enables users to initiate and submit formal support requests to ensure complex issues are documented and routed correctly for resolution. |
ESS - Human Capital Management - Base
Tool | Description | Limitations |
|---|---|---|
get_benefits_decision_support
| Enables workers to request data that assists in the benefits decision-making process based on user input, Workday plan data, and plan eligibility data. Provides answers to questions about benefit plans, retrieves benefit plan definitions, creates comparisons between benefits plans, identifies plans best suited for workers, retrieves changes in plans from prior years, and defines complete benefit concepts. The Self-Service Agent retrieves benefit plan information from these sources in your Workday tenant:
| You must set up and configure Benefits in your tenant to use this tool. See: Steps: Set Up Benefits. You must ensure that all necessary benefit plan details are accessible to employees through the listed sources. We recommend adding any supplemental benefit plan information that isn’t included in the View Benefit Plan task or benefit enrollment instructions, such as deductibles, copays, prescription costs, procedure coverage, and network details, into a policy document for the agent to reference. |
get_my_support_roles
| Retrieves workers assigned to organization support roles, such as HR Partner and Absence Partner, for organizations you're associated with. Each result includes the assignable role, assigned worker, and organization. You can filter by role type or organization name. | View-only. You can't assign or change support roles. Results include only workers with support roles explicitly assigned to your organizations; inherited roles aren't included. Results depend on your security access to workers and organizations. Security: Worker Data: Support Roles domain, in addition to access to the agent skill. |
view_bonus_history
| Retrieves historical data for bonuses and one-time payments, such as spot bonuses and gift cards, for the user. Provides payment amounts, currency, effective or scheduled dates, plan names, bonus percentages, and the formal reason for the payment. Supports queries for the most recent payment, a specific calendar year’s history, or a summary of the three most recent events. Automatically retrieves all records if multiple payments occur on the same date. | Doesn’t display clawbacks, non-bonus plan types, or future/projected payments. |
view_coworker_info
| Searches for a coworker by name and/or worker ID to retrieve professional information such as title, manager, location, and, where permitted by the user's security access, personal contact fields such as home email and home phone. Retrieves 1 profile for each call. | The fields that the agent returns depend on the session user's security access. For example, Home Email and Home Phone fields are returned only when the user has access to those fields.
Doesn't return sensitive personal fields, such as home addresses. Ambiguous names with multiple matches requires user clarification. Doesn't support bulk or list lookups. |
view_dependents
| Retrieves a list of all active dependents for the user, including the dependent's name, relationship type, date of birth, age, gender, and tobacco status. | |
view_my_tasks
| Secured to Core Navigation domain in the Tenant Non-Configurable functional area. Enables users to ask questions about their tasks and returns a read-only list of tasks with a direct link to My Tasks . The Self-Service Agent can call tools in addition to view_my_tasks , such as find_journeys and view_learning_assignments , to answer time-based questions and provide a comprehensive view of a user's immediate priorities. | Doesn't support translations at this time. |
view_my_team
| Retrieves the list of users on the current session user's my-team list, including display names and headcount. This tool retrieves peers under the same manager, not the user's direct reports. | Detailed profile information such as title or contact details is not included; use view_coworker_info for individual details.
Displays an empty team list when the manager has no other direct reports. Doesn't return direct reports; use view_team_members for a user's direct reports and peers. |
view_org_info
| Retrieves organization records for organizations the user belongs to or from a specific name search. Results include organization identifiers, status, and location fields. | Retrieves org-level metadata rather than a member roster; use view_my_team or view_team_members for people-level queries.
Location and address fields are retrieved as stored in Workday with no locale transformation applied. |
view_personal_info
| Retrieves personal information details from the session user's personal and employment profile. Not all profile fields are supported even if they exist. This tool retrieves data for the authenticated session user only; use view_coworker_info for other workers. It uses a read-only GraphQL API with no write capabilities. | Doesn't retrieve fields such as emergency contacts or custom profile.
Date formats and field labels are retrieved as stored in Workday with no locale-based transformation applied. |
view_total_compensation
| Retrieves the user's total base pay, total compensation, pay frequency, and compensation grade, pay range details, and a summary of all stock grants grouped by type and the associated vesting schedule. | Doesn't predict future stock vesting dates or format step progression details beyond the provided string. |
ESS - Human Capital Management - Advanced
Tool | Description | Limitations |
|---|---|---|
add_dependent
| Enables workers to add a dependent with details including:
Initiates a dependent event. | You must also enable the change_personal_info tool in the ESS - Human Capital Management - Advanced skill.Doesn’t support file uploads. |
change_dependent
| Enables workers to edit dependent details including:
Initiates a dependent event. | You must also enable the change_personal_info tool in the ESS - Human Capital Management - Advanced skill.
Doesn’t support file uploads. |
change_home_contact_info
| Enables users to update their home address and personal phone number(s) in Workday.
Supports custom validations. | Doesn't support file uploads.
Managers can't update home contact info on behalf of direct reports. |
change_name
| Enables a user to update their legal name and/or preferred name in Workday only.
Supports custom validations. | Other name components, such as social name and former name, aren't supported.
Doesn't support file uploads such as legal name change certificates. Doesn't support the effective date of a legal name. |
change_personal_info
| Enables a user to update a combination of their citizenship status, date of birth, ethnicity, gender, gender identity, marital status, nationality, place of birth, pronoun, race, religion or sexual orientation. This tool initiates the Change Personal Information business process and enables users to upload attachments. | You must enable View All access and REST initiating action access on the business process security policy. Example: Access the Change Home Contact Information business process security policy and add Employee as self to both the View All and REST initiating action on the business process security policy to enable users to change home contact information using the agent. |
delete_dependent
| Enables workers to delete a dependent. Creates a new dependent deletion event. If the worker doesn't provide a date, the event defaults to today's date as the effective date. | Workers can only delete 1 dependent at a time.
Doesn’t support file uploads. |
request_reference_letter
| Initiates a request for a standard employment verification or reference letter for the current user based on data on file in Workday. | Managers can't initiate reference letter requests for direct reports.
Doesn't support custom language, non-standard fields, client-specific formatting, or custom validations. |
ESS - Payroll - Base
Tool | Description | Limitations |
|---|---|---|
get_my_bank_accounts
| Enables employees to retrieve and view details across their saved bank accounts by entering natural language prompts to access current payment distribution and direct deposit details. | |
get_my_payment_elections
| Enables employees to retrieve and view details across their payment elections by entering natural language prompts to access current payment distribution and direct deposit details. | |
get_my_payment_election_defaults
| Enables employees to retrieve and view details across their default payment configurations by entering natural language prompts to access current payment distribution and direct deposit details. | |
get_my_payslips
| Enables employees to retrieve and view details for their issued payslips, gross and net pay amounts, and pay period summaries by entering natural language prompts to access current paycheck and earnings information. | |
get_tax_elections
| Retrieves the current worker's payroll tax withholding elections. Returns the election in effect for each supported tax authority, for each company where the worker is active as of the specified date. If effectiveDate in yyyy-mm-dd format is omitted, returns elections as of the current date. You can filter results to one or more companies using company. | Requires security permissions for the user or integration system under the Self-Service: Payroll (My Withholding Elections) - USA orSelf-Service: Payroll (My Withholding Elections) - Canada domains.Your API client or agent workflow must invoke the payrollElectionsForESS resource using the required worker parameter, with optional parameters for Effective Date and Company. |
model_my_pay
| Enables hourly workers to model and plan for possible pay change scenarios.
Example prompts:
Retrieves hourly payroll result lines if the pay component includes rate and hour pay component related calculations. | Workers must have at least 1 completed pay period with hourly pay to prompt the agent successfully. |
view_direct_deposit
| Retrieves user's bank accounts and direct deposit information used in payment elections, including the default country and currency. | Doesn't provide information about payment elections that aren't associated with a bank account. |
view_next_paydate
| Retrieves the next payroll payment date for on-cycle payments for a user’s primary pay group. | Available only for Australia, Canada, France, Ireland, UK, and USA.
Additional configuration is required for workers assigned to a Payroll Interface pay group. |
view_tax_form_details
| Enables workers to query specific box values and access details across U.S. W-2 Wage and Tax Statements (including original W-2 and corrected W-2c forms).
Example prompts:
| Workers must have at least 1 issued U.S tax form (W-2 or W-2c) to prompt the agent successfully. |
Enables workers to access year-end tax document details across Canadian tax forms (T4, T4A, T4A-RCA, RL-1, RL-2, and NR4).
Example prompts:
| Workers must have at least 1 issued Canadian tax form (T4, T4A, T4A-RCA, RL-1, RL-2, or NR4) to prompt the agent successfully. |
ESS - Payroll - Advanced
Tool | Description | Limitations |
|---|---|---|
add_bank_account
| Enables employees to retrieve country-specific account field requirements and submit new bank account details by entering natural language prompts to configure their account information for payroll. | |
remove_bank_account
| Enables employees to delete unused bank account details by entering natural language prompts, including built-in validation logic to prevent removing accounts currently in active use. | |
update_payment_elections
| Enables employees to modify payment election distribution rules and account allocations by entering natural language prompts to update their direct deposit preferences. |
ESS - Talent Management - Base
Tool | Description | Limitations |
|---|---|---|
continue_journey
| Enables the user to advance through a journey by marking the steps as complete or incomplete. | |
distribute_journey
| Enables employees to distribute journeys themselves. | |
find_internal_jobs
| Enables users to search approved internal job postings using job title keyword matching or structured filters such as company, time type, location, remote work type, hiring manager, spotlight job status, management level, job category, job family, job type, and supervisory organization. | Keyword matching is restricted to job titles. Doesn't search full job description text or infer roles from coworker profiles. |
find_journeys
| Enables users to search, filter, and retrieve available journeys. This tool displays details for self-service and distributed journeys, and provides specific journeys details when prompted. | |
view_continue_learning
| Enables learners to view active, incomplete learning records, including in-progress standalone lessons and active courses that are in progress or not yet started. | Only returns the learner's records and doesn't include completed learning or transcript history. |
view_feedback
| Displays feedback the user has received (both unsolicited anytime and requested) along with the status of pending requests. Includes the date, the provider, and the feedback content with options to filter by date or person. Managers can also view a summary count of feedback requests for their direct reports. | |
view_learning_assignments
| Enables learners to view their open, incomplete, or currently in-progress assigned learning by due date. Learners must specify if they want required assignments. | |
view_learning_content
| Enables learners to search and browse active learning content they can access by keyword, topics, skills, content type, language, location, or recent updates. | Doesn't filter results by certification, course offering assessors, course offering locations, rating, or unit type. |
view_my_goals
| Retrieves submitted individual goals for the user, including status, due date, category, and organization alignment. | Doesn't support date range filtering milestones, or cascaded goals. Doesn't retrieve archived goals. |
view_my_learning_transcript
| Enables learners to view learning records from their transcript, including enrolled, in progress, and completed learning content with completion status, dates, scores, and grades.
Filters the results by content, completion status, record type, and expiration date. | Only returns learner's records and returns an empty list when no transcript records exist or when viewing the learning transcript is disabled for the learner.
Doesn't filter results by registration status, date enrolled, attendance status, grade, score and record type. |
view_org_goals
| Retrieves an organization's goals for a specified date range, defaulting to the current user's primary-job supervisory organization.
Provides goal names, descriptions, completion percentages (0–100), and parent goal references. | Limited to active supervisory organizations.
Doesn't support searching by name or description. |
view_performance_review
| Retrieves the user's completed or in-progress performance reviews. Only retrieves overall ratings for managers and employees for each section. Users can filter the list by status. | Doesn't display the manager or employee's overall comments. Only retrieves overall ratings for managers and employees for each section. |
view_recommended_learning
| Enables learners to view learning content, including courses and programs, ranked by how well each item matches the learner's profile and learning history. Returns up to 40 ranked items per request. | Returns no recommendations when the organization hasn't enabled the required ML data contributions for learning recommendations, or when no recommendable content is available. |
view_talent_profile_details
| Retrieves specific talent profile sections, such as job history, skills, and education for the current user or another worker by their name or ID. |
ESS - Talent Management - Advanced
Tool | Description | Limitations |
|---|---|---|
create_referral
| Enables users to submit a referral for an external candidate to 1 or more job requisitions using job requisition IDs such as candidate's name, country, contact details, optional address, and notes. The specified job requisition ID must be for an active, non-confidential job requisition posted externally. This tool doesn't support resume or file uploads and doesn't display the referral status after submission. Additionally, the submission may fail if country-specific candidate consent is missing. | Doesn't support resume or file uploads.
Doesn't display referral status after submission. Doesn't support custom validations. Submission might fail when referral consent for certain candidate countries is missing. |
manage_goals_for_self
| Enables the user to create, delete, edit, submit, or archive their own individual goals through the Manage Goals business process. The user is shown a summary of the proposed changes to review and confirm before submitting. | Doesn't support saving goals or updating saved goals. |
manage_job_history
| Enables employees to add, edit, or delete entries in their job history through a conversational interface. When you:
| Employees can’t use the tool to:
If you opt into the Career Profile and inactivate the Job History section using the Configure Career Profile task, employees can still use this tool to update their job history without using the Manage Job History business process. In this case, Workday recommends disabling the tool to enforce approvals and custom validations on the business process. |
request_feedback_self
| Enables users to request feedback from other users by selecting specific feedback templates and determine whether the responses should be private to them or visible to others. | |
start_performance_review_self
| Initiates a performance review request through the Start Performance Review business process security policy. Enables the user to start a performance review based on a review template and review period start and end dates. Once initiated, you must complete any further interactions through the Workday UI. This tool only supports starting performance reviews for the processing user and review types that allow employee self-initiation. | Doesn't support custom validations. |
ESS - Workforce & Frontline Management - Base
Tool | Description | Limitations |
|---|---|---|
absence_types
| Users must have access to the Request Leave for Self or Request Leave of Absence (REST Service) initiating actions on the Request Leave of Absence business process, or the Request Time Off for Self or Request Time Off (REST Service) initiating actions on the Request Time Off business process for the Self-Service Agent to use this tool.Enables workers to view the absence tables, leave types, and time offs they’re eligible for and secured to request. | Doesn’t support absences and time offs that can't be entered through the standard process, such as those enabled only for time tracking, forfeiture adjustments, or selling. |
my_absences
| Enables workers to view their past, present, and future time off requests and event details. | Doesn't retrieve cancelled or denied time off entries. Doesn't return leave of absence requests or event details. Doesn't support viewing time off for direct reports or other workers. |
time_off_balance
| Retrieves and displays the user's time off balances as of an effective date. | Doesn't return time off carryover, expiring accrual balances, or expiration details. |
view_holiday_calendar
| Retrieves the user’s company holiday calendar events for a specified date range. | While the tool identifies the holidays, it doesn't return the specific duration of the holiday calendar event. |
view_my_shifts
| Enables workers to view their shifts. | |
view_my_upcoming_shifts
| Enables workers to view all scheduled shifts in the date range, filtering out shifts with existing absence requests or that were previously called out. | |
view_time_blocks
| Displays all recorded time blocks for a specified date range for the user. | Results are limited to the first 20 time blocks per request. |
ESS - Workforce & Frontline Management - Advanced
Tool | Description | Limitations |
|---|---|---|
accept_shift_swap
| Secured to the Accept Shift Swap (REST Service) initiating action on the Accept Shift Swap business process in the Scheduling functional area. Enables workers to review, accept, or reject a pending shift swap request proposed by a coworker. Strictly for responding to existing requests. | Doesn't initiate new swaps or display other pending items in the worker's My Tasks. |
bid_to_cover_shift
| Enables workers to submit a bid to cover an open scheduled shift for themselves. This action submits the bid for manager or scheduler approval and is restricted to eligible scheduled workers. | |
call_out
| Initiates call out for a set of shifts. This submits a request for time off for those shifts, then contacts the shift managers and initiates the process to fill the shifts. | |
call_out_no_absence
| Initiates call out for a set of shifts. This contacts the shift managers about those shifts and starts the fill shift process for each, but doesn't submit a request for time off. Used by workers without absence management or when a time off request has failed and the call out should proceed without trying to correct the issue. | |
cancel_absence
| Users must have access to the Correct Time Off Entry (REST Service) initiating action on the Correct Time Off business process for the Self-Service Agent to use this tool.Enables workers to cancel or delete an approved time off entry. Also supports the cancellation of in-progress time off request and correction events. | |
change_work_availability
| Users must have access to the Change My Work Availability (REST Service) initiating action on the Change Work Availability business process for Self-Service Agent to use this tool. Enables workers to update their work availability by specifying available days of the week and distinct time slots. | This tool only updates availability and can’t be used to modify schedule preferences or currently published shifts. Doesn't support overlapping time slots on the same day. Managers can't use this tool to update availability on behalf of workers. |
cover_shift
| Enables workers to request to cover an open scheduled shift for themselves. Restricted to eligible scheduled workers. | |
delete_time_blocks
| Enables users to delete time blocks but doesn’t enable edits or other changes. | Limited to 50 time blocks and a 1-week date range. |
edit_absence
| Users must have access to the Correct Time Off Entry (REST Service) initiating action on the Correct Time Off business process, or the Request Time Off (REST Service) initiating action on the Request Time Off business process for the Self-Service Agent to use this tool.Enables workers to edit an approved time off entry. Supports modifications to quantity, start and end times, time off type, position, and reasons for both standard time off and absence tables. Supports custom validations. | Doesn't support corrections to worktags. Doesn't display warnings. |
enter_time_block
| Enables a user to create time entries for 1 or more days using quantity-based entries (# of hours) or in/out time-based entries (specific times of day). | Doesn't support worktag entry or project-based time entry codes.
Doesn't support time blocks requiring worktag selection, such as cost center, location, or division. |
my_shifts
| Enables workers to view their scheduled shifts. Supports retrieving, summarizing, aggregating, sorting, and filtering past or upcoming shifts across custom date ranges, as well as answering targeted questions like "When is my next shift?" | |
open_shift
| Enables workers to open their own published shift and place it on the Open Shift board. | |
request_absence
| Users must have access to the Request Time Off (REST Service) initiating action on the Request Time Off business process for the Self-Service Agent to use this tool.Enables workers to initiate a:
| Doesn't support time off requests with worktags configured, or leave of absence requests with position-based leaves. Doesn't display warnings. Doesn’t account for the configured daily default quantity or the worker’s scheduled hours when proposing time off for hours-based absence types. Doesn’t support adding attachments when requesting a leave of absence or time off. The request_time_off tool treats 1 day as 8 hours. |
request_shift_swap
| Users must have access to the Request Shift Swap (REST Service) initiating action on the Request Shift Swap business process for the Self-Service Agent to use this tool. Enables scheduled workers to initiate a request to swap one of their published shifts with a qualified coworker. The selected coworker must share a matching schedule tag and belong to the same scheduling organization. | Doesn't post shifts to the Open Shift board or request coverage for open shifts. Restricted to coworkers with matching schedule tags. |
shift_check_in
| Enables a user to clock in at the beginning of their shift to start recording worked time. The tool automatically resolves available time entry codes and positions. | Doesn't support worktag entry or project-based time entry codes; users requiring worktags can't complete check-in through this tool. |
shift_check_out
| Enables a user to clock out of their shift, either for a break or for the end of their shift, to stop recording their worked time. | |
submit_time
| Submits a user's timesheet for review and approval for a single date. Includes all time entries for the full time period the date falls within. For example, any date within a weekly pay period will submit the entire week. | Doesn't support custom validations. |
update_time_block_comment
| Adds or updates a comment associated with a specific time block. | Doesn't support editing any other fields on the time block, such as time type or quantity. |
Global Search Answers
The Global Search Answers skill uses these tools, which are also available in other Self-Service Agent skills:
- find_jobs
- get_tax_elections
- view_bonus_history
- view_candidate_status
- view_dependents
- view_direct_depost
- view_direct_reports
- view_direct_reports_info
- view_feedback
- view_learning_assignments
- view_learning_content
- view_my_goals
- view_my_learning_transcript
- view_org_goals
- view_performance_review
- view_tax_form_details
- view_team_goals
- view_team_learning_status
- view_team_performance_review
- view_total_compensation
Guide
Tool | Description | Limitations |
|---|---|---|
get_user_context
| Retrieves the user's full name, business title, work location, hire date, and manager. This foundational context is utilized by the agent to deliver more personalized, tailored responses for individual self-service interactions. | |
get_page_context
| Retrieves the contents of the page the user currently has open on the Workday desktop application. Enables users to ask the agent questions about the page they’re on without having to provide page details. This tool is used when the user has both a page open and the agent chat open on the Workday desktop application. | Doesn’t apply to mobile or Workday Everywhere. |
MSS - Human Capital Management - Base
Tool | Description | Limitations |
|---|---|---|
get_worker_support_roles
| Retrieves workers assigned to organization support roles, such as HR Partner and Absence Partner, for a direct report you specify across organizations the worker is associated with. You can identify the worker by name. Each result includes the assignable role, assigned worker, and organization. You can filter results by role type or organization name. | View-only. You can't assign or change support roles. You can view results only for direct reports you have access to. Results include only workers with support roles explicitly assigned to organizations; inherited roles aren't included. Results depend on your security access to workers and organizations. Security: Worker Data: Support Roles domain, in addition to access to the agent skill. |
view_direct_reports_info
| Retrieves professional profile information, such as anniversary dates, birthdays, promotion history, and tenure, for a manager's direct reports or a specific worker. | Provides data for direct reports only, not skip-level reports.
Managers with large teams might experience higher response volume. Depending on an individual's employment record, some fields might not populate. |
view_team_members
| Retrieves the names of people on the current user's team. If the user has no direct reports, or asks about peers or teammates, returns coworkers who share the same manager, plus the user's manager when available. | For managers, only provides data for direct reports, not skip-level reports. Returns names only.
For broader organization hierarchy context, use view_org_info instead or consider asking your question in another way.For richer profile data on direct reports, use view_direct_reports_info or view_coworker_info instead. |
view_worker_history
| Retrieves employment-related details for events such as hire, job change, and compensation for the user or a named worker within a specified date range. Each invocation retrieves a single event category. | When a name is provided, the worker must be part of the manager's reporting structure.
When multiple or zero matches are found for a name, the tool returns an error rather than a list. |
MSS - Human Capital Management - Advanced
Tool | Description | Limitations |
|---|---|---|
initiate_change_ job
| Enables the user to initiate a Change Job event using a change job template that includes the Workday Assistant / Rest API initiating action. Automatically chooses the appropriate change job template based on the information the user provides. Collects and submits change job data, or provides a link to a pre-populated Change Job event that users can complete themselves in Workday. Use when a manager wants to initiate a job change such as a change in location, business title, or job profile for a worker.
You must configure the Workday Assistant / REST API initiating action in the Select Initiating Actions field on the Maintain Change Job Templates task to use this tool. See Set Up Change Job Templates for more information.Access the View Security for Agent Skill report (secured to the Manage: Agents domain in the Agent System of Record functional area and the Security Administration domain in the System functional area) to view all security requirements for this tool. These include:
| Doesn’t support file uploads, and federal or academic detail fields.
Provides a link to the Change Job events that require sub-business processes. Doesn’t allow you to complete the event in the chat. Example: You’re initiating a change job template with the Change Organization Assignment business process configured in the Select Subprocesses for Template field. |
MSS - Payroll - Advanced
Tool | Description | Limitations |
|---|---|---|
request_payroll_input
| Enables managers to identify eligible workers, retrieve available pay components, and submit payroll input requests for eligible team members by entering natural language prompts to streamline payroll input management. | Doesn't support custom validations. |
MSS - Talent Management - Base
Tool | Description | Limitations |
|---|---|---|
find_job_requisitions
| Enables hiring managers to view job requisition information they have access to. Displays open job requisitions that includes status, supervisory organization, location, and openings filterable by supervisory organization and requisition type (standard or evergreen).
Displays in-progress requisition creation events awaiting approval, showing their current approval stage, filterable by supervisory organization. Access to in-progress events is secured to the View All and View Completed Only security policies of the Job Requisition business process. | Require proper access for evergreen requisitions.
Doesn't support searching or applying for jobs as a candidate. |
find_my_candidates
| Enables managers to retrieve candidate profiles, application stages, and qualification details for job requisitions where they are assigned as the hiring manager. Supports free-text search by candidate name or candidate ID, as well as filtering by application stage, type, skills, job profile, job family, job requisition, experience duration, do-not-hire status, withdrawn status, and closed or frozen job status. | |
view_team_goals
| Retrieves up to 100 goals for a manager's direct reports, grouped by worker and completion status. Only supports retrieving submitted individual goals and filters for status, keywords, and due dates. | Doesn't support filters for milestones, categories, or specific target and actual currency fields. |
view_team_learning_status
| Retrieves learning records such as completion, grade, and expiration for a manager's direct team. | Only provides data on learning activities in which the team has already formally enrolled; assigned but not-yet-enrolled training is excluded.
Doesn't support filtering by due dates or individual learners. |
view_team_performance_review
| Retrieves high-level review metadata and overall ratings for the supervisory organization the manager leads. | When a manager leads multiple organizations, only the first supervisory organization is retrieved.
Doesn't support non-overall section ratings or comments. |
MSS - Talent Management - Advanced
Tool | Description | Limitations |
|---|---|---|
add_goal_to_employees
| Managers must have access to the Cascade Goal (REST) initiating action on the Cascade Goals business process for the Self-Service Agent to use this tool. Enables managers to create 1 or more goals and assign them to multiple employees through the Cascade Goals business process for named workers, organization members, or talent pool members. | Doesn’t manage an individual worker's personal goals or view existing goals, and only supports managers with permission to cascade goals; available goal fields depend on tenant configuration. |
create_job_requisition
| Enables hiring managers and recruiters to create job requisitions for existing filled or unfilled positions, either by selecting an active worker or a worker terminated within 90 days for backfill, or by specifying a position ID. Also enables users to customize requisition details directly in the agent chat session. Completing the chat workflow generates a direct link to review and revise details before submission. | Doesn't support contingent workers. |
create_organizational_goal
| Enables a manager or authorized user to create a new organizational goal for a specific supervisory organization within a designated goal period. The tool supports defining an optional description, privacy configurations, supporting initiatives, alignment to higher-level organization goals, and metrics for completion tracking. | |
manage_goals_for_worker
| Enables a user to create, edit, delete, submit, or archive individual goals for a worker the processing user has access to through the Manage Goals business process. The user is shown a summary of the proposed changes to review and confirm before submitting. | Doesn't support saving goals or updating saved goals. |
start_performance_review_worker
| Starts a new Employee Review business process for a manager's single direct report or for their entire team. | While you must select a template and period dates, you can only use 1 template when starting reviews for all direct reports simultaneously.
Doesn't support custom validations. |
request_feedback_worker
| Enables a manager to request feedback about a worker from other users. Users can select specific feedback templates and determine if the responses should be confidential or visible to others. | |
update_organization_goal
| Enables a manager or authorized user to update the details of an existing organizational goal, including its name, description, privacy settings, higher-level organization alignments, and completion tracking metrics. This tool appends new supporting initiatives to the existing list and allows modifying alignments, but it does not support changing the goal's owning organization or its designated goal period. |
MSS - Workforce & Frontline Management - Base
Tool | Description | Limitations |
|---|---|---|
view_my_direct_reports_absences
| Enables managers to view time off event details for their direct reports. | Doesn't reference your team absence configuration. Doesn't retrieve cancelled or denied time off entries. Doesn't support viewing time off for workers who aren't direct reports or matrix reports of the manager. |
view_submitted_time_entries_workers
| Retrieves submitted time entries for multiple workers. | Displays a maximum of 60 records, with 20 records per page. |
view_time_blocks_workers
| Retrieves time blocks for multiple workers. | Displays up to 100 time blocks for a maximum of 20 workers for a maximum date range of 1 month.
Doesn't display project time entry details. |
view_time_clock_events
| Enables managers to view time clock events for workers on their team or direct reports, including check-in, check-out, meal, break, and out-for-lunch punch history. Managers can ask who on their team is currently checked in or out, retrieve event history for a date or date range, and filter by event type or worker. | This tool retrieves time clock event data only and doesn't enable edits, additions, or deletions. Limited to 20 workers, 100 time clock events, and a 31-day date range per request. When a query exceeds these limits, Workday returns a partial list and indicates that more records are available. |
MSS - Workforce & Frontline Management - Advanced
Tool | Description | Limitations |
|---|---|---|
approve_time_entries
| Enables a user to approve time entries for multiple workers. | Displays a maximum of 60 records, with 20 records per page. |
create_time_blocks_workers
| Enables a user to create time blocks for multiple workers. | For a maximum of:
Doesn't support projects or worktags. |
delete_time_blocks_workers
| Enables a user to delete time blocks on behalf of workers in bulk. This tool doesn’t enable edits or other changes. | For a maximum of:
|
deny_time_entries
| Enables a user to deny time entries for multiple workers. | Displays a maximum of 60 records, with 20 records per page. |
edit_time_blocks_workers
| Enables a user to edit time blocks on behalf of workers in bulk. They can edit in/out times, quantity, and comment fields. Example: A user can change 07:00-14:00 to 08:00-16:00 or can change a quantity block from 8 hours to 6 hours. | This tool can't edit other fields. Edits a maximum of 10 workers and 50 time blocks. |
send_back_time_entries
| Enables a user to send back time entries for multiple workers. | Displays a maximum of 60 records, with 20 records per page. |
shift_check_in_workers
| Enables managers to check in 1 or more workers on their team or direct reports at the current time, at a specified time in the future, or for a previous date. When you specify time entry codes, managers can apply different codes for different workers in the same request. Workday excludes workers who aren't eligible to check in, such as hours-only workers, and returns partial results when a bulk request includes ineligible workers. Workday requires manager confirmation before creating check-in time clock events. | Doesn't enable check-out, edits, deletions, or time transfers. |
shift_check_out_workers
| Enables managers to check out 1 or more workers on their team or direct reports for the day, for a meal, or for a break at the current time or at a specified time. Managers can check out their entire team or direct reports in a single request. Workday creates check-out time clock events for workers who are eligible for the requested out type, and returns partial results when a bulk request includes ineligible workers or out types a worker can't use. Workday requires manager confirmation before creating check-out time clock events. | Doesn't doesn't enable check-in, edits, deletions, or time transfers. |
MSS - Workforce & Frontline Management - Premium
Tool | Description | Limitations |
|---|---|---|
confirm_or_reject_shift
| When a manager gets worker recommendations for a shift, this tool contacts a chosen worker to request that they pick up the shift. If a different worker was offered the same shift with this tool, it rescinds the offer from that worker to make it to the new replacement worker. | |
get_next_worker_recommendations
| Gets recommended workers for an open shift. If the agent has already gotten workers for this shift, it will fetch recommendations again and move past the previously recommended workers. | |
post_open_board
| Posts the shift to the Open Shift board and closes the fill shift process. |
MSS - Workforce & Frontline Management - Utility
Tool | Description | Limitations |
|---|---|---|
reassign_shift
| Reassigns the shift to the worker who has agreed to cover a shift that the original worker has called out for and closes the fill shift process. |
Policy Intelligence
Tool | Description | Limitations |
|---|---|---|
search_policy_documents
| Retrieves company policy and procedural information from Help Knowledge Base articles to ensure responses are accurate and based on official documentation.
We recommend that you opt in to the service on the Innovation Services And Data Selection Opt-In report before you sign the UMSA or change your data hosting region. This prevents a 14 day waiting period for Self-Service Agent to ingest your policy documents. | Doesn't extract data from articles in Sandbox environments. We recommend using IMPL tenants instead for test cases related to this.
Doesn't read document attachments or linked documents in help articles. Only reads the text of the article itself. |