# 核心概念

从一次任务理解模型、工具、上下文与文件，再按需要选择协作和自动化功能。

## 一次任务怎样完成

向 Nexus 提交“读取会议笔记，保存行动清单”后，Agent 需要先取得材料，再决定怎样整理，调用文件工具保存结果，最后读取或检查交付。模型负责理解与判断，工具负责读取、写入和访问外部服务，运行引擎组织这些步骤。

一项任务可能往返多次。读到材料缺少负责人时，Agent 可以标为待确认或向你提问；文件写入失败时，需要根据错误修正路径。聊天中的完成声明应与实际文件相互核对。

![从连接模型到检查交付文件的四个步骤](/images/docs/first-task.svg)

| 你看到的内容 | 意味着什么 | 你可以检查什么 |
| --- | --- | --- |
| 回复或计划 | Agent 对任务的理解和拟采取的步骤 | 范围、材料与交付是否正确 |
| 工具执行过程 | 正在读取材料或操作资源 | 路径、参数和返回结果 |
| 问题或审批卡片 | 执行需要信息或授权 | 回答是否足够，操作是否符合要求 |
| 文件链接与最终回复 | 本轮给出的交付 | 文件能否打开、内容是否满足要求 |

解释一段文字可以直接回答。需要报告文件时，应明确文件名与保存位置。选择模型时，也要确认它能支持任务需要的工具和输入类型，详见[模型服务](/docs/providers)。

## Agent 与会话怎样分工

Agent 是有长期身份的工作成员，可以配置职责、模型、技能和工具。会话承载某一次讨论的消息与执行过程。同一 Agent 可以维护多个会话，长期身份并不意味着每次都自动读入全部旧聊天。

持续维护一个项目时，可以创建专职 Agent；询问一次临时问题时，使用已有成员即可。Nexus 主智能体是默认管理入口，帮助理解和管理自己名下的资源，仍需遵守权限与确认要求。

## 文件、上下文与记忆

工作区保存实际文件。上下文是运行引擎为当前模型调用组织的信息，可能包括用户要求、已读材料和工具结果。长期记忆用于保留跨会话需要的稳定事实。

| 信息 | 适合放在哪里 | 后续使用方式 |
| --- | --- | --- |
| 原始会议记录 | 工作区文件或附件 | 指明材料，请 Agent 读取 |
| 本次要求保留哪些栏目 | 当前请求 | 在交接时保留关键约束 |
| 长期使用的报告格式 | 记忆或固定工作方法 | 查看内容，并在任务中验证是否采用 |
| 尚未完成的修改 | 交接文件 | 记录当前状态和下一步 |

NXS 使用 `MEMORY.md` 与 `memory/` 组织文件式记忆，其他引擎的加载规则需要分别确认。压缩上下文不会替你备份工作区，也不保证所有细节都留在后续调用中。长任务的处理见[上下文与交接](/docs/context-management)。

## 界面与执行机器

桌面任务通常在本机执行，Web 任务在服务器执行。浏览器打开了 Nexus，不代表服务器可以读取浏览器所在电脑的任意路径。通过附件上传、桌面目录挂载或服务器工作区提供材料时，要确认是哪台机器在访问文件。

模型请求和外部工具还可能访问远端服务。本地保存文件与内容是否发送给模型是两件事，具体见[数据与凭据](/docs/data-privacy)。

## 按工作需要增加能力

| 遇到的需要 | 使用什么 | 原因 |
| --- | --- | --- |
| 一位成员完成一次整理 | 普通会话 | 请求与文件已经足以说明工作 |
| 多位长期成员分工复核 | Room | 共同讨论、交接和汇总 |
| 持续推进到明确终点 | Goal | 单独保存目标和完成标准 |
| 记录负责人、依赖和验收 | 工作图 | 让任务关系可以检查 |
| 反复采用一套工作方法 | Skill 或已有工作循环 | 复用方法与结束条件 |
| 按固定时间执行 | 定时任务 | 单独安排触发时间 |
| 读取外部系统或调用其操作 | Connector / MCP | 提供外部工具入口 |

这些功能可以组合，但不必一次配齐。先让普通会话完成一项工作，再把已经稳定的方法保存为技能，或将需要重复执行的任务交给调度。

## Room、工作图与运行图

Room 提供多人共同交流的空间。公开消息用于目标与交接，Thread 展示某条回复的详细过程。提及成员可以唤醒工作，任务负责人和验收关系则需要写入工作图。

![目标、责任与执行事实的三种视角](/images/docs/work-layers.svg)

工作图记录计划中的责任与交付，运行图展示实际发生的工具调用、子任务和等待。一个任务可以包含多次工具调用，某次调用失败后也可能恢复。判断进展时，既看任务状态，也看产物与验证结果。

从[创建 Agent](/docs/agents)开始配置成员，需要多人配合时阅读[Room 协作](/docs/rooms)，需要明确依赖时阅读[工作图](/docs/workgraphs)。