个人助手

个人助手是 AIOS 工作台中的智能协作入口。你可以创建多个 Agent，让它们分别承担资料整理、内容创作、数据分析、研发协作、日程提醒等任务；也可以把本机正在运行的 Agent 接入 AIOS，在一个页面中持续对话和管理工作上下文。

本文介绍个人助手页面的布局、Agent 创建与管理、对话、文件、日程、技能、插件、渠道和常见问题。

什么是 AIOS Agent

AIOS Agent 是运行在 AIOS 平台或用户本地环境中的智能协作成员。它不仅可以回答问题，还能结合对话上下文、文件、技能、插件和运行环境持续完成任务，例如整理资料、分析数据、生成内容、辅助研发和安排日程。

每个 Agent 都有独立的名称、介绍、会话、文件和能力配置。为不同职责分别创建 Agent，可以减少无关上下文相互干扰，也方便在项目中让多个 Agent 分工协作。

AIOS Agent 主要包括两种运行方式：

• 云端 Agent：运行在 AIOS 云端环境中，适合长期在线、跨设备使用和持续执行任务。
• 本地 Agent：接入用户自己的电脑或本地运行环境，适合处理本地代码、私有文件和桌面应用任务。

什么时候需要新建 Agent

默认个人助手可以处理一般对话和日常任务。出现以下情况时，建议创建专属 Agent：

• 需要固定职责：长期处理周报、客户跟进、内容运营、项目整理或代码审查等同类任务。
• 需要专业工作方式：希望 Agent 按特定职业模板、方法或输出标准完成任务。
• 需要隔离上下文：不同业务、客户或项目之间不应共享对话和文件。
• 需要本地能力：任务必须读取本地仓库、文件或操作本机环境。
• 需要团队协作：希望在项目中让多个 Agent 分工，并由成员通过 @Agent 指定执行者。

例如，可以分别创建“运营-周报助手”“研发-代码审查助手”和“客户-跟进助手”。命名时写清岗位和用途，后续切换、搜索和组建项目会更方便。

功能入口

登录 AIOS 后，在工作台进入“个人助手”。

如果链接中带有 profileKey 参数，页面会直接打开对应 Agent。例如：

/workbench?profileKey={Agent 标识}

profileKey 用于定位 Agent，不需要手工修改。若链接对应的 Agent 已删除、当前账号无权访问或不属于当前个人/企业上下文，页面会提示 Agent 不存在或无权访问。

图中标出 Agent／项目切换、文件与日历等顶部工具入口，以及消息输入和模型选择区域。进入具体功能后，右侧会打开对应面板，不会中断当前对话。

页面布局

个人助手页面主要分为四个区域：

区域	主要用途
左侧导航栏	展开或收起 Agent 列表、打开收藏夹、切换工作台功能
Agent 与项目列表	切换 Agent 或协作项目，查看头像、状态、未读数、最近消息和更新时间
对话区	查看消息、任务执行过程、文件结果、运行状态以及需要人工确认的操作
顶部与底部工具区	打开文件、日历、设置、分享、历史搜索，上传附件、引用技能或文件、选择模型并发送消息

Agent 列表

左侧“AGENTS”分组展示当前账号可用的 Agent。点击 Agent 可切换对话；点击分组右侧的“+”可新建 Agent。列表支持折叠，折叠后可通过头像快速切换。

每个 Agent 条目可能显示：

• Agent 名称和头像。
• 最近一条消息或 Agent 描述。
• 最近更新时间。
• 未读消息数量。
• 本地 Agent 的在线或离线状态。

右键点击 Agent，可执行“置顶”或“取消置顶”。非默认 Agent 还可以从右键菜单中删除。

若已创建协作项目，左侧还会出现“项目”分组。项目用于多人或多个 Agent 围绕同一目标协作，相关操作请参考项目管理手册。

对话区顶部

对话区顶部显示当前 Agent 的头像、名称和状态。点击头像或名称可打开 Agent 信息卡，进行以下操作：

• 查看运行位置和在线状态。
• 点击头像上传新头像。
• 打开 Agent 设置。
• 将输入焦点定位到消息框。
• 基于当前 Agent 快速创建项目。

右上角工具按钮包括：

• 文件：查看当前云端 Agent 或项目的文件。
• 日历：查看当前云端 Agent 的日程。
• 设置：修改 Agent 信息和能力配置。
• 分享：选择对话消息并生成分享链接。
• 搜索历史对话：按关键词查找历史消息并定位到原对话。

本地 Agent 的文件保存在本地设备中，因此页面不会显示云端“文件”和“日历”入口。

快速开始

第一次使用时，可以按以下步骤完成一轮对话：

1. 进入“个人助手”，从左侧选择一个在线 Agent。
2. 在底部输入框中说明目标、背景、输入材料和期望结果。
3. 如需使用本地文件，点击“+”上传附件；如需引用收藏文件或技能，点击“/”或直接输入 /。
4. 根据任务需要，在发送按钮左侧选择“自动”或指定模型。
5. 点击发送按钮，等待 Agent 返回结果。
6. Agent 执行过程中如请求命令授权或补充信息，阅读提示后选择允许、拒绝或填写答案。
7. 如需中止当前生成或执行，点击输入区右侧的停止按钮。

建议一次把任务交代清楚。例如：

请阅读我上传的销售数据，按产品统计本月销售额和环比变化，列出异常数据，最后生成一份适合周会汇报的 Markdown 摘要。不要修改原文件。

相比“分析一下”这类简短指令，包含目标、数据范围、输出格式和限制条件的指令更容易得到稳定结果。

底部消息输入区可在上方“AIOS 个人助手页面总览”中查看，其中包含附件、“/”引用、插件、模型选择和发送入口。

创建 Agent

AIOS 支持新建云端 Agent，也支持接入本地 Agent。

新建云端 Agent

云端 Agent 适合长期在线、持续执行和跨设备协作。

1. 在左侧“AGENTS”分组右侧点击“+”。
2. 在“新建 Agent”窗口中选择“新建云端 Agent”。
3. 从职业分类中选择与任务匹配的职业模板；可通过搜索框按名称或描述查找。
4. 填写 Agent 名称。名称最多 40 个字符，建议使用“岗位/场景 + 职责”的方式命名，例如“运营周报助手”或“研发代码审查助手”。
5. 填写描述。描述最多 100 个字符，用于说明这个 Agent 的工作重点。
6. 点击“创建”。创建完成后，AIOS 会将新 Agent 加入左侧列表并打开对话。

职业模板用于提供起始能力和工作定位。创建后仍可在设置中修改 Agent 名称、介绍、技能和插件。

可通过职业分类和搜索框缩小范围，选中合适的职业模板后再确认创建。

选择职业模板

职业模板用于快速确定 Agent 的工作方向。选择时应以页面当前展示的模板为准，不需要追求模板名称完全匹配；重点判断模板的职责、擅长任务和预置能力是否符合需求。

建议按以下顺序选择：

1. 先明确长期职责，例如调研、运营、研发或办公协作。
2. 查看模板说明，选择工作方法最接近的模板。
3. 用清晰的名称和描述补充具体业务范围。
4. 创建后先执行一个小任务，检查输出结构和能力是否符合预期。
5. 再按需添加技能、插件和文件，不要一次堆叠过多无关能力。

页面中的职业分类和模板可能随企业配置、账号权益或版本更新而变化，手册不固定列出模板清单。

接入本地 Agent

本地 Agent 适合处理本地仓库、文件或桌面环境中的任务。接入前请确保目标电脑已安装并登录 AIOS 桌面端，或者已准备好受支持的本地 Agent 运行环境。

1. 在左侧“AGENTS”分组右侧点击“+”。
2. 选择“接入本地 Agent”。
3. 填写 Agent 名称和描述，然后生成连接请求。
4. 如接入当前电脑，点击“连接此电脑”，允许 AIOS 桌面端响应连接。
5. 如接入其他电脑或独立运行的 Agent，点击“复制命令”，在目标终端中执行页面生成的命令。
6. 执行后返回 AIOS，点击“我已执行”，等待页面检查连接状态。
7. 如果系统检测到多个本地运行框架，选择本次要使用的 Agent，再点击“使用所选 Agent”。
8. 页面显示“本地 Agent 已接入”或 Agent 状态变为在线后，即可开始对话。

连接命令和配对凭据只应用于本次接入。不要把命令、配对码或包含凭据的截图发送给无关人员。若配对窗口过期，请重新生成连接请求，不要反复执行旧命令。

图中的 Token 和配对码已脱敏。实际连接命令仅用于当前接入流程，不能转发或长期保存。

云端 Agent 与本地 Agent 的区别

对比项	云端 Agent	本地 Agent
运行位置	AIOS 云端运行环境	用户自己的电脑或本地运行环境
在线要求	云端运行环境可用即可	本地电脑、网络和 Agent 进程需要保持在线
云端文件面板	支持	不显示，本地文件保留在本地设备
日历入口	支持	不显示
技能和插件配置	可在设置中管理	以本地 Agent 自身能力和配置为准
适用场景	长期在线、跨设备任务、持续协作	本地代码、私有文件、桌面应用和本机环境任务

与 Agent 对话

发送基础指令

在消息输入区输入内容后点击发送，或使用页面支持的发送快捷方式。一个清晰的任务通常包含：

• 目标：最终要完成什么。
• 背景：任务面向谁、用于什么场景。
• 材料：需要读取的文件、链接、收藏或历史内容。
• 输出：需要文档、表格、代码、摘要还是其他格式。
• 约束：时间范围、篇幅、语言、禁止操作和验收标准。

任务复杂时，可以要求 Agent 先给出计划，确认后再执行。涉及发送消息、修改文件或操作外部系统时，应明确操作范围，并认真处理页面出现的授权确认。

上传附件

点击输入框左下角的“+”选择文件。当前单次对话最多添加 10 个附件：

• 单张图片不超过 10 MiB。
• 其他单个文件不超过 100 MiB。
• 本次消息的附件总大小不超过 2 GiB。

文件上传完成前不能发送消息；上传失败的文件需移除或重新上传。上传后可点击附件预览，确认文件正确再发送。

不要上传与任务无关的敏感文件。涉及个人信息、商业秘密或账号凭据时，应先确认数据使用范围和当前账号权限。

引用收藏文件或技能

点击输入区的“/”按钮，或在输入框中输入 /，可以打开引用列表：

• 选择“文件”可引用收藏夹中的文件。
• 选择“技能”可指定当前 Agent 已启用的技能。
• 输入关键词可快速筛选目标内容。

选中后，引用会随本次消息一起发送。引用技能表示希望 Agent 在当前任务中优先使用该能力，但是否调用仍取决于任务内容、技能状态和运行条件。

选择模型

消息输入区右下角提供模型选择：

• 自动：由 AIOS 根据任务和当前可用模型进行选择，适合日常使用。
• 指定模型：手工选择当前账号和空间可用的模型，适合对模型能力、速度或成本有明确要求的任务。

可选模型受账号权益、企业/空间配置和模型服务状态影响。切换模型只影响后续发送的消息，不会重新生成已经完成的回复。运行长文本、复杂推理或大附件任务前，建议先查看可用积分和计费规则。

处理执行中的确认

Agent 可能在执行过程中请求命令授权、参数补充或其他人工输入。此时输入区上方会显示确认卡片：

1. 核对 Agent 将要执行的命令或操作。
2. 确认目标文件、系统和影响范围是否符合你的指令。
3. 选择“允许”继续，或选择“拒绝”停止该操作。
4. 如果 Agent 请求补充信息，填写明确答案后提交。

不要在看不懂命令或影响范围不明确时直接允许。可先要求 Agent 解释操作目的、目标和风险。

引用、分享和搜索历史消息

• 引用消息：在目标消息的操作菜单中选择引用，再输入追问，AIOS 会携带该消息上下文。
• 分享对话：点击右上角“分享”，勾选要分享的消息，按需开启“允许访问对话中的文件”，然后复制分享链接。一次最多选择页面提示数量的消息。
• 搜索历史对话：点击右上角搜索按钮，输入关键词并选择结果，页面会定位到对应历史消息。

分享前检查消息和附件是否包含敏感信息。关闭“允许访问对话中的文件”后，访问者不能通过分享页读取这些文件。

分享前依次确认所选消息、文件访问权限和分享范围，再复制链接。

建立长期协作方式

为了让 Agent 更稳定地配合工作，可以在首次对话中主动说明以下信息：

• 你的岗位、常用称呼和主要职责。
• 偏好的沟通风格和输出语言。
• 常用文档格式、汇报结构和质量标准。
• 需要长期遵守的边界，例如不得修改原文件、不得对外发送内容。

示例：

我是产品经理，请称呼我为小明。后续输出默认使用简体中文，先给结论再给依据；需求分析使用“背景、目标、范围、流程、验收标准”结构。未经我明确确认，不要发送消息或修改线上数据。

Agent 是否在后续会话继续使用这些信息，取决于当前会话、项目上下文及平台实际启用的记忆配置。重要规则仍建议在关键任务中再次说明，不要把安全边界完全依赖于历史记忆。

组建 Agent 团队

当一个目标需要不同角色共同完成时，可以创建协作项目并添加多个 Agent。在项目对话中使用 @Agent名称 指定执行者，例如：

@调研助手 整理本周行业动态并列出信息来源。
@运营助手 根据调研结果生成三条内容选题。
@审校助手 检查事实、措辞和发布风险。

建议让每个 Agent 只承担边界清晰的职责，并在项目说明中约定交付物、文件目录和验收标准，避免多个 Agent 重复处理同一任务。

管理 Agent 文件

打开文件面板

选择云端 Agent 后，点击对话页右上角的“文件”。面板会显示与当前 Agent 关联的文件；在项目对话中打开时，则显示对应项目的文件。

文件来源主要包括：

• 用户在对话中上传的文件。
• Agent 执行任务后生成的文档、表格、图片或其他结果文件。
• 用户加入收藏夹的文本、链接和本地文件。

查看和使用文件

在文件页面中可以：

• 在“全部文件”和“收藏夹”之间切换。
• 按文件名或收藏内容搜索。
• 展开文件夹并查看目录内容。
• 预览 AIOS 当前支持的图片、PDF、文本、Markdown、音视频、Word、Excel 和压缩包目录等内容。
• 下载文件；不支持在线预览的类型可下载后查看。
• 将文件加入收藏夹，或从收藏夹引用到对话。
• 收藏文本、链接或本地文件，并使用标签分类。

文件预览或下载失败时，先确认文件仍存在、当前账号有权限且文件服务可用。不要因预览失败反复上传同一文件，以免产生重复内容。

文件面板包含“全部文件”“收藏夹”和搜索框；没有文件时显示空状态，上传文件后可在此搜索、预览、收藏或下载。

管理日程

打开日历

选择云端 Agent 后，点击对话页右上角的“日历”。日程面板包含：

• 日历：按日期查看待执行、执行中、已完成或异常的日程实例。
• 日程管理：集中查看一次日程和循环日程及其运行状态。

本地 Agent 不显示 AIOS 云端日历入口。

在“日历”和“日程管理”间切换，可以分别查看某日任务和全部日程定义。

创建日程

可以在日程页面点击“创建日程”，也可以直接在对话中用自然语言要求 Agent 创建。例如：

帮我创建一个日程：每周一上午 9 点整理上周项目进展，并生成周报提纲。

创建前应明确任务内容、执行时间、时区，以及是一次执行还是循环执行。创建成功后，到“日程管理”核对频率和下次执行时间，避免因自然语言歧义产生错误计划。

查看和控制日程

打开日程详情后，可查看：

• 日程类型：一次日程或循环日程。
• 当前状态。
• 执行频率。
• 预计开始时间。
• 实际开始时间、完成时间或执行进度。
• 日程任务描述。

未完成的一次日程或循环日程可按页面状态暂停或恢复。终止日程后，该事项不会继续出现在日历中，操作前应确认不再需要后续执行。

在详情页核对状态、频率、执行时间和结果后，再执行暂停、恢复或删除操作。

Agent 设置

点击对话页右上角“设置”，或点击 Agent 头像后打开设置。设置内容会随 Agent 类型和权限变化。

设置面板集中展示 Agent 信息、技能、插件和置顶对话等选项。图中为云端 Agent 的实际界面，具体项目会随 Agent 类型及账号权限变化。

修改 Agent 信息

1. 点击“修改 Agent 信息”。
2. 修改伙伴名称和伙伴介绍。
3. 返回上一级时，AIOS 会保存已发生的修改。

还可以点击对话页顶部的 Agent 头像上传新头像。请选择常见图片文件；上传成功后，列表和对话标题会同步更新。

管理技能

云端 Agent 的设置中会显示当前已添加技能数量。

1. 进入“设置 > 技能”。
2. 点击“添加”。
3. 从“我的技能”“企业技能”或“平台技能”中查找目标技能；平台技能还可以按分类筛选。
4. 点击添加，将技能绑定到当前 Agent。
5. 返回技能列表，通过开关启用或禁用技能。

禁用只会阻止当前 Agent 调用该技能，不会从“我的技能”中删除技能。如果技能本身已在技能管理中停用，即使当前 Agent 的开关开启也不能正常使用。付费技能需先获取有效权益。

管理插件

云端 Agent 的“能力与资源”区域提供插件入口。打开插件管理后，可以查看、添加或调整当前 Agent 可调用的插件。插件可能需要额外认证或参数配置；首次添加后建议用最小输入测试一次，再用于正式任务。

不要把第三方 API Key、Token 或账号密码写入对话、截图或公开文档，应通过平台提供的安全配置入口维护。

配置消息渠道

消息渠道仅在默认云端助手的设置中展示。当前页面支持微信渠道：

1. 进入默认助手的“设置 > 渠道”。
2. 点击“添加”，选择微信；如果菜单显示“已添加”，说明当前 Agent 已经存在微信渠道，无需重复添加。
3. 新增渠道后点击“去授权”；已有渠道显示“异常”或授权失效时，通过渠道操作菜单选择“重新授权”。
4. 在授权说明页再次点击“去授权”获取实时二维码。
5. 使用微信扫描二维码，并在手机端确认连接。
6. 等待页面显示授权成功和渠道已连接。

渠道菜单支持重新授权或关闭渠道。关闭后，默认助手将不再通过微信收发消息；后续可以重新添加并授权。二维码过期时应刷新授权，不要使用旧二维码。

图中展示的是获取二维码前的授权说明页，不包含实时二维码。实际操作时单击“去授权”，扫描页面当次生成的二维码，并在手机端确认连接；二维码过期后应重新获取。

置顶对话

打开“置顶对话”开关后，当前 Agent 会固定显示在列表上方。也可以在左侧列表中右键 Agent，选择“置顶”或“取消置顶”。

重新连接本地 Agent

本地 Agent 离线时，进入“设置 > 重新连接”：

1. 点击“重新连接”生成新的连接请求。
2. 选择“连接此电脑”，或复制命令到目标终端执行。
3. 返回页面点击“我已执行”。
4. 如检测到多个运行框架，选择目标 Agent 并确认。
5. 等待状态变为在线，再发送新消息。

排查离线问题时，同时检查本地电脑网络、AIOS 桌面端登录状态和本地 Agent 进程。

删除 Agent

默认个人助手不能删除。删除其他 Agent 时：

1. 在左侧列表中右键目标 Agent。
2. 选择“删除 Agent”。
3. 阅读删除影响，在输入框中完整输入 Agent 名称。
4. 点击“删除”。

删除会终止该 Agent 正在进行的对话，并同步删除其消息历史、文件和技能绑定；该 Agent 也会退出已加入的项目，但项目文件不受影响。所有数据删除后无法找回，操作前应下载或转移需要保留的文件。

截图建议：删除确认窗口，展示删除影响、名称确认输入框和“删除”按钮，避免在截图中出现真实敏感数据。

使用建议

• 为不同职责创建不同 Agent，避免长期把不相关任务混在一个对话中。
• Agent 名称体现岗位和用途，例如“财务-月报分析”“研发-接口测试”。
• 复杂任务先说明验收标准，再让 Agent 执行。
• 长任务执行前确认模型、附件、积分余额和授权范围。
• 涉及文件修改、外部发送或系统操作时，保留人工确认环节。
• 定期整理 Agent 文件、收藏和技能，停用不再使用的能力。
• 本地 Agent 不用时应断开连接；连接命令和配对信息不要外泄。

常见问题

页面提示 Agent 不存在或无权访问

先确认链接中的 profileKey 是否来自当前账号，并检查当前处于个人模式还是正确的企业上下文。如果 Agent 已删除或不属于当前账号，应从左侧列表重新选择可用 Agent。

Agent 一直显示正在准备

云端运行环境可能仍在初始化。等待片刻后重试；若页面显示初始化失败，点击“重试”。仍然失败时，记录发生时间、Agent 名称和页面错误提示，联系管理员检查运行服务。

本地 Agent 显示离线

确认目标电脑已联网、AIOS 桌面端已登录、本地 Agent 进程仍在运行。随后进入 Agent 设置重新生成连接请求，不要继续使用已过期的旧命令。

找不到文件或日历按钮

本地 Agent 不显示云端文件和日历入口。云端 Agent 中仍不可见时，确认当前选择的是 Agent 而非受限页面，并检查账号权限和运行环境是否已完成初始化。

找不到渠道设置

消息渠道只显示在默认云端助手中。本地 Agent、非默认 Agent或权限不足的账号不会显示该配置。

技能已经添加但没有被调用

检查技能是否在当前 Agent 中启用、是否在“我的技能”中保持可用，以及输入是否明确需要该技能。可在消息中通过 / 主动引用技能，再进行一次最小任务测试。

附件无法发送

检查附件数量和大小：最多 10 个附件，图片单个不超过 10 MiB，其他文件单个不超过 100 MiB，总大小不超过 2 GiB。等待所有附件上传完成，并移除显示上传失败的文件。

如何停止正在执行的任务

Agent 生成或执行期间，发送按钮会切换为停止按钮。点击停止可终止当前会话任务。停止后如需继续，请重新说明要保留的上下文和下一步操作。

相关手册

• 项目管理
• 技能管理
• 任务中心
• 积分、充值与市场购买
• 个人信息、企业切换与系统设置