模型与 Provider
理解模型来源，连接托管、BYOK 或本地运行环境并安全测试。
大多数 AI 任务需要一个可用的模型来源。Raydo 可以使用托管 Provider、你自己的 API 凭据（BYOK），或设备上的本地运行环境。
密钥只填在专用设置中
不要把 API Key、访问令牌或登录凭据粘贴进 Chat、项目说明、提示词、日志或问题反馈。
先理解四个概念
| 名称 | 用途 |
|---|---|
| 模型 | 实际处理文本、图像、音频或视频任务的 AI 能力 |
| Provider | 提供模型访问的服务或本地运行环境 |
| App Connection | Raydo 与外部应用或服务建立的授权连接 |
| MCP | 向 Agent 提供工具或上下文的协议与服务 |
配置模型不等于已经连接外部应用；连接外部应用也不代表模型可以访问设备上的所有内容。
入口
在完整工作台中打开「系统底座 → 模型」，或从用户菜单进入「设置 → Agents」查看与 Agent 相关的模型配置。具体入口会随版本和配置类型略有不同。
操作步骤
选择 Raydo 当前提供的托管选项，按界面提示完成登录或启用。可用范围以客户端实际显示为准。
选择对应 Provider，在专用密钥输入框中填写凭据并保存。只授予当前任务需要的范围，并定期轮换凭据。
先在设备上启动兼容的本地运行环境，再填写它的本地地址或按界面完成检测。不要把只监听本机的服务暴露到公网。
保存后，运行一个不包含私有文件的最小测试，例如让 Chat 回复“连接正常”。测试成功后再用于真实项目。
成功标志
- 模型列表中能看到并选择目标模型；
- 最小测试能得到回复；
- 界面没有持续显示认证失败、余额不足或本地服务不可达；
- 不需要在对话里重复提供密钥。
常见问题
详细操作：连接 AI Provider。