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

# 3.14 配置指南

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

## 1. 找到配置入口

| 要调整什么 | 从哪里进入 | 操作指引 |
| --- | --- | --- |
| 语言、主题、开发者工具 | 设置 → 通用 | 修改对应偏好；开发者工具用于文件改动审阅等功能 |
| 模型与 API 密钥 | 设置 → 模型 | [配置模型与凭据](https://docs.teloa.ai/markdown/start/models.md) |
| 本机工作目录 | 设置 → 执行位置 | 选择实际工作目录；容器与本机的路径范围见[运行配置与数据位置](https://docs.teloa.ai/markdown/deploy/configuration.md) |
| MCP、原生插件与运行能力 | 设置 → 连接与运行环境 | [使用原生运行能力](https://docs.teloa.ai/markdown/guides/native-capabilities.md) |
| 新会话使用的运行模式 | 设置 → Agent 预设 | [选择运行模式与执行方式](https://docs.teloa.ai/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/markdown/guides/colleagues.md) |
| 技能、接入源与扩展清单 | 能力 | [管理能力与连接](https://docs.teloa.ai/markdown/guides/capabilities.md) |
| 自动整理经验与记忆 | 设置 → Auto Dream | [自动整理工作经验](https://docs.teloa.ai/markdown/guides/auto-dream.md) |

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

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

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

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

## 3. 为同事指定能力和权限

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

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

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

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

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

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