AgentKit Studio
入门

界面导览

四个面板、七个二级标签、两处设置和插件页各自能做什么;以及为什么 Studio 没有 URL 可以收藏。

Studio 的界面只有两层:左侧面板和面板内的二级标签。没有第三层导航,也没有需要学习的路由。

先记住一件事

Studio 是 DSH 宿主里的一个产品插件,界面状态全部在内存里。不存在 /agents/123 这样的 URL——刷新浏览器会回到默认面板。 详见为什么没有 URL。

全局骨架

每个面板的顶部都有同一套 chrome(src/client/components/shell.mjs:46-49):

元素位置说明
面板标题左上当前面板名,取自 PANELS 的 label
Host 状态胶囊右上三态:Host 已连接 / 读取 Host / Host 待接入
页面动作右上面板自己的主操作按钮

Host 状态胶囊会先请求 health(),失败时再退到 bootstrap();只有 health 通过且 workspaceReady !== false 才显示「已连接」(shell.mjs:11-29)。

四个面板

面板定义在 src/client/theme.mjs:19-24,顺序即左侧导航顺序:

面板内部 id一句话图标
总览overview工作区状态⌂
智能体agents我的智能体与模板广场✦
资源库resource-hub模型、工具与运行资源◈
运行中心operations构建、部署与观测↗

总览

打开就能看到「现在能不能开始干活」:

区块能做什么依据
凭证提醒条未配置模型凭证时提示「先配置一个模型凭证,即可开始对话」,并跳转设置src/client/pages/overview.mjs:44
创建 Agent三个入口:对话创建(和 AI 一起完善配置)、手动配置(选择运行时与能力)、从模板开始(复用专家模板)overview.mjs:45-49
工作区四个统计卡:Agent、运行时、资源、交付;Agent / 资源 / 交付可点击跳转overview.mjs:50-53
启动检查折叠区,展开后跑三项检查并显示 confirmed / missing / unknownoverview.mjs:54

「启动检查」的三项固定是 Host 连接、模型凭证、运行目标目录(src/client/state/start-checks.mjs:22-26)。三项都有 8 秒超时,超时记为 unknown 而不是失败。

三种状态的含义

已确认 = 读到了真实配置;缺少配置 = 明确没配;未知 = 读不到(超时、连接失败、目录未提供)。 「已确认」不代表工具执行或模型调用已经验证通过——同一句话在检查区底部也写了一遍。

智能体

二级标签只有三个(src/client/pages/agents.mjs:170):

标签内容
本地本机工作区里的 Agent 列表
云端已部署到云端的 Agent
运行目标当前 Host 可用的执行目标目录

「运行目标」读的是 runtimeCatalog,整页有三个状态:正在读取 / 目录已读取 / 运行目标不可用(src/client/pages/runtime-catalog.mjs)。每一行另有自己的可用性:「未启用」意味着 Host 没注册对应 capability,需要去插件中心安装并启用官方插件。

资源库

一级标签是六类资源(src/client/pages/resources.mjs:45-48):

资源类型二级标签说明
模型—模型配置与凭证引用
MCP资源广场 / 已安装·已连接探测通过只代表连接和工具列表读取成功
Skill资源广场 / 已安装·已连接本地已导入 ≠ 云端可用 ≠ 依赖已验证
知识库—每类默认绑定一个
记忆库—每类默认绑定一个
运行资源—运行目标带出来的资源

资源库不管绑定

资源库只负责资源目录生命周期:发现、导入、探测、查看、删除、状态刷新。 新增或变更 Agent 绑定关系要在 Agent 创建页或编辑页完成。

运行中心

五个二级标签(src/client/pages/operations.mjs:23):

标签看什么二级视图
构建与部署构建产物、部署记录、环境、日志筛选:当前 Agent / 全部
自动化定时与触发任务状态:待执行 / 执行中 / 需关注 / 已暂停;作用域:本地 / 云端部署
评测评测任务与通过率详情:用例 / 断言
观测Trace 列表与 Span 详情详情:属性 / 事件 / 资源 / 轨迹 / 原始 OTLP
Channels远端渠道绑定与审批审批:申请人 / 渠道 / 会话 / 状态

设置

Studio 往 DSH 的设置对话框里注入了两节,而不是自己造一个设置页(src/client/dsh/mount.mjs:301-305):

设置节顺序里面有什么
模型与凭证190模型列表、当前运行模型、默认模型、输入能力、思考等级、API Key、提供商
AgentKit Studio200本机运行(会话绑定策略、默认执行目标、Studio Host、下一句提示)+ 版本与更新(三个版本号、桌面更新)

「模型与凭证」的编辑是方案 C:任何字段改动先写进内存草稿,只有「保存配置」才落到 Host 存储。所以切走会有「未保存」提示,刷新会丢草稿(src/client/pages/model-settings.mjs 的 data-unsaved 分支)。

插件页

DSH 插件页是产品内的插件市场(src/client/pages/dsh-plugins.mjs):

  • 15 个分类:全部、视觉外观、界面增强、记忆与上下文、搜索与联网、图像与媒体、文档与办公、模型与路由、成本与用量、效率与通知、协作与工作流、输入与编辑、安全与质量、助理、其他。
  • 4 种排序:推荐、下载量、最近更新、名称。
  • 插件状态:已启用、可安装、已停用、部分加载、加载失败、已配置、未安装、验证通过、验证失败、待重启。
  • 「已安装」在第二个标签里管理,与「发现」分开。

为什么没有 URL

page 是一个 React state,切换面板调的是 onNavigate('studio-operations') 这样的字符串(src/client/pages/overview.mjs 与 src/client/operations-focus.mjs:14),不是 history.pushState。

你想要现实
收藏某个 Agent❌ 不支持,用会话历史找
分享一个部署详情链接❌ 不支持,只能截图或导出
浏览器后退回到上一个面板❌ 后退会离开 Studio
刷新后回到原面板❌ 回到默认面板

只有少数界面状态会持久化到 localStorage:

agentkit-studio:agents-view          # 智能体面板上次的二级标签
agentkit-studio:resource-kind        # 资源库上次的资源类型
agentkit-studio:resource-library-view # 资源广场 / 已安装
agentkit-studio:resource-tab         # 资源详情上次的标签
agentkit-studio.prompt-prediction.enabled # 下一句提示开关

这些是偏好,不是导航状态——它们只影响下次打开时的默认选项。

下一步

看懂界面后,用第一次对话理解一次运行里到底发生了什么。遇到不认识的错误码,查排障。

本页导航