常见问题

EthanKit 用户在权限、模型配置、MCP、记忆和运行失败上最常遇到的问题。

为什么我只能查看,不能运行或编辑?

你当前不是管理员。EthanKit 是单管理员控制台:只有管理员可以创建、编辑、运行 agent,保存模型和 MCP 配置,或执行评测。其他登录用户和匿名访问者是只读 viewer。

更完整的权限列表见 权限与角色

为什么新建 agent 时没有模型可选?

还没有保存可用的 BYOK 模型。先进入 模型配置,添加并测试至少一个模型。

API Key 会不会显示给 viewer?

不会。模型、embedding、MCP、GitHub PAT、Vercel PAT 和飞书密钥等凭证保存后只展示脱敏提示。viewer 只能看到被允许公开的摘要。

Dashboard 和看板为什么 viewer 也能看?

这两个页面用于展示运行摘要。Viewer 可以看用量、模型名称和 running task 摘要,但不能展开敏感执行详情,也不能发起或停止任务。

为什么 MCP 工具没有出现在 agent 里?

通常有三个原因:

  • MCP 配置没有启用。
  • MCP 连接测试失败。
  • Agent Builder 里没有把该 MCP server 挂到当前 agent。
  • 你配置的是 Vercel PAT,它主要用于 workflow source,不会作为普通 agent MCP 展示。

素材库为什么没有我要的工具?

素材库固定展示平台内置工具,并展示 Agent Builder 可用的 MCP 能力块。外部工具缺失时,确认 MCP server 已启用;GitHub PAT 会生成 MCP 能力块,Vercel PAT 不会。看到工具不等于 agent 已获授权,还需要在 Agent Builder 中挂载并保存。更多说明见 素材库

为什么浏览器子 agent 不可用?

浏览器子 agent 依赖后端浏览器服务和对应的 MCP server。管理员需要先在 MCP 配置里确认浏览器服务可连接,再在 Agent Builder 里启用 Browser Use 或 Agent Browser。

如果只是想单独测试浏览器后端,使用 Sub-agent Labs

为什么飞书群里没有回复?

先确认绑定状态是 ACTIVE,飞书应用权限已经发布,机器人在目标群里,并且当前 Reply policy 是否要求 @ 机器人。完整步骤见 飞书群绑定

为什么 agent 记不住之前的内容?

检查当前 agent 是否启用了 Memory、是否选择了正确的 workspace,以及 workspace 是否配置了可用的 embedding model。

如果内容只出现在一次普通对话里,但没有被写入长期记忆,下次 session 不一定会召回它。

Knowledge 和 Memory 有什么区别?

Memory 是 agent 在运行中沉淀的长期事实;Knowledge 是管理员从受控网页来源构建并审核的知识材料。前者按 workspace 隔离,后者按 brand、snapshot、document、chunk 和术语候选组织。

工作流和定时任务有什么区别?

Workflow Definition 描述“怎么做”,Scheduled Task 描述“什么时候运行”。一个定时任务可以运行 workflow、agent prompt,或为固定 revision 的 eval experiment 排队创建 attempt。详见 工作流与定时任务