由界
登录
快速入门最近更新：2026年4月13日

快速上手

5 分钟完成安装并运行你的第一个 Agent，从创建到对话的完整流程。

欢迎使用由界！本指南将带你从零开始，在 5 分钟内完成安装并运行你的第一个 Agent。

你将完成的 3 个步骤

步骤 1：下载并安装由界客户端
    ↓
步骤 2：从 Agent 市场创建你的第一个 Agent（起名 · 配色 · 设置安全规则）
    ↓
步骤 3：启动 Agent，打开对话窗，开始交互

前置要求

  • 操作系统：Windows 10/11（64位）、macOS 13 及以上
  • 磁盘空间：建议预留 5GB 以上（供 Agent 沙箱使用）
  • 网络：安装和登录需要网络连接

不需要安装 Python、Node.js 或任何其他运行环境。由界会帮你处理一切。

步骤 1：下载与安装

详细的下载和安装步骤请参考 下载与安装。

安装完成后，使用手机号 + 短信验证码登录（首次登录即自动注册）。

步骤 2：创建你的第一个 Agent

什么是 Agent

在由界中，每个 AI Agent 实例被称为 Agent。每个 Agent 都运行在由界独立的沙箱中，拥有自己的名字、专属颜色和安全规则。

你可以为不同的任务创建不同的 Agent：

  • 一个 Agent 专门用于代码生成，只能访问你的项目目录
  • 一个 Agent 用于文档整理，可以访问桌面文件夹
  • 一个 Agent 用于网页搜索，开放网络访问

各个 Agent 之间完全隔离，互不干扰。

2.1 从 Agent 市场创建 Agent

  1. 登录后进入主界面，点击左侧导航栏的"Agent 市场"
  2. 浏览或搜索你想使用的 Agent 模板
  3. 点击模板卡片，再点击"创建"

2.2 填写 Agent 基本信息

弹出创建对话框后，填写以下内容：

Agent 昵称

为你的 Agent 起一个有辨识度的名字，例如：

  • 代码助手
  • 文档整理
  • 数据分析

支持汉字、字母、数字、下划线和短横线，2-32 个字符。

安装位置

选择 Agent 在本机的安装目录，默认路径即可。如有需要，可点击"浏览"自定义。

Agent 边框颜色

为这个 Agent 选一个专属颜色，颜色会显示在底栏图标的边框上，方便多个 Agent 同时运行时快速区分。

2.3 配置安全规则（安全设置）

Agent 创建完成后，进入我的 Agent，切换到"安全设置"标签，配置这个 Agent 的安全边界。

文件权限

设置 Agent 可以访问哪些目录：

模式 说明 适用场景
白名单模式 只允许访问列表中的目录，其他全部禁止（推荐） 明确知道 Agent 需要哪些文件
黑名单模式 禁止访问列表中的目录，其他放行 只想保护特定敏感目录

在白名单中添加目录时，可以设置权限：

  • 只读：Agent 只能读取，不能修改
  • 读与写：Agent 可以读取和修改

快速上手建议：选择白名单模式，只添加你希望 Agent 访问的工作目录。

网络权限

控制 Agent 的网络访问：

设置 说明
拦截本地网络（开启） Agent 无法探测局域网内的其他设备，推荐保持开启
拦截本地网络（关闭） Agent 可访问局域网，适合需要访问内网服务的场景

2.4 配置 AI 模型和技能（Agent 配置）

切换到"Agent 配置"标签，可以配置 Agent 使用的 AI 大模型和功能技能（Skills）。

  • Base URL / API KEY / Port：由界默认已提供配置，可以直接使用；如有自己的 API Key，也可以填入自定义模型配置
  • 模型（Models）：选择 Agent 使用的 AI 模型
  • 技能（Skills）：为 Agent 选配功能技能，扩展其能力

第一次使用建议保持默认配置，后续熟悉后再按需调整。

2.5 启动 Agent

配置完成后，切换到"控制台"标签，点击"运行"按钮，启动 Agent。

启动后，底栏会出现该 Agent 的图标，左键单击可快速打开对话窗口，开始向 Agent 布置任务。

步骤 3：运行 Agent，开始对话

3.1 启动 Agent

在主界面左侧导航栏点击"我的 Agent"，找到你刚创建的 Agent，点击"运行"按钮。

Agent 启动后：

  • 状态变为"运行中"
  • 屏幕底栏出现该 Agent 的图标

3.2 打开对话窗口

有两种方式打开与 Agent 的对话界面：

方式一：底栏左键单击

直接单击底栏中的 Agent 图标，即可快速打开对话窗口。这是日常使用中最常用的方式。

方式二：管理页顶部按钮

在我的 Agent 顶部操作栏，点击"消息"按钮，打开聊天界面。

对话界面打开后，在输入框中输入你的任务，按回车发送，Agent 开始执行。

3.3 查看 Agent 运行情况

在我的 Agent 的"控制台"标签，可以查看 Agent 的实时运行状态：

  • 启动日志：Agent 启动过程中的输出
  • 运行日志：Agent 执行任务时的操作记录
  • 错误日志：如有异常，在此查看具体错误信息

如需查看 CPU、内存等性能数据，切换到"运行数据"标签。

3.4 查看 Agent 的文件（专属电脑）

每个 Agent 都有一台独立的「专属电脑」，与你的真实系统完全隔离。Agent 生成的所有文件都保存在这里。

打开专属电脑的方式：

  • 底栏右键菜单：在底栏的 Agent 图标上右键单击，选择"访问 XX 的电脑"
  • 管理页顶部按钮：在我的 Agent 顶部操作栏，点击"XX 的电脑"按钮

进入专属电脑后，你可以浏览 Agent 生成的文件，将需要的内容复制到本地。

3.5 停止 Agent

任务完成后，点击我的 Agent 顶部的"停止运行"按钮，或在底栏图标上右键 → 选择停止。

停止后 Agent 的文件和配置保留，下次点击"运行"可以继续。

3.6 底栏右键：快捷操作一览

在底栏 Agent 图标上右键单击，可以快速完成以下操作，无需进入管理页：

操作 说明
消息 打开对话窗口
访问 XX 的电脑 打开 Agent 的专属电脑（隔离文件目录）
终端 在专属电脑中打开终端
启动 / 停止 控制 Agent 运行状态
更新 有新版本时在此更新
选项 更多设置

恭喜！你已完成全部上手流程

你现在已经会：

  • 下载安装由界
  • 创建带安全规则的 Agent
  • 启动 Agent 并开始对话
  • 查看运行日志和专属电脑文件
  • 通过底栏快捷操作管理 Agent

接下来可以探索