Agent-Native Interface(智能体原生接口)

定义

Agent-Native Interface 是指专门为 AI Agent 设计的交互接口,而非为人类用户设计的传统接口。其核心理念是:接口的结构化程度、可预测性和机器可读性应优先于人类视觉体验。

核心特征

  • 结构化输出:JSON/YAML 等机器易解析格式,而非富文本渲染
  • 确定性行为:相同输入 → 相同输出,无歧义
  • 可编程性:支持管道、参数化调用、自动化编排
  • 低 Token 消耗:简洁参数名、短 flag、无冗余文案

与 CLI 的关系

CLI-Anything 是 Agent-Native Interface 的首个大规模实践——通过 HARNESS.md 协议为任意软件生成 Agent 原生 CLI。传统 CLI 设计以人类终端用户为中心,Agent-Native CLI 则以 AI Agent 的认知特征(高带宽文本处理、低容错、无视觉感知)为设计出发点。

参考对比

维度传统 Human-CLIAgent-Native CLI
输出格式彩色表格、分页JSON 流、一行一条
错误提示人类可读段落结构化错误码 + 修复建议
参数设计—long-name 友好短 alias + 默认值优先
交互交互式提示非交互式、幂等

关联连接