部署 AI 咨询聊天示例

开启 Webspace 的 AI 回复 功能，并通过部署时生成的 chat.html 确认咨询流程。这种配置不会为每个 Webspace 创建新模型或 Agent，而是使用管理员已经设置好的模型和 Agent 执行流水线。

开始之前

所需权限：能够部署架构和 API 的用户
服务器管理员必须先连接 AI 提供方，并注册、启用要使用的聊天模型。
确定要授予 AI 回复 的 使用 权限的成员、等级、团队或管理员条件。
使用 chat.html 的成员必须能够登录同一个 SetFN 站点。
检查用于咨询的数据的公开范围和系统指令。

准备管理员 AI 模型

在管理员设置中连接 AI 提供方，并注册、启用用于咨询的聊天模型。如果将 Webspace 的 主要模型 和 备用模型 留空，服务器会优先自动选择已就绪的活跃聊天模型。对于包含图片的请求，还会参考管理员设置的 OCR/VL 模型优先级。

只有在特定 Webspace 需要固定模型时，才在 高级设置 中指定 主要模型 和 备用模型。不要在 Webspace 界面或 chat.html 中放入提供方密钥和模型密钥。咨询界面调用已部署的 AI 功能连接，模型选择和 Agent 执行则遵循现有的服务器流水线。

配置 AI 回复高级设置

在架构的 API 构建 中开启 AI 回复，然后打开 高级设置。

开启 AI 回复 功能。
如果无需指定特定模型，将 主要模型 和 备用模型 留空。
如果需要工具，开启 使用工具。默认为关闭。
在系统指令中输入咨询范围和回答原则。
设置 使用 权限。
开启 生成咨询聊天示例。

最后一项会以如下结构保存到架构文件中。

{
  "apiBuild": {
    "features": {
      "ai-chat": {
        "enabled": true,
        "sampleChat": true
      }
    }
  }
}

sampleChat 只决定是否生成示例界面，不会复制或覆盖现有的管理员模型和 Agent 设置。

自动生成 chat.html

当 AI 回复 的 enabled 和 sampleChat 都为 true，且部署中包含前端示例时，会生成 chat.html。指定客户端部署路径并部署架构。chat.html 会与 index.html、test.html 一起保存在当前的前端示例生成文件夹中，不会另外创建 AI 咨询专用文件夹。

咨询服务/
├── index.html
├── test.html
├── chat.html
├── style.css
└── README.md

以成员身份登录同一个 SetFN 站点后，打开 chat.html 并确认以下各项。示例会使用当前登录会话初始化成员信息，因此不能假定它会作为匿名公开聊天运行。

确认没有 AI 回复 的 使用 权限的成员无法发送请求。
使用有权限的账户发送消息。
确认回答通过现有的管理员模型或 Agent 流水线到达。
如果开启了 使用工具，确认工具只在允许的范围内执行。
确认连接断开时会显示错误状态，并且不会产生重复消息。

完善咨询界面

自动生成的 chat.html 是用于确认连接和权限的起点。可以根据服务目的修改引导文字、推荐问题和界面样式。不要随意将连接地址、认证处理和由服务器管理的模型选择逻辑改为客户端设置。

为了避免 AI 对未经确认的内容妄下结论，请在系统指令中写明咨询范围以及处理未知问题的方式。正式运营前，使用各权限等级的真实账户确认提问、工具调用和错误响应。

注意事项

chat.html 是示例客户端，不会创建单独的 AI 模型或 Agent。
将 主要模型 和 备用模型 留空时，服务器会根据管理员设置和可用模型状态自动选择模型。
仅凭示例生成和 Agent 协议连接，并不能保证实际 AI 提供方的回答。正式运营前，请通过服务器上设置的提供方、模型或 Agent 发送真实消息并确认响应。
示例使用现有的 AI Agent 协议，会显示工具执行状态、等待批准和等待补充输入的提示，但不提供完成批准或补充输入的 UI 本身。
使用工具 默认关闭。开启工具前，确认是否有单独的 UI 来处理该 Agent 所要求的批准或补充输入。
示例需要成员登录和会话初始化，不保证可匿名公开使用。
工具使用权限与 AI 回复 的 使用 权限要分开检查。
另行提供提示，避免在咨询输入中填写个人信息或密钥。
修改示例后重新部署时，确认文件覆盖的范围。