---
title: "VNDLY Contingent Sourcing Agent — Kiweely"
description: "Register Contingent Sourcing Agent in Workday, then enable grading and rediscovery in VNDLY, including the permissions vendors never get."
url: https://kiweely.com/guides/workday-vndly-contingent-sourcing-agent
---

# Set up the VNDLY Contingent Sourcing Agent

Contingent Sourcing Agent needs both a Workday tenant and a VNDLY tenant. It grades applicants and recommends prior talent-pool candidates for contingent jobs. Vendors cannot open the agent; client, MSP, and program roles can, after a first run that may take up to 48 hours.

-   **Checked** against Workday on November 16
-   Applies to **Workday Extend**
-   4 min read
-   Published November 16
-   By Kiweely

Contingent Sourcing Agent is a Workday-built agent that runs in Workday VNDLY for Extended Workforce Management. It does two things: **Contingent Applicant Grading** (grades and AI summaries for candidates on a job) and **Contingent Talent Rediscovery for Contingent Jobs** (prior applicants from the VNDLY talent pool who match the new job). You need a Workday tenant and a VNDLY tenant. Setup is split across Agent System of Record and VNDLY Company Settings.

You can only register agents included in products your organization can access. Client, MSP, and program-team roles can be granted the agent. Vendors cannot use the agent or its skills in the VNDLY interface. You can still email a vendor a recommendation from the rediscovery skill.

## Register in Workday, then enable in VNDLY

1.  Set up Agent System of Record in the Workday tenant.
2.  Open **Agent Management Hub**, **Unregistered Workday Agent**, and register Contingent Sourcing Agent.
3.  Confirm, then open the agent on **Agent Registry** and finish configuration there. Workday moves the agent to the registry after register and confirm.
4.  In VNDLY, open **Company Settings**. Viewing AI settings requires `ai.settings.read`. Changing them requires `ai.settings.write`.
5.  In the Contingent Sourcing Agent section, turn on **Candidate Grading**, **Recommendations**, or both.
6.  Set your preference for agent traces on that same settings area.
7.  Grant role permissions. The first time you enable the skills, grades and recommendations can take up to 48 hours. After that window, Workday says new grades and recommendations arrive within minutes for jobs that have the skills on.

Sourcing workflow configuration can set the default **Grading Enabled** and recommendations behavior for new jobs. Those agent defaults apply to new jobs, not to jobs that already exist. Job end-reason defaults are different: Workday says that default applies to new jobs and to existing jobs that close when all positions are filled.

## Permissions that match the skill

| Permission | Skill | Lets the user |
| --- | --- | --- |
| `applicant_grade.read` | Grading | See grades and AI summaries on the job Applicants tab and on applicant pages |
| `job.recommendation.read` | Rediscovery | See the Recommendations tab and use Actions except Remove Recommendation |
| `job.recommendation.remove` | Rediscovery | Remove a recommended candidate |
| `job.candidate.grading.override` | Grading | Toggle grading on a single job form |
| `job.candidate.recommendations.override` | Rediscovery | Toggle recommendations on a single job form |
| `candidate.read` | Rediscovery | Open the candidate profile from Recommendations |
| `candidate.ai.preferences.read` | Both | View AI settings on the profile. Granted automatically with `candidate.read` |
| `candidate.ai.preferences.write` | Both | Edit those AI settings. Granted automatically with `candidate.update` |
| `job.vendor.sourced.manage` and/or `job.vendor.pre_id.manage` | Rediscovery | Use **Distribute job to vendor** when sending a recommendation to a vendor |

## What recruiters see on a job

On **Publish a Job**, an **AI Capabilities** section appears only if the tenant has the agent enabled. Two toggles:

-   **Grading** shows and defaults on when applicant grading is enabled. Users with `job.candidate.grading.override` can change it. Grades use the job details.
-   **Recommendations** shows and defaults on when rediscovery is enabled. Users with `job.candidate.recommendations.override` can change it. The agent surfaces past applicants from the job details.

If you turn a toggle off after the job is published, existing grades or recommendations stay visible. The agent does not create new ones.

The candidate profile’s Profile tab can show an **AI Opt-Ins** section when the agent is configured. Vendors with the read permission can see it; vendors with the write permission can edit it. Workday says vendors use it to record that a candidate asked to opt out of AI features during screening.

## Failure modes

-   **Only a VNDLY tenant.** Registration is in the Workday Agent Management Hub. The setup page requires both tenants.
-   **Vendor users expect a Recommendations tab.** They will not get the agent UI. Share candidates with **Send Email to Vendor** / **Send to Vendor** instead.
-   **Existing jobs stay dark.** Company-level defaults do not backfill jobs already open. Turn grading or recommendations on per job if that job should be included, and only for users who have the override permission.
-   **Empty results in the first two days.** Wait through the initial 48 hours after the Company Settings enablement before you treat “no grades” as a defect.
-   **Opt-out ignored.** If AI preferences say the candidate opted out, do not treat a grade as something you can still show. The profile setting exists so screening can honor that request.
-   **Security group in Workday, no VNDLY permission.** Hub registration does not grant `applicant_grade.read` or `job.recommendation.read`. Set both sides.

## Frequently asked questions

### Is this the employee Self-Service Agent?

No. Self-Service Agent does not support contingent workers. Contingent Sourcing Agent is a VNDLY recruiting aid for program staff, not an employee chat assistant.

### Does grading decide who is hired?

Workday describes grades and talent-pool recommendations as inputs for the program team. It does not say the agent creates work orders, bypasses job approvals, or replaces the vendor submission path.

### Can we enable this for direct-hire jobs only?

The publish-job page distinguishes Contractor and Direct Hire as hiring types. The agent section is tied to Contingent Sourcing Agent skills on the job. Use the job-level toggles rather than assuming every hiring type is graded. Workday does not, on these pages, say direct-hire jobs are excluded by default.

## Sources checked

Set Up Contingent Sourcing Agent, Publish a Job, Sourcing Workflow Configurations, Candidate List and Candidate Profile, and the Workday-Built Agents reference, fetched 2026-11-16.

## Sources checked

-   [Set Up Contingent Sourcing Agent](https://doc.workday.com/admin-guide/en-us/workday-ai/agents/workday-built-agents/contingent-sourcing-agent/set-up-contingent-sourcing-agent.html)
-   [Publish a Job](https://doc.workday.com/admin-guide/en-us/vndly-documentation/jobs/job-workflows/mie1663879300444.html)
-   [Set Up Sourcing Workflow Configurations Settings](https://doc.workday.com/admin-guide/en-us/vndly-documentation/jobs/job-configuration/sourcing-workflow-configurations.html)
-   [Concept: Candidate List and Candidate Profile](https://doc.workday.com/admin-guide/en-us/vndly-documentation/manage-users/manage-candidates/concept--candidate-list-and-candidate-profile.html)
-   [Workday-Built Agents](https://doc.workday.com/admin-guide/en-us/workday-ai/agents/workday-built-agents/reference--workday-built-agents.html)

## Related guides

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

-   [### 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)

### More guides on Custom agents and Workday AI

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

-   [CRAFT prompts for the Workday Deployment Agent](https://kiweely.com/guides/workday-deployment-agent-admin-prompt-patterns)
-   [How to use Deployment Agent through an implementation](https://kiweely.com/guides/workday-deployment-agent-implementation-phases)
-   [A Workday admin’s first week with Deployment Agent](https://kiweely.com/guides/workday-admin-first-week-deployment-agent)
-   [Workday Core Reporting Agent: when conversational reporting is enough](https://kiweely.com/guides/workday-core-reporting-agent)
-   [Workday Adoption Agent: Release Impact Analysis for Preview admins](https://kiweely.com/guides/workday-adoption-agent-release-impact)
-   [The 2026 Workday AI map: Sana, ASOR, Workday-built, custom, partner, and external agents](https://kiweely.com/guides/workday-ai-ecosystem-map-2026)
-   [Why Generic IDE Agents Still Need Workday Developer Agent for Extend](https://kiweely.com/guides/why-generic-ide-agents-need-workday-developer-agent)
-   [Complimentary Workday Flex Credits: What They Are and What Happens When They Run Out](https://kiweely.com/guides/complimentary-workday-flex-credits-what-happens-when-exhausted)

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

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

-   [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)
-   [Bringing Developer-Built Web Apps and HRIS-Built Screens Together in One Employee App](https://kiweely.com/blog/combining-agent-built-and-developer-built-workday-web-apps)
-   [Using an AI Admin Agent to Configure Workday API Clients and Test Role Boundaries](https://kiweely.com/blog/ai-admin-agent-for-workday-connector-setup-and-role-testing)

## 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.
