AIDAWORK / ARCHITECTURE

aida-agent 运行时总览

独立图页 ↗
机制说明(SoT)图是辅读 · 结论以说明与证据为准

Gateway 处理请求身份与租户上下文;SessionBinding 确定会话的 direct 或 routed 绑定。Agent 绑定路径进入 OrchestratorRuntime,先准备本轮输入与依赖,再执行模型循环。工具经过执行管线,由 ExecutionHostRouter 按宿主分派。

本页可直接往下读完整机制说明,不需要「演示 / 播放故事」。术语不熟先看 术语表。

先读机制说明,结论以说明与证据为准 · 基于固定代码版本核验 · 部署状态另行确认

机制说明(全文)

aida-agent 运行时总览

从入口到执行宿主

Gateway 处理请求身份与租户上下文;SessionBinding 确定会话的 direct 或 routed 绑定。Agent 绑定路径进入 OrchestratorRuntime,先准备本轮输入与依赖,再执行模型循环。工具经过执行管线,由 ExecutionHostRouter 按宿主分派。

执行准备与执行本身有不同调用边界。普通调用由 resolveAndRun 串起两步;持久文本 Worker 复用 prepareExecution。图中的服务端与 Desktop 边界是执行责任边界,不能据此把本机宿主画成服务端进程。

本仓持有什么 / 不持有什么

  • 持有(SoT 在 Agent):Run(agent_runs 状态 + lease)、Interaction(InteractionKernel + PG store)、LF Operation(local_file_operations)、业务效应账本;Message Center 通知也由 Agent 的 NotificationService 写,但它只是读模型。详见 state-authority。
  • 负责:会话组织(Gateway / SessionBinding)、执行准备(prepareExecution 不调模型)、模型循环、工具分发(ExecutionHostRouter)。
  • 不持有:本机绝对路径与本机文件事实(在 Desktop Main)、插件包本身(来自 aida-plugins)、企业业务实体(源系统)。

证据与范围

  • aida-agent · packages/agent/src/gateway/session-binding.ts L54–84 · agentId: string | null · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/orchestrator-runtime.ts L379–407 · prepareExecution · e2adc9a3c325
  • aida-agent · packages/agent/src/execution-host/router.ts L50–80 · ExecutionHostRouter · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/orchestrator-runtime.ts L397–427 · durableText · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/execution/run-execution-worker.ts L69–70 · RunExecutionWorker · e2adc9a3c325
  • aida-agent · packages/agent/src/index.ts L2433–2443 · executionWorker.start · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

机制说明

aida-agent 运行时总览

从入口到执行宿主

Gateway 处理请求身份与租户上下文;SessionBinding 确定会话的 direct 或 routed 绑定。Agent 绑定路径进入 OrchestratorRuntime,先准备本轮输入与依赖,再执行模型循环。工具经过执行管线,由 ExecutionHostRouter 按宿主分派。

执行准备与执行本身有不同调用边界。普通调用由 resolveAndRun 串起两步;持久文本 Worker 复用 prepareExecution。图中的服务端与 Desktop 边界是执行责任边界,不能据此把本机宿主画成服务端进程。

本仓持有什么 / 不持有什么

  • 持有(SoT 在 Agent):Run(agent_runs 状态 + lease)、Interaction(InteractionKernel + PG store)、LF Operation(local_file_operations)、业务效应账本;Message Center 通知也由 Agent 的 NotificationService 写,但它只是读模型。详见 state-authority。
  • 负责:会话组织(Gateway / SessionBinding)、执行准备(prepareExecution 不调模型)、模型循环、工具分发(ExecutionHostRouter)。
  • 不持有:本机绝对路径与本机文件事实(在 Desktop Main)、插件包本身(来自 aida-plugins)、企业业务实体(源系统)。

证据与范围

  • aida-agent · packages/agent/src/gateway/session-binding.ts L54–84 · agentId: string | null · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/orchestrator-runtime.ts L379–407 · prepareExecution · e2adc9a3c325
  • aida-agent · packages/agent/src/execution-host/router.ts L50–80 · ExecutionHostRouter · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/orchestrator-runtime.ts L397–427 · durableText · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/execution/run-execution-worker.ts L69–70 · RunExecutionWorker · e2adc9a3c325
  • aida-agent · packages/agent/src/index.ts L2433–2443 · executionWorker.start · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

代码证据

引用核验检查固定 commit 的文件与范围;实现结论来自代码阅读。自动检查不证明生产环境已启用。

已核验实现

Gateway / SessionBinding 先确定身份与会话,Agent 绑定路径进入 Runtime;ExecutionHostRouter 委派工具。

aida-agentpackages/agent/src/gateway/session-binding.ts:59–897f2e519936b57902d4907ed8026fe1ecdd146e82符号:agentId: string | null
aida-agentpackages/agent/src/gateway/orchestrator-runtime.ts:434–4627f2e519936b57902d4907ed8026fe1ecdd146e82符号:prepareExecution
aida-agentpackages/agent/src/execution-host/router.ts:50–807f2e519936b57902d4907ed8026fe1ecdd146e82符号:ExecutionHostRouter
已核验实现

prepareExecution 成功时返回 input、deps 与可选 fingerprint(不调模型);resolveAndRun 再把它们交给 orchestrate。

aida-agentpackages/agent/src/gateway/orchestrator-runtime.ts:434–4627f2e519936b57902d4907ed8026fe1ecdd146e82符号:prepareExecution
aida-agentpackages/agent/src/gateway/orchestrator-runtime.ts:1456–14587f2e519936b57902d4907ed8026fe1ecdd146e82符号:fingerprint
aida-agentpackages/agent/src/gateway/orchestrator-runtime.ts:411–4187f2e519936b57902d4907ed8026fe1ecdd146e82符号:resolveAndRun
条件路径

RunExecutionWorker 在 chat role 装配,使用 Runtime 准备能力,并经 workbenchExecution 驱动 routed Work。

aida-agentpackages/agent/src/runtime/execution/run-execution-worker.ts:72–737f2e519936b57902d4907ed8026fe1ecdd146e82符号:RunExecutionWorker
aida-agentpackages/agent/src/index.ts:2625–26437f2e519936b57902d4907ed8026fe1ecdd146e82符号:workbenchExecution