Skip to main content
每个 youka 命令都接受同一组全局标志。它们用于控制输出模式、输入处理、等待行为以及目标 API。

标志

JSON 信封

使用 --json 时,CLI 会向 stdout 精确写出一个信封且不输出其他内容。 成功:
失败:
退出码:
在脚本中可用 jq 管道处理信封:youka project show $ID --json | jq '.data.state'.

传递 JSON body

任何创建或更新命令都接受 --body 作为完整请求 body。用它来替代在命令行里转义大段 JSON。

等待异步任务

--wait 会代表你轮询已创建的资源并返回最终状态。不使用 --wait 时,命令会在任务入队后立即返回。
在脚本中将 --wait--quiet 搭配使用,可抑制进度条,同时仍会打印 JSON 结果。

幂等性

传入 --idempotency-key 可让写入命令安全重试。对同一 payload 复用同一个 key 会返回原始结果,而不是创建重复项。
只要代理可能在超时后重试,就应使用幂等键。

环境变量

接下来

  • Account - 保存你的 API key
  • Projects - 你的第一个脚本化工作流
  • AI agents - 面向代理作者的操作规则