Ashby 招聘自动化助手

要解决的问题

招聘团队的大量时间被消耗在 ATS 的重复操作上：从邮箱和内推链接里手工录入候选人、在不同页面之间复制粘贴来更新候选人状态、逐个检查面试时间。这些操作模式固定、字段结构清晰，却完全依赖人工点击。Ashby 的 API 覆盖了这些场景，但接入仍然需要一个能理解意图并调用工具的环节。这个技能补上的正是这一环——把自然语言指令翻译成对 Ashby 的结构化调用。

核心能力

候选人管理：ASHBY_CREATE_CANDIDATE、ASHBY_SEARCH_CANDIDATES、ASHBY_LIST_CANDIDATES 等工具覆盖从新建到更新的完整生命周期。创建时 name 必填，email、phoneNumber、linkedInUrl 等字段按需补充。

职位发布：ASHBY_CREATE_JOB 需要四个参数——title、teamId、locationId、brandId。其中后三个必须是从对应列表端点查询到的 ID，不能凭空填写。

申请与面试：ASHBY_CREATE_APPLICATION 把候选人关联到职位，interviewStageId 可以跳过默认阶段直接放入指定流程。ASHBY_LIST_INTERVIEW_SCHEDULES 返回时间、面试官和候选人信息，ASHBY_LIST_CANDIDATE_NOTES 拉取内部备注。

流水线报表：通过 syncToken 增量拉取变更记录，避免每次都全量重拉。

注意点

• 新职位创建后处于 Draft 状态，不设置 defaultInterviewPlanId 就无法接受申请。
• 所有列表端点使用游标分页，perPage 上限 100，不能跳到任意页，必须顺序迭代。
• ASHBY_SEARCH_CANDIDATES 只支持邮箱精确匹配或姓名模糊匹配，组合查询会失败；需要更宽的检索时改用 ASHBY_LIST_CANDIDATES。
• 所有 ID 都是 UUID，格式错误会返回 400。
• 创建申请前必须先存在候选人记录。