Workday has not published a job-aid object, a procedure library, or an export that turns Deployment Agent into employee help text. The agent is for implementers and administrators in non-Production tenants. It answers, cites Community and the Administrator Guide, and then Workday deletes the chat after 14 days. Long threads are summarized, which drops the detail a procedure needs. If you want a job aid, write it the same day, from the task you actually ran.
What is safe to copy into a job aid
| Source | Safe to reuse | Unsafe to reuse |
|---|---|---|
| SourceKnowledge discovery, for example the published Top of Stack prompt in lay terms and bullets | Safe to reuseA definition you have checked against the guide it cites. | Unsafe to reuseThe whole thread, a week later, from memory. |
| SourceConfiguration intelligence, numbered steps for a calculated field or a similar task | Safe to reuseSteps you have performed in Create Calculated Field or the named task, with your labels. | Unsafe to reuseSteps you have not clicked. The answer can be incomplete. |
| SourceA tenant inspection (“in my tenant, how does this calculated field work”) | Safe to reuseNames you opened in View Calculated Field. | Unsafe to reuseNames you did not open. There is no badge proving Ask was on. Q&A cannot see the field at all. |
| SourceA security explanation | Safe to reuseThe domain and the groups you saw on the policy after activation. | Unsafe to reuseA draft that names a worker’s pay or a private case. Ask the policy question, not the person’s data question, if the aid will be widely read. |
| SourceA business process explanation | Safe to reuseThe definition, the organization inheritance selected, the step, and the security group, as shown on the definition. | Unsafe to reuse“The manager approves” when this organization uses a different definition, or when an entry condition skips the step. |
| SourceKiweely Vine design document | Safe to reuseA document filed from the tenant, after a person has matched it to the screen. | Unsafe to reuseAn unreviewed draft given to every employee. |
The sample-prompt topic’s format element is how you ask for a numbered list. The tone element is how you ask for lay language. Use both. Then edit. The default voice is Workday’s professional voice, which is rarely the voice of a job aid for a new manager.
A prompt that is aimed at an aid, not at a design discussion
I am a Workday administrator. In my tenant, the Change Business Title business process for [supervisory organization] uses which definition? List the steps a manager completes, in order, in one short sentence each, using the step labels from the tenant. I will compare your list to the definition before I publish it.
Start a new chat. Do not append it to the design thread. Summarization will mix them.
Publish only the list you matched to the definition. Include the organization, because inheritance means another organization may differ. Include the effective date if you are not on the definition that runs today.
What a worker job aid must contain
Workday’s framework already has the pieces. The aid should name them in everyday words:
- Who. The security group, in the worker’s language (“your manager”), only after you have confirmed that group is on the step and on the business process security policy.
- What they click. The task or the inbox step, not the agent’s paraphrase of it.
- When the step does not appear. The entry condition, tested with Business Process > Test Rule on a real event if the condition is the reason people get stuck. Some entry conditions are delivered and cannot be edited. The aid can say “you will not see this step when…” only if that is true in the definition.
- What sits outside Workday. To do steps can be reminders to do something inside or outside the product. Say which. Do not write a to do as if it were an approval.
- Where to look when it fails. The event, for the administrator. Not “ask the AI,” unless that reader is an administrator in a non-Production tenant with Ask enabled. Workers in Production do not have Deployment Agent as a conversational assistant.
Keep worker data out of the examples. Use the course’s style: a role and a step, not a real employee’s absence balance copied from a chat.
Vine can write the document from the tenant and file it on the project. Treat that file as a draft of the aid. Someone who knows the definition still deletes anything the worker cannot see. Proxy-testing as the worker, while you watch, is a good way to catch a step the draft invented. The watched session is the check. The document is not self-certifying.
Retention and ownership
| Record | Lifetime | Owner |
|---|---|---|
| RecordDeployment Agent chat | Lifetime14 days, then deleted, and not visible from another tenant | OwnerNobody, after day 14. Copy sooner. |
| RecordThe job aid you publish | LifetimeAs long as you keep it | OwnerThe team that owns the business process. Update it when the definition’s effective date changes. |
| RecordThe business process definition | LifetimeUntil someone changes it. A future effective date is not live yet. | OwnerThe security and process administrators. |
| RecordA post-migration summary, if the process moved by Object Transporter | LifetimeTwo years | OwnerWhoever ran the migration. Useful when the aid’s screenshots no longer match Production. |
Do not store the aid only inside a desktop chat either. File it where the next person on the project will find it. Vine’s copy says it files documents on the project. A generic chat does not.
Failure modes
- Publishing the numbered list the afternoon it was generated, because it “looked like Workday.” One wrong security group sends every manager to the wrong step.
- A single aid for all countries and organizations when you copied definitions. The course says testing the right definition is harder when many copies exist. The aid has the same problem.
- Screenshots from Sandbox the week before a refresh. After the refresh, Sandbox is Production’s copy again, and the prototype screens are gone.
- An aid that tells workers to open Deployment Agent. They may not be on the Deployment Agent Users domain, and Production will not offer the conversational agent.
- Leaving personal data in a sample prompt that gets pasted into the aid. The sample-prompt topic does not tell you to include a worker’s pay. Do not.
Frequently asked questions
Can we give administrators the chat instead of a job aid?
Only for two weeks, and only in that tenant. After that the thread is gone. A short aid that names the task is more reliable than a thread, even for administrators.
Does Q&A produce better training text because it cites sources?
It produces general text with citations, and it cannot see your steps. Good for a concept such as Top of Stack. Bad for “how we do time off here.” Use Ask for the local steps, then confirm them.
Should the aid mention both agents?
Mention a tool only if that reader is allowed to use it. For workers, name the Workday task. For implementers, you can say “confirm the definition in the tenant; an assistant can draft the list.” You do not need a product name in a worker-facing aid.
How often do we regenerate?
When the definition, the condition, or the security group changes, and when a feature release changes the task. Preview tenants receive feature releases about five weeks before everyone else. Check a worker-facing aid in Sandbox Preview before you assume the clicks survived the release. The What’s New in Workday report, run in Sandbox Preview, is the course’s way to see what arrived.
Sources checked
Public Workday topics listed above, fetched 2026-11-16. Vine’s document behavior is from kiweely.com. Workday does not publish a job-aid product on the pages checked.