Skip to main content
Administrator Guide
Last Updated: 2026-02-06
Download PDF
Register and Configure Workday-Built Agents

Register and Configure Workday-Built Agents

You might need to take additional steps to register and use agents in Production tenants based on your organization's subscription service agreement. Your organization is either on the Main Service Agreement (MSA) or the Universal Main Service Agreement (UMSA). To determine your organization's subscription service agreement:
  1. Select your profile avatar on Workday Community.
  2. Select
    Profile
    .
  3. On your profile page, select your organization's name, which is beneath your name and next to your job title.
  4. View your
    Subscription Service Agreement
    value.
If the value is:
Flex credits are only required for registering and using agents in your production tenants. You will not be able to register and use any agents in production until you’ve opted into these agreements. UMSA is required for non-production and production tenants for Workday-Built agents. UMSA is not be required for non-production tenants for self-built agents.
Security: These domains in the Agent System of Record functional area:
  • Agent Compliance
  • Agent Management Hub
  • Manage: Agents
  • Reports: Agent Reporting
  • Reports: AI Agent Security
  • Setup: Agents
You can register, configure, activate and deactivate Workday agents using the
Agent Management Hub
.
  1. Access the
    Agent Management Hub
    report.
  2. Select the
    Unregistered Workday Agent
    tab.
  3. Click
    Register
    the agent you want to register.
  4. Select the
    Confirm
    check box, and then click
    OK
    to complete the registration.
    Workday moves the agent to the
    Agent Registry
    tab.
  5. Select the
    Agent Registry
    tab and then click on the agent name to configure the agent.
  6. From the agent's profile view, click
    Configure Agent
    .
  7. In the
    Status
    column, make each relevant skill available by enabling the toggle slider.
  8. For each enabled
    Skill
    , populate the
    Available To
    prompt with the security groups that you want to provide access to for that specific skill. The security groups added to the
    Available To
    prompt for an agent establish the agent’s interaction policy.
    The security groups you select in the
    Available To
    prompt must also have permissions to the domain or business process security policies that secure the agents’ tools. You can use the
    View Security for Agent Skill
    report to assist with your agent security configurations. This report shows you detailed information about the agent’s Tools APIs and the respective domain or business process security policies and permissions. At agent runtime, Workday evaluates both user access to the agent and the user access to the APIs the agent is executing as tools.
  9. Click
    Activate
    . You can also optionally save and return to this configuration.
    Agent configuration can be updated at any time. When you activate an agent, the ASU for the agent also activates automatically.
  10. (Optional) When you are done with your agent, you can click
    Deactivate
    to turn it off.
    You can activate, deactivate and reactivate your agents at any time in the
    Agent Management Hub
    . When you deactivate an agent, the ASU for the agent also deactivates automatically.