---
title: 配置指南
description: 找到模型、连接、运行环境和员工授权的配置入口，并验证配置结果。
lastVerified: 2026-10-23
---

# 3.16 配置指南

初次使用，先在 **设置 > 模型** 配置模型服务，完成一次普通对话，再为员工添加所需资料、技能和工具。以后只需调整本次工作涉及的配置。

## 1. 找到配置入口

| 要调整什么 | 从哪里进入 | 操作指引 |
| --- | --- | --- |
| 语言、主题、开发者工具 | 设置 > 通用设置 | 修改对应偏好；开发者工具用于文件改动审阅等功能 |
| 模型与 API 密钥 | 设置 > 模型 | [配置模型与密钥](https://docs.teloa.ai/v/0.2.27/markdown/start/models.md) |
| 本地聊天与检索模型 | 设置 > 本地模型 | [模型准备与下载](https://docs.teloa.ai/v/0.2.27/markdown/start/models.md#%E6%9C%AC%E5%9C%B0%E6%A3%80%E7%B4%A2%E6%A8%A1%E5%9E%8B) |
| 员工 API、SDK 与 MCP 接入 | 设置 > 员工对外调用 | [集成凭据与调用示例](https://docs.teloa.ai/v/0.2.27/markdown/develop/employee-api.md) |
| 本机工作目录 | 设置 > 执行位置 | 选择实际工作目录；容器与本机的路径范围见[运行配置与数据位置](https://docs.teloa.ai/v/0.2.27/markdown/deploy/configuration.md) |
| MCP、原生扩展与运行能力 | 设置 > 连接与运行环境 | [使用原生运行能力](https://docs.teloa.ai/v/0.2.27/markdown/guides/native-capabilities.md) |
| 新会话使用的运行模式 | 设置 > Agent 预设 | [选择运行模式与执行方式](https://docs.teloa.ai/v/0.2.27/markdown/guides/native-capabilities.md#%E9%80%89%E6%8B%A9%E8%BF%90%E8%A1%8C%E6%A8%A1%E5%BC%8F%E4%B8%8E%E6%89%A7%E8%A1%8C%E6%96%B9%E5%BC%8F)；已有会话保留原预设 |
| 员工的职责、资料、技能与工具授权 | 员工 > 打开该员工 | [创建和管理 AI 员工](https://docs.teloa.ai/v/0.2.27/markdown/guides/colleagues.md) |
| 应用、技能与连接 | 市场 > 我的应用与技能 | [管理能力与连接](https://docs.teloa.ai/v/0.2.27/markdown/guides/capabilities.md) |
| 自动整理经验与记忆 | 设置 > Auto Dream | [自动整理工作经验](https://docs.teloa.ai/v/0.2.27/markdown/guides/auto-dream.md) |
| 语音识别、播报与通话 | 设置 > 语音服务 | [语音与通话](https://docs.teloa.ai/v/0.2.27/markdown/guides/conversations.md#%E8%AF%AD%E9%9F%B3%E4%B8%8E%E9%80%9A%E8%AF%9D) |
| 产品问题与建议 | 设置 > 关于 > 提交反馈 | 无需创建会话；填写问题或建议，可选填联系邮箱 |

**组件状态** 用于排查加载与运行问题。安装和配置扩展时，优先使用 **连接与运行环境**。

## 2. 保存连接与运行配置

在相应页面填写模型、密钥或连接参数，按页面提供的保存、连接或启用操作完成配置。需要重启时，先等待正在执行的工作结束，再重启 Teloa。

安装、启用和连接成功是不同状态。例如，扩展安装完成后仍可能需要启用组件、填写密钥或准备本机依赖。查看当前对象的实际状态；保存成功不等于已经完成一次调用。

## 3. 为员工指定能力和权限

回到员工档案，核对员工职责、资料范围、技能和可用工具。修改要求暂停的员工配置时，先暂停员工，保存后再恢复在岗。

给员工配置技能是告诉它如何工作；接入 MCP 是提供工具来源；业务授权决定它可以使用哪些工具、操作哪些资源，以及何时需要审批。安装或启用扩展不会自动扩大员工权限。细节见[技能、资料、接入源与授权](https://docs.teloa.ai/v/0.2.27/markdown/concepts/capabilities.md)。

## 4. 用一项小任务验证

先验证普通对话，再让目标员工执行一项范围明确的小任务。例如：读取指定资料，整理三条要点并说明来源。查看任务记录中的工具结果、需要你处理的事项和最终交付。

若普通对话成功而员工任务失败，检查该员工的模型、运行预设、工具授权及错误记录。连接失败时先核对服务地址、密钥，以及运行 Teloa 的设备的网络。进一步排查见[常见问题](https://docs.teloa.ai/v/0.2.27/markdown/deploy/troubleshooting.md)。

业务与员工配置由 Teloa 管理；模型、原生工具和运行环境通过智能体引擎的配置服务保存。日常使用在产品对应页面完成；开发接入方式见[业务能力与执行引擎边界](https://docs.teloa.ai/v/0.2.27/markdown/develop/engine-integration.md)。