用途:Agent Canvas 是 Alera 终端中一次智能体运行共享的画布界面,用于发布结构化更新并等待持久决策。运行时宿主负责持久化、修订、决策、保留与事件,应使用 alera canvas 命令,而不是直接写应用套接字或修改运行时 SQLite。
身份与作用域:需在 Alera 终端内运行,由 ALERA_WORKSPACE_ID 和 ALERA_TERMINAL_SESSION_ID 标识该终端拥有的唯一画布;ALERA_TAB_ID 与 ALERA_AGENT_TYPE 在可用时使用。画布按工作区与终端会话划分作用域。
主要命令: alera canvas capabilities --json alera canvas catalog --workspace-id <workspace-id> --history --json alera canvas examples --json alera canvas publish --stdin --expected-revision <revision> --json alera canvas events --workspace-id <workspace-id> --follow --json alera canvas wait --decision-id <decision-id> --timeout-ms 600000 --json alera canvas complete --canvas-id <canvas-id> --json alera canvas close --canvas-id <canvas-id> --json
发布与冲突:publish 接受一个 JSON 文档或换行分隔的 JSON 对象。当校验失败或 expected-revision 检查失败时,命令保留最后一个有效修订。遇到冲突时,读取 catalog 并基于其返回的修订重新发布。
决策:决策请求在解决或超时前保持持久。解决已解决的决策是幂等的,超时不会取消智能体运行。
界面规则:使用 capabilities 报告的十个受支持组件。优先语义合并,只发布有意义的变更。动作中不得包含任意命令、shell 文本、函数、源代码、外部请求、URL 或未校验路径。即时导航与键入确认动作由 Alera 处理;破坏性动作需要显式确认,并保持在所属画布范围内。
限制:资料未提供具体组件清单、安装方式、收费与平台信息。