AgentKit Studio
概念

概念

用六个名词讲清 AgentKit Studio 的产品模型——智能体、修订版本、构建、会话、一次运行,以及承载它们的运行时。

AgentKit Studio 的产品模型只有六个名词:智能体(agent)、修订版本(revision)、Agent 构建(build)、会话(session)、一次运行(run),以及决定这些实体在哪执行的运行时类型(runtime type)。

这一章逐个讲透它们,并给出它们之间的硬性约束。读完这一章你可以自己回答「改一个配置会不会影响已经在跑的会话」这类问题,而不必先试一次。

系统分层

AgentKit Studio 五层架构:浏览器 UI、Studio 控制面、Host 服务域、运行时适配层与外部内核,以及 /agentkit RPC 与 HTTP 前缀两条物理通道AgentKit Studio 五层架构:浏览器 UI、Studio 控制面、Host 服务域、运行时适配层与外部内核,以及 /agentkit RPC 与 HTTP 前缀两条物理通道 (dark)点击放大 · 滚轮缩放 · 拖拽平移

读图要点:浏览器只发 operation id,不持有任何状态;Host 服务域是唯一持久化边界;运行时适配层之下全部是外部内核。两条物理通道里,只有 /agentkit RPC 会经过 134 个 operation 的分发器,模型代理与对话流走的是 HTTP 前缀路由。

为什么需要概念层

四个面板各自只暴露产品模型的一部分,同一批术语却在同一个屏幕上交叉出现:

你在界面上看到的它背后的概念最容易被误解成
保存后提示生成了新的修订版本修订版本可以被覆盖的草稿
运行中心里的构建记录Agent 构建CI 构建或镜像构建
智能体列表里的一行智能体一个正在运行的进程
会话列表里的一条历史会话一次请求的日志
底部显示的用量与耗时一次运行整个会话的累计量

把修订版本当成可覆盖的草稿,或者把构建当成流水线产物,都会导向同一个误判:以为改完配置,正在跑的会话会跟着变。事实是都不会变。原因不是产品「没做热更新」,而是这四个实体各自冻结在不同层次上,见Agent · Revision · Build · Run。

四个面板与它们的二级标签是这样组织的:

工作台地图:浏览器 UI 下分总览、智能体、资源库、运行中心四个面板,每个面板下的二级 tab 及其职责工作台地图:浏览器 UI 下分总览、智能体、资源库、运行中心四个面板,每个面板下的二级 tab 及其职责 (dark)点击放大 · 滚轮缩放 · 拖拽平移

读图要点:四个面板是并列的,没有从属关系;真正决定「这次运行在哪跑」的是 Agent 的运行时类型,不是面板。

「运行中心」的五个标签不是一个页面的五个分区,而是五个独立的工作面:构建与部署管产物,自动化管定时,评测管通过率,观测管 Trace,Channels 管远端渠道。它们之间没有共享的选中状态——切换标签不改变你正在看的是哪个 Agent。

六个核心实体的分工

实体主键冻结了什么生命周期由谁拥有
智能体agentId只拥有一份「当前指向」Studio 本地存储
修订版本revision一次编辑后的完整不可变快照智能体,只增不改
Agent 构建buildId某个修订版本加执行引擎的内容寻址包智能体,可重复构建
会话sessionId一条 DSH 持久事件日志宿主(Host)
一次运行runId一个 turn 从开始到结束会话
运行时类型runtime.type这次运行由谁的执行模型负责智能体创建时锁定

后两个标识(sessionId、runId)不由 Studio 生成,也不由 Studio 存储。Studio 只校验它们的绑定关系是否正确——绑定对不上就是错误,不会「尽量猜一个」。

概念之间的关系

智能体 agentId
  └─ 修订版本 revision 1..N        (不可变,保存即新增)
       └─ Agent 构建 buildId        (内容寻址,同一输入只有同一个 id)
            └─ 会话 sessionId       (DSH 拥有日志)
                 └─ 一次运行 runId  (一个 turn)

一次运行的完整身份必须五个字段齐全:agentId、revision、buildId、sessionId、runId。缺一个就拒绝,而不是降级成「部分身份」。这条规则同时意味着:没有构建的智能体也能对话,但没有构建就没有可复现的运行身份。

三种运行时

runtime.type 只有三个值,就是 STUDIO_RUNTIME_TYPES(src/runtime-contract.mjs:6):

值界面名称可以创建执行模型
dsh-nativeDSH Native Harness是(新建默认)native
harnessStar Harness条件可创建:已安装 + 已启用 + 有可用工作区native-kernel
codexCodex Agent是codex-app-server

Star Harness 是三者里唯一可插拔的:它由 ksadk-harness 的 npm 包提供,装好并绑定工作区后才会出现在创建表单里。见三种运行时。

五类可绑定资源

资源不是概念章的附注,它决定了「同一个提示词为什么在两个环境里表现不同」:

kind界面标签来源每类可绑几个
model模型本地模型配置 + 模型网关多个,其中一个默认
mcpMCP本地 MCP 目录 + 云端目录多个
skillSkill已安装 Skill + 云端 Skill Space多个
knowledge-base知识库云端控制面一个
memory-instance记忆库云端控制面一个

绑定写在修订版本上,所以换资源等于换修订版本。凭证值本身从不进修订版本,见资源与绑定。

哪些页面属于这一章

页面回答的问题
Agent · Revision · Build · Run四层冻结各自保证什么,哪些操作会破坏可复现性
三种运行时三种值分别由谁执行,能力矩阵怎么读
资源与绑定五类资源的形状、互斥规则与降级行为
会话与工作区事件日志归谁所有,工作区边界如何决定能写哪里
专家与本地团队专家模板与专家团怎么复用同一套冻结语义
托管运行时云端常驻与本地运行差在哪一层
术语表每个词唯一正确的写法

相关任务

相关参考

你要查的东西去哪一页
五个实体标识与能力矩阵的完整枚举运行时与实体契约
134 个控制协议 operation控制协议
错误码与用户动作对照错误码
16 个会话事件会话事件
19 个部署状态部署状态机

本页导航