---
title: 0.2.8 新功能上手
description: 从员工 API 的执行边界和自动交付，到员工包资料、市场创建和 Agent 预设的 0.2.8 变化。
lastVerified: 2026-10-23
---

# 1.2 0.2.8 新功能上手

0.2.8 主要补齐三件事：业务系统调用员工时的执行边界与自动交付、员工包资料的完整使用路径，以及市场创建与 Agent 预设的日常入口。已有安装先按[升级与回退](https://docs.teloa.ai/v/0.2.8/markdown/deploy/backup.md)保留原数据和安装身份；不需要重新创建员工或迁移会话。

## 1. 员工 API：按请求指定权限模式和模型

打开 **设置 > 员工对外调用**，创建或编辑集成时仍然先确认员工、业务范围、有效期和 read/execute/cancel 权限。真正发起工作时，`POST /api/v1/works` 和续做请求可以额外携带：

- `permissionMode`：`danger-full-access`、`workspace-write` 或 `read-only`。新工作不传时默认 `danger-full-access`；续做不传时继承上一轮。
- `model`：`{provider, model, reasoningEffort?}`。不传时使用员工配置的默认模型。

权限模式只决定本轮执行边界，不能绕过集成本身的 execute 权限、员工工具授权和工作台审批。选择后仍会校验当前预设和模型目录；不可用时明确失败，不会悄悄换档。

::: warning 默认是最高执行边界
新工作不传 `permissionMode` 时默认 `danger-full-access`。这适合确实需要完整本机执行的任务，不应作为业务系统的常规默认；建议显式传 `workspace-write` 或 `read-only`，并先确认员工工具授权与审批规则。
:::

例如最小化写入范围：

```json
{"employeeId":"<员工 ID>","input":"核对这份订单并给出结论","permissionMode":"workspace-write"}
```

固定成功结果会自动完成同一件事：生成正式成果、完成关联任务、更新工作进展。调用方按 `result` 读取固定正文和校验和；执行成功不等于业务验收。

[员工 API / SDK / MCP 指南](https://docs.teloa.ai/v/0.2.8/markdown/develop/employee-api.md)

## 2. 员工包资料：预览、按岗位检索、批量加入检索

员工包里的资料不再只有文件名：

- 打开员工资料或群来源中的资料条目，可以先读正文和版本，再决定是否引用。
- 在员工单聊中，检索范围跟随该员工的岗位资料范围，不会因为同一台机器上有其他人的资料就扩大。
- 资料库的员工分组新增 **全部加入检索（N）**：一次按员工把其有效资料按来源去重加入本地检索；检索模型未准备时先引导准备，不静默跳过。

已有员工包的更新和卸载仍保留身份、历史、共享资料保护和事务切换；卸载前的影响预览会列出会被清理或保留的内容。

## 3. 市场创建菜单：技能和应用

市场的 **创建** 菜单现在包含：

- 创建 AI 员工
- 创建 AI 团队
- 创建技能
- 创建应用
- 导入模板
- 导入技能

创建技能/应用后仍在原工作台完成编辑和启用；创建入口不自动安装、不扩大权限，也不替代审核。

## 4. Agent 预设：标准内置，PTC 名称更准确

- **Teloa 标准模式** 现在归入 **内置** 预设分组；原有标准模式保留，避免已有会话失效。
- PTC 代码模式分为：
  - **代码模式（保留变量）**：在当前 Agent 的代码运行会话中跨多个 `run_code` 调用保留变量、函数和导入模块；内存不落盘，重启、取消、超时或 Agent 重启后清空。
  - **代码模式（Python）**：使用 Python 执行 `run_code`，沿用当前文件权限与审批规则。

预设决定执行方式，员工工具授权决定能否使用具体工具，两者不能互相替代。见[原生运行能力](https://docs.teloa.ai/v/0.2.8/markdown/guides/native-capabilities.md)与[执行权限](https://docs.teloa.ai/v/0.2.8/markdown/develop/permissions.md)。

## 5. 设置与侧栏

设置页的分类现在有分隔线和层级，日常偏好、模型与服务、能力与连接、工作方式、高级分组更易扫读。非中文界面的侧栏品牌不再与新建/搜索按钮重叠；窗口变窄时以实际布局为准。

## 6. 安全基线

本版容器运行时和文档安装基线为 **Node.js 24.22.1**。升级已有安装前仍应先备份；原生安装的 Node 要求与 Docker 镜像内运行时分别核对，见[安装与运行](https://docs.teloa.ai/v/0.2.8/markdown/start/quickstart.md)。

## 下一步

- 第一次安装：完成[安装与运行](https://docs.teloa.ai/v/0.2.8/markdown/start/quickstart.md)，再配置[模型](https://docs.teloa.ai/v/0.2.8/markdown/start/models.md)。
- 第一次让员工工作：[首项任务](https://docs.teloa.ai/v/0.2.8/markdown/start/first-task.md)和[首支团队](https://docs.teloa.ai/v/0.2.8/markdown/start/first-team.md)。
- 需要业务系统接入：[员工 API / SDK / MCP](https://docs.teloa.ai/v/0.2.8/markdown/develop/employee-api.md)。

界面细节以实际安装版本为准；本文中的入口对应 0.2.8。