AgentKit Studio
入门

5 分钟快速开始

安装桌面端、配置模型凭证、创建第一个 Agent,并跑通一次真实对话。

这一页只有一条路径:从零到一次成功的模型调用。全程不需要终端。

安装桌面端

打开下载页,选择与你的平台匹配的安装包:

平台文件说明
macOS(Apple Silicon)AgentKit-Studio-mac-arm64.dmg签名并公证
Windows 11(x64)AgentKit-Studio-win-x64.exeNSIS 安装器

macOS 仅支持 Apple Silicon

不提供 Intel(x64)安装包。Intel Mac 用户请改用作为 DSH 插件安装,或使用云托管运行时。

首次启动时,如果 macOS 提示「无法验证开发者」,到系统设置 → 隐私与安全性点「仍要打开」。 Windows 的 SmartScreen 提示选择「更多信息 → 仍要运行」。

配置模型与凭证

首次启动会自动打开凭证引导。如果错过了,从 设置 → 模型与凭证 重新进入。

  1. 选择或新增一个模型供应商端点。
  2. 填入 API Key。
  3. 选择一个可用模型。

凭证存在哪里

API Key 只写入 Host 侧的凭证存储,不会进入 Agent 配置、浏览器表单回填或日志。 见安全与公开边界。

创建第一个 Agent

  1. 打开 智能体 面板。
  2. 点 更多创建方式 → 手动配置。
  3. 按三步表单填写:
步骤你要决定什么
基本信息名称、描述、系统提示词
绑定能力运行时类型(默认 DSH Native Harness)、模型、可选的 MCP / Skill / 知识库 / Memory
策略与确认执行策略(默认 workspace-write)、审批规则、云记忆开关
  1. 点 创建。这会生成第一个修订版本(Revision)。

发第一条消息

在智能体列表里选中它,直接输入一句话,例如「列出当前工作区里的文件并说明它们在做什么」。

你会看到:

  • 工具调用按顺序展开,可以逐条查看参数与结果。
  • 底部显示本轮用量与耗时。
  • 如果 Agent 修改了文件,右侧会出现文件变更卡片,可以逐份对比。

验证成功

一次成功的运行需要同时满足三条:

  • 出现完整的最终回答(不是错误摘要)。
  • 工具调用有 completed 结果,没有 RUNTIME_RUN_FAILED。
  • 会话历史在刷新后仍然存在。

任何一条不满足,去排障按错误码定位。

完成之后

本页导航