{"schema_version":"seekout_recruiter_agent_recipes.v1","source_reviewed_on":"2026-09-13","source_index_url":"https://docs.seekout.com/llms.txt","canonical_candidate_search_reference":"/reference/candidates_search","candidate_search_example_ids":["public-easy","mixed-complex","public-github-full-profile"],"recipes":[{"id":"shortlist","title":"Build a hiring-manager shortlist","outcome":"A ranked slate with evidence, gaps, and suggested interview focus.","prompt":"Build a shortlist of the five strongest candidates for our senior platform engineer role. Compare AWS, Kubernetes, and infrastructure-as-code evidence and explain the ranking.","integration_ids":["chatgpt-app","claude-custom-connector","microsoft-365-copilot-agent","copilot-studio-connector","gemini-enterprise","amazon-quick","databricks-marketplace","developer-cli-tools"],"source_docs_urls":["https://docs.seekout.com/mcp/capabilities/workflows","https://docs.seekout.com/mcp/capabilities/prompt-pack","https://docs.seekout.com/mcp/reference/workflow-playbooks"],"access":{"product_license":"SeekOut Recruit license with the relevant MCP access.","tenant_enablement":"Public search works by default; ATS and internal talent need setup.","admin_approval":"Only needed when the assistant platform is admin-managed.","configured_connector":"A connected assistant or MCP client with successful SeekOut sign-in.","user_permission":"The signed-in user can search every requested data source."},"canonical_links":["/reference/candidates_search","/reference/search_sources","/reference/profiles_unlock"],"workflow_playbooks":["intake","talent-search","shortlist","calibrate"],"steps":["Clarify must-haves, nice-to-haves, title variants, locations, and target companies.","Select accessible data sources and run preview searches before showing candidates.","Rank by evidence and name uncertainty separately from confirmed profile data.","Ask before saving candidates, retrieving contacts, exporting, or pushing to an ATS."],"success_signals":["Candidate list includes match evidence, not just names.","Ranking rationale is tied to the role criteria.","Any paid or write action is paused for confirmation."],"recovery":["If the pool is too broad, tighten seniority, title, skill, or location constraints.","If the pool is too narrow, preserve must-haves and relax lower-priority filters.","If a source is unavailable, say which license, tenant, or permission is missing."],"writes_or_credits":"Search and comparison are read-only; contacts, exports, saves, and ATS pushes have separate credit or write effects."},{"id":"market-kickoff","title":"Kick off with talent-market context","outcome":"A role strategy with market depth, employer patterns, and constraints to relax.","prompt":"Compare the available pool of staff machine learning engineers in Boston, Seattle, and Austin. Show common employers and skills, and identify which requirements are limiting the pool.","integration_ids":["chatgpt-app","claude-custom-connector","microsoft-365-copilot-agent","copilot-studio-connector","gemini-enterprise","amazon-quick","databricks-marketplace","developer-cli-tools"],"source_docs_urls":["https://docs.seekout.com/mcp/capabilities/workflows","https://docs.seekout.com/mcp/capabilities/data-sources","https://docs.seekout.com/mcp/reference/workflow-playbooks"],"access":{"product_license":"SeekOut Recruit license; source-specific plans apply to healthcare and nursing.","tenant_enablement":"Specialized pools depend on entitlement; ATS and employee data need setup.","admin_approval":"Required only by the chosen assistant platform or enterprise data store.","configured_connector":"The assistant can discover SeekOut tools and read workflow resources.","user_permission":"The user can access every requested pool or sees an unavailable-source result."},"canonical_links":["/reference/candidates_search","/reference/talent_landscapes_create","/reference/search_facets_summary","/reference/search_result_facets"],"workflow_playbooks":["intake","talent-market-analysis","talent-landscape","comp-context"],"steps":["Start before a slate, with role level, core skills, locations, and tradeoffs.","Compare markets from aggregate counts and facets before asking for profiles.","Name requirements that narrow the pool and propose bounded relaxations.","Carry the resulting strategy into candidate search only after the user approves."],"success_signals":["The answer shows market depth and the constraints driving it.","Location and skill tradeoffs are separated from recommendation language.","No candidate data is invented when an aggregate market cannot be resolved."],"recovery":["If a market cannot be resolved, report it as unavailable instead of estimating.","If counts are too small, broaden one constraint and preserve explicit anchors.","If a vertical is not entitled, state the missing entitlement and continue only with accessible sources."],"writes_or_credits":"Market and preview search are read-only unless the workflow asks for paid facets or full-profile hydration."},{"id":"ats-rediscovery","title":"Rediscover authorized ATS candidates","outcome":"A ranked list of previous applicants or pipeline candidates worth revisiting.","prompt":"Search our ATS for past candidates who could fit a Senior Backend Engineer role. Prioritize later-stage candidates and explain why each one is worth revisiting.","integration_ids":["chatgpt-app","claude-custom-connector","microsoft-365-copilot-agent","copilot-studio-connector","gemini-enterprise","amazon-quick","databricks-marketplace","developer-cli-tools","automated-workflows"],"source_docs_urls":["https://docs.seekout.com/mcp/capabilities/data-sources","https://docs.seekout.com/mcp/capabilities/workflows","https://docs.seekout.com/mcp/reference/operations","https://docs.seekout.com/mcp/reference/workflow-playbooks"],"access":{"product_license":"Recruit plan that includes ATS integration.","tenant_enablement":"A supported ATS is connected to the SeekOut organization.","admin_approval":"The assistant connector may need platform approval before users can sign in.","configured_connector":"The session can list or search ATS sources exposed to that user.","user_permission":"The signed-in user can access the relevant requisition, stage, or fields."},"canonical_links":["/reference/candidates_search","/reference/search_sources","/reference/candidates_search"],"workflow_playbooks":["ats-pipeline","ats-providers","ats-compliance","shortlist"],"steps":["Confirm that ATS pipeline search is available before using applicant data.","Search by role, stage, date range, disposition, notes, or accessible fields.","Rank rediscovery candidates by current fit and prior-stage signal.","Ask before exporting profiles or pushing candidates to a connected ATS destination."],"success_signals":["The answer names the ATS source as connected and authorized.","Unavailable ATS access is explicit rather than replaced by public search.","Ranking separates past pipeline signal from current profile evidence."],"recovery":["If ATS is not connected, tell the user to configure it before rediscovery.","If the user lacks access, stop and do not infer private pipeline data.","If a requisition is ambiguous, ask for the destination before writing or exporting."],"writes_or_credits":"ATS search can be read-only; exporting or pushing candidates is a write and may use credits or destination-specific permissions."}]}