Skip to content
KiweelyKiweelyKiweely

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
  • Applies to Workday Extend
  • 4 min read
  • Published
  • By Kiweely
On this page

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
Permissionapplicant_grade.read SkillGrading Lets the userSee grades and AI summaries on the job Applicants tab and on applicant pages
Permissionjob.recommendation.read SkillRediscovery Lets the userSee the Recommendations tab and use Actions except Remove Recommendation
Permissionjob.recommendation.remove SkillRediscovery Lets the userRemove a recommended candidate
Permissionjob.candidate.grading.override SkillGrading Lets the userToggle grading on a single job form
Permissionjob.candidate.recommendations.override SkillRediscovery Lets the userToggle recommendations on a single job form
Permissioncandidate.read SkillRediscovery Lets the userOpen the candidate profile from Recommendations
Permissioncandidate.ai.preferences.read SkillBoth Lets the userView AI settings on the profile. Granted automatically with candidate.read
Permissioncandidate.ai.preferences.write SkillBoth Lets the userEdit those AI settings. Granted automatically with candidate.update
Permissionjob.vendor.sourced.manage and/or job.vendor.pre_id.manage SkillRediscovery Lets the userUse 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

Let Workday check the work.

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

Get the next guide in your inbox.

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

We’ll email you once to confirm. Unsubscribe in one click from any issue.