---
title: "Job aids from agent sessions — Kiweely"
description: "Workday deletes Deployment Agent chat after 14 days and has not published a job-aid product. Write the aid from the task you confirmed, the same day."
url: https://kiweely.com/blog/workday-job-aids-from-ai-agent-runs
---

# Turn an agent session into a job aid before the chat disappears

A job aid is your document. Deployment Agent can produce numbered steps and lay explanations in a non-Production tenant, then Workday deletes the thread. Keep only steps you have run. A desktop agent can file a document from the tenant; a person still checks it against the screen.

-   By Kiweely
-   November 16
-   6 min read

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 |
| --- | --- | --- |
| Knowledge discovery, for example the published Top of Stack prompt in lay terms and bullets | A definition you have checked against the guide it cites. | The whole thread, a week later, from memory. |
| Configuration intelligence, numbered steps for a calculated field or a similar task | Steps you have performed in **Create Calculated Field** or the named task, with your labels. | Steps you have not clicked. The answer can be incomplete. |
| A tenant inspection (“in my tenant, how does this calculated field work”) | Names you opened in **View Calculated Field**. | Names you did not open. There is no badge proving Ask was on. Q&A cannot see the field at all. |
| A security explanation | The domain and the groups you saw on the policy after activation. | A 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. |
| A business process explanation | The definition, the organization inheritance selected, the step, and the security group, as shown on the definition. | “The manager approves” when this organization uses a different definition, or when an entry condition skips the step. |
|  [Kiweely Vine](https://kiweely.com/vine) design document | A document filed from the tenant, after a person has matched it to the screen. | An 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:

1.  **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.
2.  **What they click.** The task or the inbox step, not the agent’s paraphrase of it.
3.  **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.
4.  **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.
5.  **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 |
| --- | --- | --- |
| Deployment Agent chat | 14 days, then deleted, and not visible from another tenant | Nobody, after day 14. Copy sooner. |
| The job aid you publish | As long as you keep it | The team that owns the business process. Update it when the definition’s effective date changes. |
| The business process definition | Until someone changes it. A future effective date is not live yet. | The security and process administrators. |
| A post-migration summary, if the process moved by Object Transporter | Two years | Whoever 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.

## Read next

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

-   [November 16 ### App Builder vs Claude Code for Workday Developer Agent](https://kiweely.com/blog/app-builder-vs-claude-code-developer-agent)
-   [November 16 ### What to put in a Workday SOW when agents are in scope](https://kiweely.com/blog/workday-implementation-sow-ai-agents)
-   [November 16 ### Can AI agents speed up a Workday implementation? What they do in the tenant today](https://kiweely.com/blog/kiweely-vine-workday-implementation-project)

### More guides on Custom agents and Workday AI

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

-   [AI Gateway Document Intelligence (/ml/docint/v1/ids): Converting Workday Drive Base64 to Binary, Resume Layout Pitfalls, and Fixing Opt-In Errors](https://kiweely.com/guides/workday-document-intelligence-base64-binary-opt-in-errors)
-   [Why a Workday Custom Agent Has No Credentials Tab in Agent Management Hub, and How to Expose It Through A2A](https://kiweely.com/guides/workday-custom-agent-missing-credentials-tab-a2a)
-   [Passing Large CSV File Attachments From a Workday Custom Agent Flow to Orchestrate Without Hitting Context Limits](https://kiweely.com/guides/workday-custom-agent-csv-file-attachment-orchestrate)
-   [Preventing Duplicate Initiate\_Change\_Job Business Process Events When a Workday Custom Agent Calls a Write Tool](https://kiweely.com/guides/workday-custom-agent-duplicate-initiate-change-job)
-   [Why Custom Agent Actions Fail With S22 Permission Denied or Task Not Authorized in Agent Chat](https://kiweely.com/guides/workday-custom-agent-actions-permission-denied-tool-wids)
-   [Fixing invalid\_request OAuth Token Exchange Errors When Connecting Microsoft Copilot Studio to Workday A2A](https://kiweely.com/guides/workday-a2a-copilot-studio-oauth-invalid-request)
-   [Why Custom Agent Skills Deployed From the Developer Site Don’t Appear in Agent Management Hub, and ASOR Tenant Prerequisites](https://kiweely.com/guides/workday-agent-management-hub-skills-not-showing)
-   [Fixing Workday Developer Agent VS Code Sign-In With a Personal Developer Account and Subagent Interrupt Errors](https://kiweely.com/guides/workday-developer-agent-vscode-personal-account-login)

## Your Workday work, done by AI.

Kiweely Vine is the AI agent that builds, deploys and tests Extend apps as real people, makes changes in any Workday task screen, answers from your real tenant and builds reports.

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

## Get the next one in your inbox.

One email a month for Workday teams: what’s changing in Workday and what to retest, one tip tried in a real tenant, and what’s new at Kiweely.
