Agent Quickstart

May 24, 2026 · View on GitHub

面向 AI Agent 的最短上手路径：先识别能力，再跑通低风险的搜索、详情和本地整理闭环；涉及投递、沟通、候选人处理时回到平台官网由用户手动完成。

1) 安装与环境准备

# 推荐方式（三选一）
uv tool install boss-agent-cli   # uv（秒级，自动隔离）
pipx install boss-agent-cli      # pipx（隔离环境）
pip install boss-agent-cli       # pip

# 安装浏览器（用于登录）
patchright install chromium

# 环境自检 + 登录
boss doctor
boss login
boss status

完成标准：

  • boss doctor 返回 ok=true
  • boss status 返回本地登录态的分层健康状态；如需真实只读验证，显式运行 boss status --live
  • 若使用 zhilian，请显式带上平台：boss --platform zhilian doctor && boss --platform zhilian login

如果你不是直接在终端里手动跑命令，而是准备把它接进 Agent 宿主，先看 Agent Host Examples 选择对应接入模板。

2) 三步跑通低风险 Agent 闭环

# Step 1: 拉取自描述能力
boss schema

# Step 2: 搜索并定位目标职位
boss search "Golang" --city 广州 --welfare "双休,五险一金"
# 复杂筛选可复用用户在网页上选好的 URL
boss search --url 'https://www.zhipin.com/web/geek/jobs?query=Golang&city=101280100&experience=104,105'

# Step 3: 查看详情并本地整理；投递/沟通回到平台官网手动完成
boss detail <security_id>
boss shortlist add <security_id> <job_id>

解析约定：

  • stdout 只读 JSON 信封
  • ok=true 代表成功，ok=false 时读取 error.code 与 error.recovery_action
  • boss schema 除了返回 supported_platforms / supported_recruiter_platforms，还会给每个命令附带 availability，可直接按 role/platform 做工具路由

招聘者边界

默认低风险模式会阻断候选人搜索、投递申请、简历、聊天、联系方式交换和消息回复等招聘者个人信息链路。当前保留低风险的职位列表/上下线入口：

# Step 1: 同样先做能力发现
boss schema

# Step 2: 查看招聘者侧职位能力
boss hr jobs list

# 候选人处理、沟通和联系方式交换请回到平台官网手动完成

建议做法：

  • 先把 boss schema 里的 hr 命令组当作招聘者能力真源
  • boss hr <subcommand> 会自动切到 recruiter 角色，不需要额外推断 --role
  • 求职者与招聘者两端都遵守同一套 stdout JSON / stderr 日志 契约
  • 当前 hr 只支持 zhipin-recruiter；若当前平台切到 zhilian，CLI 会直接拒绝执行 recruiter 子命令
  • 敏感子命令返回 COMPLIANCE_BLOCKED 时，不要尝试换自动化通道继续执行

3) 失败恢复与排障

推荐顺序：

boss doctor
boss logout
boss login
boss status

常见恢复动作：

  • AUTH_REQUIRED / AUTH_EXPIRED / TOKEN_REFRESH_FAILED：重新执行 boss login
  • wt2 存在但 stoken 缺失：通常为部分登录态；使用 Chrome CDP 远程调试端口后运行 boss login --cdp，或重新执行 boss login
  • RATE_LIMITED：等待后重试
  • INVALID_PARAM：校正参数（城市、福利、页码等）

4) 工具协议直出

不同 Agent host 需要不同形态的工具定义，boss schema --format 一次产出：

boss schema --format openai-tools     # OpenAI Functions / Tools API
boss schema --format anthropic-tools  # Claude Tool Use API
boss schema --format mcp-tools        # Model Context Protocol Tools

输出可直接喂给对应 host，无需手写适配。

延伸阅读：