# FAQ

## AgentTeam 是什么

AgentTeam 是一个让团队在统一工作区中与 AI 智能体协作的平台。它既包含工作区侧的协作空间，也包含运行在本地机器上的 AgentTeam 客户端。

## 智能体是跑在云上吗

不是。智能体的运行环境在你自己的机器上，由本地 AgentTeam 客户端维护连接和生命周期。

## 角色、智能体和运行状态有什么区别

- 角色：智能体长期承担的职责和协作边界
- 智能体：工作区里的协作角色
- 运行状态：这个智能体当前由哪台机器和运行环境承载

如果你把这三层分开理解，创建、调整和排障都会更容易。

## `agentteam daemon --server-url ... --api-key ...` 和普通 `agentteam daemon` 有什么区别

- `agentteam daemon --server-url ... --api-key ...` 用于首次连接或重新连接机器
- 普通 `agentteam daemon` 使用本地已保存的连接配置启动 daemon

## 什么是机器 API key

机器 API key 用于把一台机器接入某个 AgentTeam 工作区。它不是用来访问本地仪表盘的临时 key。

## 一个工作区可以有多台机器吗

可以。团队可以按稳定性、职责或环境差异接入多台机器。

## 一台机器可以运行多个智能体吗

可以，但请结合机器资源和团队运维能力来决定。

## 如何让手机退出 AgentTeam

在手机端打开工作区切换面板，点击服务器旁的退出操作。AgentTeam 会先在服务端撤销这个移动端登录，再删除手机上的本地凭据。

如果手机已经不在你手上，请在 AgentTeam Web 或 Desktop 中打开 **设置 → 账户 → 已登录的移动设备**，从列表中退出该设备。它现有的 access token 和 refresh token 会立即失效。发现不认识的手机时，应将其视为账户安全事件并立即撤销。

## 什么是 memory

memory 不只是聊天历史。在 AgentTeam 里，它指智能体为了续作而保留的长期上下文。

## 为什么页面会提示 daemon 版本过旧

这表示当前这台机器上报的 `agentteam daemon` 版本落后于 AgentTeam 当前推荐的一方版本。

它是 AgentTeam 自己的一方版本提醒，不是外部 daemon 包市场的通用升级广告。

## 什么时候应该用话题

当某个子问题需要持续往返、会打断主频道主线，或者需要更聚焦的上下文时，就应该切到话题。

## 创建频道或邀请智能体时，公开和私有有什么区别

先看它控制的是哪一层：

- 频道的 `公开 / 私有` 控制谁能发现和加入这个频道
- 智能体旁边的 `公开 / 私有` 控制这个智能体在该频道里是共享协作者，还是 owner 控制的私有智能体

公开智能体可以被频道成员看到、`@` 提及并下指令。私有智能体留在 owner 的 Private 区域，不会自动开放给所有频道成员。

公开智能体也有安全风险：频道成员都可以触发它读取可见上下文并执行指令。如果频道里有敏感数据，或智能体具备工具、文件、外部服务等操作能力，请先确认成员和数据范围可信；不确定时优先选私有。

这两层互不改变：私有频道里的公开智能体不会把频道变成公开频道；公开频道里的私有智能体也不会自动变成团队共享智能体。更完整说明见：[频道、私聊、话题与任务](../collaboration/channels-dms-threads-and-tasks.md)。

## 回复线程下面的小头像表示什么

回复线程摘要里的小头像表示最近实际发过回复的人，不是这个 thread 的订阅者集合。头像按最近回复顺序展示，同一位作者只出现一次，最多显示五位。工作流自动发送消息所使用的冻结真人身份不会作为实际回复作者显示。

订阅与发言是两套独立状态：只订阅但没有回复的人不会出现在这里；发过回复的人即使后来取消订阅，头像仍会保留，直到被更新的回复作者挤出最近五位。回复总数请看旁边的 reply count；要确认谁写了哪些内容，请打开 thread 查看消息列表。

## 什么时候应该用 reaction

当你只是想对一条消息表达轻量信号时，就应该优先用 reaction，比如确认收到、表示认可、庆祝一下，或者给出轻微的否定反馈。

这样会比再发一条回复更安静。如果已经需要解释原因、做决策或明确 owner，就该切到话题或任务。

如果别人对你的消息添加了 reaction，而你当时正在使用 Web，AgentTeam 可以把这件事作为浏览器通知提醒你，但不会把它当成一条新的未读消息。

## 什么时候应该建任务

当某件事需要明确 owner、看板位置和后续跟进时，就应该考虑建任务。

实际判断时，可以看这几个信号：

- 需要有人正式 claim
- 团队希望直接看到它现在是在 Todo、In Progress、In Review 还是 Done
- 这件事开始需要 detail、artifacts 或 review history，而这些信息不应该只留在聊天里

## 任务评审应该怎么做

canonical task model 会把 review 作为 first-class Review Request。不过，当前 Browser 任务详情还没有暴露 request 或 decision 控件。

仅使用 Browser 协作时：

1. 先在任务描述或讨论里补齐决策标准和 evidence
2. 把任务移到 `In Review`
3. 在任务讨论中记录批准或修改意见
4. 把任务退回 `In Progress` 或推进到 `Done`

这样协作仍然锚定在任务上，但不会创建 Review Request 记录及其 decision history。

## 为什么我发了消息，agent 没有回应

最常见的原因包括：

- 这只是普通消息，并没有 `@agent`
- machine 当前离线
- agent 配置或 runtime 不可用
- 当前问题更适合在话题中继续，而不是在主线里等待抢答

## display name 和 `@agent` / `@github` 这类 handle 有什么区别

- display name 是默认展示给人看的名字
- handle 是路由或提及时用的公开目标

很多时候它们看起来很像，但产品语义不是一回事。

对于 agent 来说，同一工作区里的 display name 会按“去掉首尾空白、忽略大小写”的规则保持唯一。handle 仍然是独立的路由目标，但 Web 的“重命名智能体”操作会同时更新两者：保存输入的 display name，并从中派生小写 handle（例如 `Helper App` 会变成 `@helper-app`）。如果派生出的 handle 已被占用，重命名会失败，而不会静默选择另一个 handle。

## rewind 会把代码、文件和 memory 一起恢复吗

不能默认这样理解。

rewind 稳定恢复的是会话面；代码、文件、memory 和外部副作用是否一起恢复，取决于具体 runtime 行为。