模型配置

为什么必须先配置模型

EthanKit 不假设每个 agent 都有默认模型。每个 agent 必须选择一个管理员登记过的模型配置，否则运行时会提示模型未配置。

模型配置页面分为两个区域：

• Chat models：给 agent loop、sub-agent lab 和 judge model 使用。
• Embedding：给语义记忆 workspace 使用。

支持的协议

Chat model 配置支持两类协议：

• OpenAI-compatible：适合兼容 OpenAI Chat Completions 或类似接口的供应商。
• Anthropic：适合 Anthropic 协议的模型供应商。

创建配置时需要填写：

字段	说明
Name	控制台里显示的名称。
Model ID	实际传给供应商的模型标识。
Context window	该模型可处理的上下文窗口大小。
Base URL	供应商 API 地址。
API Key	供应商密钥。
Vision	该模型是否支持图片输入。

保存后的模型会出现在 Agent Builder 的模型选择器里。Sub-agent Labs 也会从这里读取可选模型。

密钥如何展示

API Key 和 Base URL 会加密保存。保存后，页面只展示脱敏后的 hint。编辑配置时，如果不填写新的 API Key，会保留原来的密钥。

Fallback models

Agent 可以配置 fallback models。主模型失败时，agent loop 可以尝试备用模型。备用模型也必须来自已经保存的模型配置。

Embedding models

如果要使用语义记忆，需要另外配置 embedding model。Embedding 配置用于把内容写入向量记忆和召回相关片段。

Embedding model 使用 OpenAI-compatible embeddings 接口。创建时需要填写：

字段	说明
Name	控制台展示名。
Model	实际 embedding model 标识。
Dimensions	向量维度。
Base URL	embeddings API 地址。
API Key	供应商密钥。

如果 workspace 使用 pgvector 后端但没有选择 embedding model，召回会退回到更基础的检索方式。详见 记忆与知识库。

连接测试

管理员保存 chat model 或 embedding model 后，建议立即点击 Test。连接测试可以提前发现这些问题：

• Base URL 不可访问。
• API Key 无效。
• 模型 ID 写错。
• 协议类型和供应商不匹配。
• embedding 维度和实际返回不一致。

Viewer 能看到什么

Viewer 可以看到模型名称、协议、模型 ID、上下文窗口、vision 标记、embedding 维度和脱敏 hint，但不能新增、编辑、删除或测试连接。