> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# agents

# `agdi agents`

管理隔离的智能体（工作区 + 认证 + 路由）。

相关内容：

* 多智能体路由：[多智能体路由](https://agdiai-597e782f.mintlify.site/concepts/multi-agent.md)
* 智能体工作区：[智能体工作区](https://agdiai-597e782f.mintlify.site/concepts/agent-workspace.md)

## 示例

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi agents list
agdi agents add work --workspace ~/.agdi/workspace-work
agdi agents set-identity --workspace ~/.agdi/workspace --from-identity
agdi agents set-identity --agent main --avatar avatars/agdi.png
agdi agents delete work
```

## 身份文件

每个智能体工作区可以在工作区根目录包含一个 `IDENTITY.md`：

* 示例路径：`~/.agdi/workspace/IDENTITY.md`
* `set-identity --from-identity` 从工作区根目录读取（或从显式指定的 `--identity-file` 读取）

头像路径相对于工作区根目录解析。

## 设置身份

`set-identity` 将字段写入 `agents.list[].identity`：

* `name`
* `theme`
* `emoji`
* `avatar`（工作区相对路径、http(s) URL 或 data URI）

从 `IDENTITY.md` 加载：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi agents set-identity --workspace ~/.agdi/workspace --from-identity
```

显式覆盖字段：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi agents set-identity --agent main --name "Agdi" --emoji "🦞" --avatar avatars/agdi.png
```

配置示例：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "Agdi",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/agdi.png",
        },
      },
    ],
  },
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.