---
title: "First-party Workday agent prerequisites — Kiweely"
description: "UMSA, ASOR domains, unconstrained groups, SKU registration, Flex Credits, and per-tenant setup before any Workday-built agent goes live."
url: https://kiweely.com/guides/workday-first-party-agent-tenant-prerequisites
---

# Workday First-Party Agent Tenant Prerequisites for Implementers

Before a Workday-built agent can be used, each tenant needs ASOR enabled, the right domains on an unconstrained group, UMSA for Workday-built agents, and registration limited to SKUs you obtained.

-   **Checked** against Workday on November 18
-   Applies to **Workday AI**
-   4 min read
-   Published November 18
-   By Kiweely

A Workday-built (first-party) agent does not become usable from a SKU alone. Each tenant needs **Agent System of Record** enabled, ASOR domains on an **unconstrained** security group, **UMSA** for Workday-built agents, and a successful **Register** from agents you actually obtained—then skill configuration and Activate.

-   Checked against Workday on November 18, 2026
-   Applies to Workday AI
-   7 min read

## Prerequisite matrix

| Prerequisite | Why it blocks first-party agents | Workday task / artifact |
| --- | --- | --- |
| ASOR functional area enabled | Hub and agent tasks sit behind ASOR |  **Maintain Functional Areas** → Agent System of Record |
| Pending security activation | Domain enables do nothing until activated |  **Activate Pending Security Policy Changes** (after FA and after group grants) |
| ASOR domains enabled | Hub, manage, compliance, reporting |  **Domain Security Policies for Functional Area** |
| Unconstrained group permissions | Workday currently allows only unconstrained groups on ASOR policies |  **Maintain Permissions for Security Group** |
| OAuth 2.0 capable security environment | ASU private-key credentials | Tenant security posture (Workday stores credentials) |
| UMSA for Workday-built | Required in non-Production and Production for Workday-built agents | Community profile Subscription Service Agreement / Innovation Services opt-in if on MSA |
| SKU entitlement | You can only register agents in SKUs obtained |  **Unregistered Workday Agent** tab emptiness is a signal |
| Flex Credits understanding | Skills meter credits per Rate Card | Platform Consumption Console + Rate Card |
| Per-tenant repetition | No ASOR config migration | Repeat in Implementation, Sandbox, Preview, Production as needed |

## ASOR security domains to grant

After enabling the functional area, enable and permission:

| Domain | Workday’s purpose |
| --- | --- |
| Agent Compliance | Compliance reports and data |
| Agent Management Hub | Central hub for viewing and managing agents |
| Manage: Agents | Configure, activate, deactivate |
| Reports: Agent Reporting | Agent analytics data sources |
| Reports: AI Agent Security | Example: **View AI Agent User Audit Trail** |
| Setup: Agents | Setup tasks and activities |

Also enable **Reports: AI Agent Security** in the System functional area as called out in the set-up guide.

## Agreement and SKU gates

1.  Confirm **UMSA** vs **MSA** on the organization’s Community profile (Workday’s register guide walks the avatar → organization → Subscription Service Agreement value).
2.  On UMSA, keep machine-learning data contributions enabled for full agent functionality per Workday’s UMSA AI concept.
3.  On MSA, plan the Innovation Services opt-in before promising dates.
4.  Open **Agent Management Hub** → **Unregistered Workday Agent** and list only what you will register. Missing agents mean SKU/agreement work, not a skill toggle problem.

## Flex Credits before first Activate

Workday Flex Credits meter defined skills and capabilities on the Rate Card—not tokens. The public Rate Card (last updated November 5, 2026) includes first-party lines such as:

| Agent / offer | Example meter | Credits |
| --- | --- | --- |
| Self Service Agent | Base retrieval / Advanced write | 1 / 5 per request |
| Deployment Agent | Ask skill interaction (IMPL/Sandbox agentic response) | 5 (footnote: uses Flex Credits in non-Production) |
| Adoption Agent | Release Impact Analysis per release note | 10 (same non-Production footnote family) |

Marketing pages describe Complimentary Flex Credits and testing in non-production for most agents. Treat Rate Card footnotes as authoritative when an offer is an exception.

## Sandbox refresh pattern (Deployment Agent example)

Workday’s Deployment Agent setup guide recommends configuring in **Production** so Sandbox refreshes keep the registration—even though the agent is **not** available for interactive use in Production. Chat histories are tenant-isolated and retained 14 days.

To stop Flex Credit burn after a trial: **Agent Management Hub** → **Agent Registry** → agent → **Deactivate Agent**, with **Manage: Agents** and **Setup: Agents**. Deactivate in **every** tenant you configured—including Production if you used the refresh pattern—or Sandbox reactivation follows the next refresh.

## Go / no-go before register

**Go** when ASOR domains are live, an unconstrained admin group can open Agent Management Hub, UMSA covers Workday-built agents for the environments in scope, and the Unregistered tab shows the target agents.

**No-go** when ASOR exists only in Sandbox, Available To groups are constrained-only (unsupported for ASOR policies today), UMSA is unresolved, or stakeholders expect Production conversational use of an agent Workday marks non-interactive there.

## Frequently asked questions

### Do I set up ASOR once for all tenants?

No. Workday says you must set up and configure ASOR in each tenant; there is no current method to migrate those configurations.

### Is UMSA required for Workday-built agents?

Yes for non-Production and Production tenants. Workday says UMSA is not required for self-built agents in non-Production tenants.

### Why configure Deployment Agent in Production if it is not interactive there?

Workday recommends Production setup so Sandbox refreshes keep the configuration. The agent is not accessible for use in Production; deactivate in Production too if you need Sandbox consumption to stay off after refresh.

## Frequently asked questions

### Do I set up ASOR once for all tenants?

No. Workday says you must set up and configure ASOR in each tenant; there is no current method to migrate those configurations.

### Is UMSA required for Workday-built agents?

Yes for non-Production and Production tenants. Workday says UMSA is not required for self-built agents in non-Production tenants.

### Why configure Deployment Agent in Production if it is not interactive there?

Workday recommends Production setup so Sandbox refreshes keep the configuration. The agent is not accessible for use in Production; deactivate in Production too if you need Sandbox consumption to stay off after refresh.

## Sources checked

-   [Set Up Agent System of Record](https://doc.workday.com/admin-guide/en-us/workday-ai/agents/set-up-agent-system-of-record.html)
-   [Register and Configure Workday-Built Agents](https://doc.workday.com/admin-guide/en-us/workday-ai/agents/manage-agents.html)
-   [About Workday Agents](https://doc.workday.com/admin-guide/en-us/workday-ai/agents/setup-considerations--agent-system-of-record.html)
-   [Set Up Deployment Agent in Implementation Environments and Customer Central](https://doc.workday.com/admin-guide/en-us/workday-ai/agents/workday-built-agents/deployment-agent-in-implementation-environments-an/set-up-deployment-agent-on-implementation-environm.html)
-   [Deactivate the Deployment Agent in the Agent Management Hub](https://doc.workday.com/admin-guide/en-us/workday-ai/agents/workday-built-agents/deployment-agent-in-implementation-environments-an/deactivate-the-deployment-agent-in-the-agent-manag.html)
-   [Workday AI Flex Credits](https://www.workday.com/en-us/ai-agents/ai-flex-credits.html)
-   [Workday Flex Credits Rate Card](https://forms.workday.com/content/dam/web/en-us/documents/legal/flex-credits-rate-card.pdf)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Register Workday-Built Agents and Activate Skills in Agent Management Hub After ASOR is on, Workday-built agents still sit on the Unregistered tab until you register them, toggle skills, assign security groups, and activate. This guide is the implementer checklist for that path.](https://kiweely.com/guides/workday-asor-register-activate-agent-skills)
-   [### Set up Workday Agent System of Record for HRIS admins ASOR is the tenant control plane for agents. HRIS admins enable the functional area, activate security twice, and permission an unconstrained group. The configuration does not migrate, so Production, Sandbox, Preview, and Implementation each need the same setup.](https://kiweely.com/guides/workday-asor-setup-for-hris-admins)
-   [### Workday-built AI agents catalog: what each agent is for Use Workday’s Workday-Built Agents reference as the configuration catalog. This guide restates each agent’s published purpose, notes SKU and UMSA gates, and separates marketing names from what Agent Management Hub can register.](https://kiweely.com/guides/workday-built-ai-agents-catalog)
-   [### Workday Flex Credits in Non-Production: What Is Free and What Still Costs Workday says most offers do not draw Flex Credits in non-Production. Deployment Agent and Adoption Agent are documented exceptions. Sandbox dashboards also combine non-Production activity.](https://kiweely.com/guides/workday-flex-credits-non-production-what-still-costs)

### More guides on Custom agents and Workday AI

[All 91 guides](https://kiweely.com/guides#custom-agents)

-   [Deployment Agent in Customer Central vs Implementation tenants](https://kiweely.com/guides/workday-deployment-agent-customer-central-vs-implementation-tenant)
-   [Workday Agent Passport for Implementers: Read Stamps Before You Activate Skills](https://kiweely.com/guides/workday-agent-passport-for-implementers)
-   [Ask skill on but answers feel generic: use CRAFT and “in my tenant”](https://kiweely.com/guides/ask-skill-enabled-still-generic)
-   [Deployment Agent missing? Register it from Unregistered Workday Agent](https://kiweely.com/guides/deployment-agent-not-registered)
-   [Keep Deployment Agent Ask alive across Sandbox refreshes](https://kiweely.com/guides/workday-deployment-agent-ask-after-sandbox-refresh)
-   [Workday Deployment Agent: Q&A Task vs Ask Skill Setup](https://kiweely.com/guides/workday-deployment-agent-qa-vs-ask)
-   [Should each Workday AI integration use its own ISU with no UI sessions?](https://kiweely.com/guides/workday-isu-per-area-no-ui-sessions-for-agents)
-   [How do I secure Workday RaaS access for an internal LLM or AI agent?](https://kiweely.com/guides/workday-raas-for-ai-agents-security)

### From the blog on Custom agents and Workday AI

[All posts](https://kiweely.com/blog)

-   [Workday Agent Gateway vs. User-Delegated MCP Connectors: Prerequisites and Cost](https://kiweely.com/blog/workday-agent-gateway-vs-user-delegated-mcp-connectors)
-   [From One Sentence to a Live Workday Screen: How AI Agents Inspect Your Tenant Before Designing](https://kiweely.com/blog/from-plain-english-prompt-to-live-workday-screen-how-leaf-works)
-   [How to Give Employees Live Workday AI Answers Without Flex Credits or Workday Extend](https://kiweely.com/blog/connecting-ai-to-workday-without-flex-credits-or-extend)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
