在客户端准备模型与 Agent
下载并安装 Lumoswitch，登录后选择模型连接与 Agent，再预览并确认安装和配置。
下载并安装客户端
下载适合当前电脑的 Lumoswitch 客户端并完成安装，打开后使用 Lumoswitch 账户登录。
选择模型连接
在客户端添加或选择模型连接，再选择你希望用于工作区的模型。可用模型与连接选项以客户端当前展示为准。
确认 Agent 安装与配置
选择需要的 Agent，预览客户端提出的安装与配置变更；确认后由客户端完成安装和配置。Skills 可按需添加。
手动 API 接入（高级）
已有应用或需要直接配置 API 的工作流，可参考以下接入步骤。
登录控制台
使用已有账号登录路墨（Lumoswitch）控制台。首次使用时，先完成账号验证；登录后再创建或维护你的模型与调用配置。
接入或选择候选模型
在控制台接入已有的上游模型凭据，或选择当前部署中已可用的模型资源。随后创建一个模型配置，选择候选模型和需要的调度方式，并定义客户端使用的下游模型 ID。
创建配置并保存 Access Key
提交模型配置后，控制台会生成与该配置关联的 Access Key。完整 Key 仅在创建时展示一次，请立即复制并保存在适合你团队的密钥管理位置。
复制 Base URL 与下游模型 ID
从配置或客户端接入页面复制 Lumoswitch 推理 Base URL，并使用该配置定义的下游模型 ID。不要把上游服务商的凭据直接放进客户端；客户端应使用这组配置关联的调用信息。
发送一个最小请求验证
先用最小请求验证鉴权、模型 ID 和返回格式，再接入正式应用。若调用失败，依次检查配置是否启用、模型是否可调用、Key 是否保存正确，以及账户和运行状态是否满足当前调用条件。
最小验证示例
先确认一条请求能够完整返回
下例假设控制台展示的 Base URL 已包含对应 API 版本路径。请替换环境变量，实际路径、接口能力和模型 ID 以当前控制台与文档为准。
curl "$LUMOSWITCH_BASE_URL/chat/completions" \
-H "Authorization: Bearer $LUMOSWITCH_ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_DOWNSTREAM_MODEL_ID",
"messages": [{ "role": "user", "content": "你好" }]
}'上线前检查
- 完整 Access Key 只在创建时展示一次；确认已保存且未写入前端代码或公开仓库。
- 客户端填写的是配置的下游模型 ID，不是任意上游模型名称。
- 先验证一个最小请求，再结合当前配置、模型状态与账务条件接入正式流量。