命令参考：OpenPort

概述

OpenPort 命令让自动化流程在其 Agent Key 的权限范围内读取工作区数据、提出或执行操作。数据命令需要 Agent Key；复核命令需要某个人的浏览器登录。所有命令都需要支持 OpenPort 的服务器，复核命令还需要服务器支持审批功能。

读取数据（Agent Key）

figena openport manifest

查看工具清单：你的 Agent Key 可以使用的操作和数据。

figena openport workspaces

列出你的 Agent Key 可以访问的工作区。

figena openport transactions

列出工作区中的交易。工作区来自 --workspace <id>（或 --org <id>），或 profile 中的 orgId。

• --kind <kind> 和 --search <text>：筛选列表。
• --from <date> 和 --to <date>：限定日期范围。
• --sort <order>、--page <n> 和 --page-size <n>：排序并分页查看结果。

提出和执行操作（Agent Key）

figena openport preflight

在提交操作之前先做检查，返回操作的预期影响和 impactHash。--action <name> 为必填；用 --payload <file> 或 --payload-json '<json>' 传入负载。

figena openport action

用 --action <name> 和负载创建一个操作。每个操作都会先记录为草稿。加上 --execute 表示请求 Figena 立即执行，同时必须提供 --justification "<reason>"，理由会随操作一起保存。能否执行取决于工作区为这把 Agent Key 设置的自动执行规则；不允许执行时，操作会保留为草稿等待复核，结果中会说明原因。

• --preflight-hash <hash>：openport preflight 返回的 impactHash。高风险操作通常需要它才能执行，并且提交时它必须仍与当前影响一致。
• --force-draft：把操作作为草稿提交复核。
• --request-id <id> 和 --idempotency-key <key>：标识这次请求。带幂等键且不执行的请求，在临时失败后可能重试一次；CLI 从不重试已执行的操作。

figena openport preflight --action <action-name> --payload ./payload.jsonfigena openport action --action <action-name> --payload ./payload.json --force-draft

figena openport draft get <draftId>

查看一份草稿。

复核草稿和导出审计记录（浏览器登录）

figena openport drafts list

列出等待复核的草稿。可用 --app <appId>、--org <id> 和 --status <status> 筛选，用 --page-size <n>（或 --limit）和 --cursor <cursor> 分页。加上 --all 会读取所有页，--max-items <n> 会在达到指定数量后停止。结果包含 items、nextCursor 和已读取的页数 pages。

figena openport draft approve <draftId>

批准一份草稿。加上 --note "<text>" 可以记录原因。

figena openport draft reject <draftId>

拒绝一份草稿。加上 --note "<text>" 可以记录原因。

figena openport audit export

以 CSV 格式导出 OpenPort 审计日志。可用 --app、--org、--from、--to 和 --limit 筛选。使用 --file <path> 时，CLI 会把 CSV 写入该文件，输出“Exported audit CSV to”和文件路径，并附上行数；不使用时，CSV 会包含在结果数据中返回。

figena openport audit export --org <workspace-id> --from <date> --to <date> --file ./openport-audit.csv