1.3 配置模型与凭据

开始前，准备你有权使用的模型 API 密钥，并完成本机启动。所有发行形态都由用户自行承担模型调用费用。

1. 打开模型配置

进入 设置 → 模型，找到对应的模型提供方。Teloa 管理业务和同事关系，底层 DSH 配置页管理模型、凭据和运行环境。

在对应模型服务商的凭据入口保存密钥，再检查模型提供方、模型名称和运行配置是否匹配。不要将密钥写进同事职责、群消息、技能正文或普通资料。

模型配置界面，尚未填写凭据。填入你自己的密钥并保存；截图中的空白状态不代表模型已连接。

2. 验证一次回应

新建通用对话，输入：

请只回复“模型连接正常”。不使用工具，不访问资料。

收到回应后，再测试同事任务。页面能够打开、凭据已保存和模型能够执行任务，是三个不同的验证结果。

3. 检查同事使用的配置

若普通对话可用但同事任务失败，检查该同事的运行配置及错误提示。修改岗位定义或工具授权前，先暂停同事；保存后恢复在岗，再用一项小任务验证。

常见问题

现象	处理方式
认证失败	在凭据来源检查密钥是否有效、是否属于当前服务商；重新保存后重试
模型不存在或不支持	使用该提供方实际开放的模型标识；检查运行配置是否仍引用旧模型
额度不足或限流	到模型服务商确认额度和调用限制；Teloa 许可不会自动补充 Token
网络失败	从运行 Teloa 的设备检查模型服务连接；浏览器联网不等于宿主能连接
对话成功，工具任务失败	检查模型工具调用能力、同事授权与具体执行记录

默认组合面向 DeepSeek 服务。其他模型及内网模型应按当前 Harness 实际支持情况配置并单独验证；本指南不承诺任意兼容地址都能无改动工作。

外部模型会接收任务所需的授权上下文。关于数据位置，见隐私与权限。