# 智能体

智能体是从远程 AgentTeam 服务器同步到本地的工作配置。每个智能体包含运行时、模型设置、可选执行策略、标签、来源频道和物化到 Cloud Memory 的身份文档。

## 智能体字段

| 字段 | 含义 |
|------|------|
| `id` | 从 AgentTeam 同步的稳定智能体标识 |
| `name` | 人类可读显示名称 |
| `runtime` | 运行时名称，例如 `opencode`、`claude`、`codex` 或 `kimi` |
| `description` | 可选说明 |
| `labels` | 桌面端中展示的自由标签 |
| `model` | 主模型覆盖 |
| `small_model` | 轻量任务使用的小模型 |
| `reasoning_effort` | 运行时特定的推理深度 |
| `policy` | 可选最大并发会话数、超时和允许路径 |
| `source` | AgentTeam 来源频道；存在频道标识时格式为 `agentteam:<channel-id>` |

同步智能体会显示来源频道，并在桌面端中按远端拥有的数据处理。

AgentTeam 的 `codex` 运行时需要使用 `codex app-server` 子命令入口；`kimi` 运行时需要提供公开的 Agent Client Protocol 入口（`kimi acp`）。

## 桌面端工作流

智能体页面可以：

- 按名称、标签或状态排序
- 打开运行时管理器
- 查看远端拥有的智能体详情
- 查看运行中智能体的最近活动
- 编辑当前生效的身份文档

## 身份文档

每个智能体都有一份常驻身份文档，统一位于 Cloud Memory：

```text
~/.agentteam/agents/<agent-id>/memory/system/identity.md
```

桌面端接口当前仍只暴露 `role` 这一种文档类型；读取和写入都使用这份唯一权威文档：

```text
GET /api/internal/agents/:id/docs/role
PUT /api/internal/agents/:id/docs/role
```

当前生效的身份文档限制为去除首尾空白后不超过 4096 个 Unicode 字符，并且还有字节大小保护。超限写入会在进入提示词编译之前被拒绝。

## 远端拥有

智能体从远程 AgentTeam 服务器同步到本地。请在对应的 AgentTeam 服务器中创建、更新或删除智能体；本地命令行只提供查看能力。

## 命令行

```bash
agentteam agent list
agentteam agent list -f json
agentteam agent get <id>
```

`agent list` 和 `agent get` 支持 `--format/-f table|json|jsonc|yaml|toml`。`agent list` 表格输出包含 `ID`、`NAME`、`STATUS`、`RUNTIME`、`MODEL` 和 `SOURCE`；结构化格式通过 `status` 暴露同一份实时或注册状态。daemon 运行时，`status` 来自本机 session 快照；daemon 未运行时，则回退为注册状态。