发现、安装和配置 Agent
Lumoswitch 可以管理部分 Agent 的安装和模型设置。具体操作取决于 Agent 类型和安装方式。目录中出现某个 Agent，不代表 Lumoswitch 能安装它或写入它的配置。
界面示例使用演示数据，版本号、连接和余额仅作展示；请以你安装的客户端为准。
打开 Agent 页面
- 在 Lumoswitch 中打开 Agent。
- 在 已安装 列表中查看本机检测到的 Agent。
- 在 可安装 中浏览目录，并查看每个项目提供的操作。有些 Agent 可由 Lumoswitch 安装；其他项目会打开官方下载页、显示包管理器命令或链接到官方指南。若有安装预览，确认前先检查步骤。
- 如果你从官方来源自行安装了某个 Agent，但列表中没有显示，返回 已安装 并刷新或重新扫描。
- 操作前查看该 Agent 当前提供的操作和配置状态。
检测与安装是两件事。有些应用可以被发现，但 Lumoswitch 不支持安装或配置；有些应用只能通过其官方设置界面配置。已检测到的应用也可能不支持某种模型配置。请遵循对应 Agent 页面显示的说明，不要假定目录里的每个项目都支持托管安装或原生配置。
连接模型
- 打开 Agent → 已安装，选择要配置的 Agent。
- 选择模型设置操作，并选择可用的模型连接。如果还没有连接，先到模型中创建。
- 检查配置预览、受影响的设置和重启说明。
- 应用前，如需保留可恢复副本，请手动备份重要设置。Lumoswitch 不会自动备份所有原生配置文件。
- 仅在预览符合预期时确认。如果页面提供 应用并重新打开，它会在保存配置后重启所选 Agent；请先结束正在进行的工作。
- 正常打开 Agent，发送一个小请求进行验证。
原生模型配置通常会保留无关设置，但不同 Agent 的支持方式有所不同，文件格式也可能被重新排版。受支持的 Agent 可通过 配置备份 手动备份。恢复或重置前，先核对页面列出的文件路径。
备份与重置风险
对于受支持的 Agent，配置备份可以创建手动的完整文件备份。恢复会替换列出的整个文件，可能移除备份之后所做的更改。重置会删除所有列出的配置文件，包括其中保存的 MCP、权限等其他偏好设置。重启 Agent 后，它会重新生成初始配置。恢复和重置都不会自动再创建一份备份；未列出的其他文件不在操作范围内。
如果之后可能需要当前设置，请先创建并确认手动备份。仔细阅读受影响路径和确认说明；不确定将替换哪些内容时不要继续。
验证配置
当所选 Agent 能正常打开、显示或使用预期模型连接，并返回一条小请求的结果时，配置才算验证完成。如果 Agent 提示配置不受支持或仍需设置，请按页面说明使用官方配置方式，不要反复应用相同更改。
找不到或无法配置 Agent
- 刷新 已安装 列表，并确认应用或 CLI 已为当前用户安装。
- 如果列表检测到了应用，但没有受管配置操作，请使用该 Agent 的官方设置或文档。检测到应用不代表支持写入配置。
- 如果应用内无法安装，请从官方来源安装，再重新扫描。
- 如果预览提示配置已变化，请重新打开设置流程并检查新预览，不要继续使用旧确认。
- 如果应用更改后 Agent 未加载新设置，请遵循它的重启说明。使用本机网关连接时，Agent 发请求期间要保持 Lumoswitch 运行。