OpenProgram Docs

统一 Agent method 执行路径#

Agent method 的调用只有一条执行路径。无论是用户从 UI 触发，还是模型 把它选为工具，执行都落在同一个 runtime-block 包装里。

执行路径#

Web UI
  POST /api/function/{name}
    openprogram.webui.routes.chat.post_function
      dispatcher.dispatch_forced_tool_call(...)
        dispatcher._wrap_agentic_runtime_block(...)
          Agent method wrapper
            runtime.exec(...)

模型自己选择工具时不经过 REST endpoint，但进入同一套 dispatcher 工具执行与 runtime-block 包装。

REST 端点#

POST /api/function/{name} 接受：

{
  "session_id": "...",
  "project_id": "...",
  "kwargs": { "task": "..." }
}

session_id 是可选的。若省略，服务端会创建一个会话。 已有会话可以省略 project_id；新会话若存在待绑定的 Project，则首次函数调用 必须携带它。执行目录使用选中的 Project，未选择时回落到配置的默认 Project。

为兼容起见，较旧的调用方可能在顶层直接提交扁平的函数参数。服务端会把这些字段 转换成 kwargs，并忽略 session_id、project_id 等控制键。

响应为：

{
  "session_id": "...",
  "msg_id": "..."
}

/run 不是执行 API#

输入式的 /run ... 聊天命令不是函数执行 API。React 发起的函数调用直接调用 POST /api/function/{name}，重试 UI 同样如此。

后端解析器把 /run ... 当作普通用户文本，而不将其转换为 action="run"。 /api/run/{name} 与 WebSocket 的 action="run" 都不存在。

部分实现注释和类型名仍写着 /run 或 runtime block，这是因为该 UI 组件的 命名早于统一 endpoint。这些属于历史措辞，并不定义一条独立的执行路径。 清理命名时的搜索目标：

  • rg "/run|api/run|action=run|action=\"run\"" openprogram web
  • rg "runtime block|RuntimeBlock" web openprogram
Last updated · 2026-10-10
PreviousConfiguration safetyNextNaming conventions