---
title: 配置模型与凭据
description: 连接模型服务，验证真正完成一次模型调用。
lastVerified: 2026-09-23
---

# 1.3 配置模型与凭据

开始前，准备你有权使用的模型 API 密钥，并完成[本机启动](https://docs.teloa.ai/markdown/start/quickstart.md)。所有发行形态都由用户自行承担模型调用费用。

## 1. 打开模型配置

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

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

[![模型设置中的 DeepSeek 提供方与空白 API 密钥输入框](https://docs.teloa.ai/assets/screenshots/model-settings.png)](https://docs.teloa.ai/assets/screenshots/model-settings.png)

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

## 2. 验证一次回应

新建通用对话，输入：

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

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

## 3. 检查同事使用的配置

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

## 常见问题

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

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

外部模型会接收任务所需的授权上下文。关于数据位置，见[隐私与权限](https://docs.teloa.ai/markdown/deploy/privacy.md)。