Agents
了解 EthanKit 里的 agent、Agent Builder、能力块、运行页、历史会话、飞书绑定和只读访问模式。
Agent 是什么
在 EthanKit 里，一个 agent 是一组可保存的运行配置。它通常包含：
- 一个主模型。
- 系统提示词。
- 可选的 fallback models。
- 可选的长期记忆。
- 可选的平台内置工具。
- 可选的 MCP 工具。
- 可选的浏览器子 agent。
管理员负责创建和维护 agent。viewer 可以浏览已保存的 agent，但不能修改配置。
Agent 列表
Agents 列表展示每个 agent 的名称、描述、主模型和已启用能力块。Admin 可以从卡片上直接执行：
- Run：进入运行页。
- History：查看会话历史。
- Edit：回到 Agent Builder。
- Delete：删除 agent。
- Feishu binding：管理飞书群入口。
Viewer 只能查看 agent 卡片和部分绑定摘要，不会看到写入按钮。
Agent Builder
Agent Builder 是配置 agent 的画布。中心的 Session / Loop 决定主模型、系统提示词、最大输出 token 和描述；周围的能力块决定这个 agent 能使用哪些外部能力。
创建 agent 前，至少需要一个已登记的 chat model。没有模型时，builder 的模型选择器会为空，agent 不能正常保存或运行。
能力块
Agent Builder 使用能力块来组装运行环境。
| 能力块 | 作用 |
|---|---|
| Session | 保存当前 agent 的对话和运行上下文。 |
| Memory | 从长期记忆中召回相关内容，并在运行后沉淀新记忆。 |
| Tools | 显式挂载平台内置工具或 MCP 外部工具。 |
| Sub-agents | 把浏览器等重型任务委托给专门的子 agent。 |
Memory 只能添加一次。Tools 和 Sub-agents 可以按需要挂载多个。内置工具也必须先挂载并保存，未绑定工具不会进入 agent 的运行环境。素材库页会展示当前可用能力块，详见 素材库。
运行 agent
Admin 点击 Run 后会进入全屏运行页。页面分为两栏：
- Chat output：用户输入、agent 回复和流式输出。
- Trace：模型步骤、工具调用、MCP 调用、记忆读写和错误。
输入任务后，可以等待结果流式返回。运行完成后，可以开启 New chat 创建新会话，或从历史页回到旧 session 继续对话。
如果 agent 绑定了本地 Browser Use 运行时，浏览器子 agent 遇到登录、MFA、验证码或需要人工确认的步骤时，运行页会进入“等待你操作”。对应的 ethankit-browser 会在已注册机器上用当前页面和专用 profile 打开可见窗口；完成操作并关闭窗口后，浏览器子 agent 和主 agent 会依次继续原任务。
会话和历史
每个 agent 可以有多个 session。一个 session 会保留历史消息、运行记录和活跃 run 状态。
在 agent 历史页里，你可以查看过往会话、继续已有会话，或从页面顶部进入 Run、Edit、Eval。每条历史记录会显示标题、消息数、运行数和最近活动时间。
运行 trace
Trace 用来解释一次 agent run 做了什么。常见步骤包括：
- Reasoning：模型输出或中间思考事件。
- Tool：内置工具调用。
- MCP：外部 MCP 工具调用。
- Memory：记忆召回或写入。
- Error：运行中出现的错误。
当结果不符合预期时，先看 trace。它通常能指出是模型选择、工具配置、MCP 连接、权限还是输入本身出了问题。
飞书绑定
Admin 可以从 agent 卡片打开 Feishu binding。一个 agent 可以绑定飞书应用，让群消息触发该 agent。绑定和回复策略见 飞书群绑定。
Viewer 只能看到是否存在绑定以及 active 数量摘要。
和其他页面的关系
- 模型配置：决定 builder 里有哪些模型可选。
- MCP 与子 agent：决定 builder 里有哪些工具和浏览器委托能力。
- 记忆与知识库：决定 Memory workspace 和长期上下文。
- 运行与评测：把完成的 run 送审，经可信标签发布为回归数据集。
- Dashboard 与看板：查看总体运行量和当前 running 任务。
只读模式
Viewer 可以查看 agent 卡片、模型名称、能力块和部分绑定摘要。涉及密钥、写入、连接测试、运行任务、删除配置的操作都需要管理员权限。