Agent Host Examples

August 10, 2026 · View on GitHub

面向不同 Agent 宿主的最小接入索引，目标是把 boss-agent-cli 变成“复制就能接”的工具，而不是需要二次猜测的协议。

当前示例覆盖的 CLI 基线：

  • 通过 boss schema 做能力发现
  • 通过 boss status 确认登录态
  • 通过 boss_wizard 或 boss wizard --input-json 推进与真人向导共享的 workflow
  • 通过 boss search / boss detail / boss apply 与 boss hr ... 使用细粒度能力
  • 通过 JSON 信封读取 ok、data、error.code、error.recovery_action

示例列表

宿主适合场景示例
Codex在终端内直接做 Bash 编排和 JSON 解析Codex
Claude Code通过 skill / 规则文件接入求职动作Claude Code
CursorComposer Agent + MCP 或 .cursor/rulesCursor
WindsurfCascade Agent + MCP 或 .windsurfrulesWindsurf
Shell Agent任意支持 shell tool 的 Agent 框架或自建编排器Shell Agent
Python SDK 直调自建 Agent / LangGraph / 业务代码直接驱动 OpenAI 或 Claude SDKPython SDK
Docker 容器不想在本机配 Python 工具链（如 Apple Silicon 环境折腾）；登录仍在宿主机完成Docker

选型建议

  • 如果 Agent 原生支持终端和多步工具调用，优先看 Codex
  • 如果你已经在用 skill 分发和规则驱动，优先看 Claude Code
  • 在 Cursor / Windsurf IDE 里工作，优先把 MCP 服务挂上（见各自文档的「方式一」）
  • 如果你有自己的 Agent 宿主或调度器，优先看 Shell Agent
  • 如果要在 Python 代码里直接驱动大模型做工具调用，优先看 Python SDK 直调

共同接入原则

  1. 首次接入先跑 boss schema，不要硬编码命令表。
  2. 所有成功/失败都以 stdout JSON 信封为准，不要解析 stderr。
  3. 把 boss doctor、boss login、boss status 当成统一恢复入口。
  4. 用户提到福利要求时，优先把条件落到 --welfare。
  5. 长流程始终保存显式 run_id，用 status/resume/stop 管理，不扫描“最新任务”。

相关文档