当前支持的 CLI 工作流
覆盖已有文档的访问、诊断、交付与运行可见性工作流。
访问与诊断
- 浏览器式
figena auth login,以及 logout、refresh、status。 figena config与 profile 命令,用于 API 地址和本地上下文。figena doctor检查 Node、profile、凭证、存储权限、API 版本与健康状态。figena version返回 CLI/API 兼容性与服务端能力。
Agents 与 Runs
figena agents list、get、create、version create、publish与deploy。- 使用已有文档的交付命令,并在依赖变更前复核结果。
figena run与figena runs wait支持可重复执行流程。figena runs trace用于查看运行与已发布调用上下文。
工具连接与知识库
- 受支持的集成命令会在可用时写入公开文档。
- 管理命令要求用户已认证并获得相应授权。
- 受支持的知识库工作流以 CLI 帮助为准。
- 请用当前 CLI 命令文档确认受支持的规范。
自动化安全
- 面向脚本、Agent 与 CI 任务的 JSON 输出。
- API 客户端内置分页、重试、超时与退避机制。
- 本地配置文件使用收紧的文件权限。
- 公开包不会携带 source map、测试产物、私有配置与服务端实现细节。
终端能做什么,边界同样清楚。
登录、Agent交付与运行可观测都可以从终端完成,同时敏感规则继续保留在服务端。
安全访问
浏览器登录,无需复制 token
终端发起登录,浏览器处理身份确认,CLI 只保存授权后的本机会话。
终端
$figena auth login
$Opening browser sign-in...
方格授权
只有当验证码和你从终端发起的登录一致时才确认授权。
验证码
QFNZ-YC
访问已批准授权
Agent 交付
部署与追踪在同一流程中完成
CLI 提交获准的请求,并显示可复核的进度与结果。
命令
figena agents list --output json校验 spec
由方格 API 检查
创建版本
服务端版本化
发布并运行 smoke
受策略控制
追踪运行
输出可读 JSON
部署完成,并产生可追踪输出。
安全边界
受控的命令行访问
公开 CLI 只提供已有文档的命令,不公开平台内部设计。
CLI
已认证服务
可复核结果
内部实现细节不属于公开接口
认证访问权限检查企业场景仅使用合成记录
命令在终端运行,规则仍由平台把关。
从终端完成安装、登录、状态检查,并运行已有文档的工作流。
查看 CLI 帮助
常见问题
方格 CLI 是正式产品吗?
CLI 的可用范围与受支持命令以当前公开文档为准。
CLI 会在本地运行 AI 或核心业务逻辑吗?
CLI 为获准的工作流提供公开命令;平台内部设计不属于公开接口。
现在支持哪些能力?
请通过内置帮助与当前公开文档查看你的账户可用哪些命令。
能用于 CI 或服务器环境吗?
获准的自动化场景需要使用为该用途签发的凭据与权限。
CLI 会是唯一的集成方式吗?
不是。受支持的服务可以通过集成连接,外部 AI 工具可以通过奇力AI的 OpenPort 能力获得授权。CLI 为运营人员、脚本与 Agent 工作流提供命令行入口。