---
nav: wcp_docs
parent_url: /wcp_docs/
title: Build an AI Agent in Workday
layout: subsection
---

In this activity, you'll use Extend's Developer Agent to build your own custom agent. Using plain language, you'll prompt the Developer Agent to help you design, generate, and refine the agent. You will go from an idea to a working agent in just a few minutes.

You'll see how you can take ideas from concept to prototype much faster. You spend less time on boilerplate and setup, and more time on solving real business problems for your organization and customers. Discover what you can build!

## <a id="before-you-begin"></a>Before You Begin: Create an Account on the Workday Build Platform

To do this activity, you must have an account on the Workday Build platform and a development tenant. If you’ve already created an account and a tenant, you can go to the first task of this activity.

If you haven’t already created an account, you can do so now. It’s free!

1.  Go to the [Workday Build Platform](https://developer.workday.com) and create an account with your personal email address.
2.  Once you have created an account, sign in to the [Workday Build Platform](https://developer.workday.com).
3.  In the upper-left corner, select the hamburger menu, and under <b>Console</b>, select <b>Tenants</b>.
4.  On the <b>Tenants</b> page, select <b>Create Tenant</b>. It will take 1 to 2 minutes for the development tenant to be created.
5.  Check your personal email for a link to change your tenant password.

    <b>Note:</b> Remember the password. You’ll need to sign in to the tenant while you do this activity.

6.  Sign in to the tenant with the username <i>lmcneil</i> and the password that you just created.


<b>Note:</b> When you sign in to the development tenant with the username <i>lmcneil</i>, you’re signing in as the persona <i>Logan McNeil</i>. Logan is one of several user accounts that you can use to test the agents and app that you create and deploy to your development tenant.

## Task #1: Create an Agent and Connect It to Your Tenant

In this activity, you’ll build a custom Agent that reviews a worker’s skills, experience and performance, then matches them to open internal roles and flags their skill gaps. It turns those gaps into a targeted development plan, helping employees and HR speed up career growth and internal mobility without the manual effort.

In this task, you'll launch App Builder and connect it to your development tenant.

1.  On the <b>Workday Developer Platform</b> home page, select <b>Build Custom Agents</b> and then select <b>Build with Developer Agent</b>.
2.  In the Name field, enter <i>Talent Profile Agent-<your first name and last initial></i>. For example, <i>Talent Profile Agent-ZoeB</i>. The Reference ID will automatically populate based on the app's name.
3.  Select <b>Create and Build with Developer Agent</b>. This will launch App Builder.
4.  Select <b>Connect to Tenant</b>.
5.  In the Manage Tenant Connections pop-up window, select your tenant alias and select <b>Connect</b>.
6.  Sign in to the tenant:

    -   Username: <i>lmcneil</i>
    -   Password: <i>< password you created for your development tenant ></i>



✅ <b>Expected result:</b> At the top of the App Builder screen, the Manage Tenant Connections icon should have a little green dot next to it. This means you're connected to the development tenant.

For testing purposes, you are signed in to the tenant as Logan McNeil, a fictional Vice President of Human Resources. Your development tenant contains mock users, data, business processes, and other resources that enable you to test your agents, apps, and integrations in an environment similar to production Workday environments.

![](GUID-761f64d8-c14c-42b7-a96f-93d9a050f5be.png)

## Task #2: Use Developer Agent to Configure the Agent

Developer Agent is an AI-powered assistant that can help you translate requirements into agent designs, generate prompts and tool schemas, write integration code, debug behavior, test workflows, and recommend improvements for reliability, safety, and performance.

In this task, you’ll give the Developer Agent a prompt that will define the agent’s goal and behaviors.

1.  Copy the prompt shown below.

    ```
    Build an agent that creates a talent profile snapshot for a worker. Goal: Give the end user a complete view of a worker's talent profile in a single snapshot. Functional Requirements: * Pull in the worker's skills, education, job history, and performance information. * Include any other relevant details that are available. * Assemble everything into a single snapshot that is easy to read.
    ```

2.  In the <b>What do you want to build?</b> box, paste the prompt and press <b>Enter</b>. After a few moments, the Developer Agent will generate the configuration, system prompt, and skills for the new agent.
3.  Review the generated components. In the left-hand <b>Components</b> panel, you should see two new components: an Agent and a Skills file.

    <b>Note:</b> You may have more than one skills file; that's OK!

4.  In the left-hand Components panel, in the Agents section, select <b>talent-profile-agent</b>. (The agent generated for you may be named a little differently.) Notice that the agent includes a description, a skill, system prompt, and guidelines for creating a talent profile snapshot for employees
5.  If you’re satisfied with the code, select <b>Apply Changes</b>.
6.  When the <b>Apply Changes…</b> pop-up window appears, select all the components and then select <b>Confirm</b>.


✅ <b>Expected result:</b> Developer Agent should have generated a document that defines the system prompt, workflow steps, and guidelines for behavior. It should also create skills that define the specific capabilities of the agent.

![](GUID-3e0b9d27-10e5-4205-9f34-f7a28cc7f429.png)

## Task #3: Validate, Deploy, and Register Your Agent

In this task, you’ll give the agent a unique name, validate it for errors, deploy it to the development tenant, and register it in Workday’s <i>Agent System of Record (ASOR)</i>. ASOR is a centralized platform for managing an organization’s AI agent workforce. It helps companies discover, register, configure, monitor, govern, and manage Workday-built, partner-built, and third-party agents securely at scale.

1.  In the right-hand <b>Components</b>panel, hover over the talent profile agent, select the horizontal ellipses and select <b>Rename</b>.
2.  In the <b>Rename Agent</b> pop-up window, change the name to <i>talent-profile-agent-hr</i>.
3.  Select <b>Done</b>.![](GUID-f44b4a8f-74c4-4f61-9d6f-d5632b64e395.png)
4.  Select your <b>talent-profile-agent-hr</b>. You’ll see the Agent Definition in the content window.
5.  In the Agent Definition, locate the agent’s <b>Name</b> and change the name to <i>talent-profile-agent-hr</i>. The name <i>must</i> match the name of the agent in the components panel.
6.  Scroll down to the Model field and you’ll see that it’s set to <b>Auto - Base</b>. If you subscribe to Extend AI, you can select from other Large Language Models (LLMs) to power your agent.
7.  At the top of the App Builder page, select <b>Validate</b>. This will check for any errors. There should not be any validation errors, but if there are, review and correct them. If you aren’t certain how to correct them, try asking Developer Agent!

    <b>Note:</b> The expectation is no errors will occur, but given the non-deterministic nature of AI, it is possible for an error.

8.  Select <b>Save and Deploy</b>, select your tenant alias, and select <b>Deploy to Tenant</b>. If necessary, sign in to the tenant.
9.  When the Deploy Successful pop-up window appears, select <b>View Agent Registry</b>. This will take you to the Agent Registry in your tenant's Agent Management Hub.![](GUID-dbc7fe66-789e-495c-abe6-21d7d0aa62d0.png)
10. In the Agent Registry, find and select your agent: <i>talent-profile-agent-<your first name and last initial></i>. This will launch the View Agent page, where you can see a description of your agent and additional tabs to view skills, analytics and monitoring.
11. On the <b>View Agent</b> page, select <b>Configure Agent</b>.
12. Select the <b>Status</b> toggle to turn on your agent.
13. In the <b>Available To</b> field, search for and select <i>HR Administrator</i>. This enables members of the selected security group to access and use that skill through the agent.
14. Select <b>Activate</b>, and when the <b>Agent Activation</b> pop-up window appears, select <b>Activate</b> again.


✅ <b>Expected result</b>: On the View Agent page, you’ll see that your agent is now active and ready to use!

![](GUID-dc541c8b-321e-4620-b425-bc9bf594f988.png)

## Task #4: Test the Agent

Let’s test your agent.

1.  In the development tenant, refresh the <b>View Agent</b> page.
2.  In the top-right corner of the development tenant, select the <b>Agent Chat</b> icon.
3.  At the top of the <b>Agent Chat</b> window, choose your talent profile agent from the dropdown menu.
4.  In the <b>Chat</b>box, enter this prompt: <i>Show me a snapshot of my talent profile</i>.![](GUID-478ec75d-ddab-4330-bec0-d9e9aa29e2e4.png)
5.  Select the blue <b>Send</b> button or press <b>Enter</b>.
6.  In the upper right corner of the <b>Agent Chat</b> window, select the <b>Expand</b> icon to better see the results.


✅ <b>Expected Result:</b> You should see that your agent has returned a snapshot of Logan's talent profile.

Developer Agent gives a comprehensive overview of the project and each worker recommendation in an easy to read format, consumable by the end user.

![](GUID-f417c89e-dce3-4764-a535-68d24e38e30b.png)

