---
title: 开发 AI 员工模板
description: 将职责、方法和范围整理为可预览、可分享的员工定义。
lastVerified: 2026-10-23
---

# 6.2 开发 AI 员工模板

员工模板是一份岗位说明，写清员工做什么、何时接手、何时需要确认，以及怎样交付。按下面的示例修改，就能导入并测试。

## 在平台用自然语言创建 {#create-in-chat}

> 本节示例已用真实 MiniMax 验证；相关修复已包含在 0.2.10 中。截图使用虚构反馈，生成内容以实际模型输出为准。

打开 **员工 > 添加 AI 员工**。输入下面的岗位说明，点 **继续**，到会话中核对并发送：

```text
创建一位“反馈分析员示例”，负责把我提供的编号客户反馈整理成简报。
交付：问题分类及数量、逐项来源、待确认问题；不擅自推断客户身份。
收到反馈和整理目标即可开始；缺少关键资料时列出缺口。
可以自行归类、计数和起草；外发、发布或扩大资料范围前需我确认。
先准备员工配置供我检查，不创建其他员工或自动化。
```

检查职责、资料范围、执行边界和模型选择。满意后在原会话确认应用刚才的草稿：

```text
确认应用刚才的员工草稿，创建“反馈分析员示例”，
使用当前可用的默认模型，不增加外部工具权限。
```

在 **员工** 中查看实际配置和在岗状态，再打开该员工会话试做：

```text
整理这些虚构反馈，给出分类、数量、编号来源和待确认项。
按原反馈编号计数，不自动去重，不自行设定默认规则。
F1 与 F3 是否重复录入只列为待确认，不改变本轮数量。
[F1] 导入 CSV 时提示编码错误。
[F2] 希望支持深色模式。
[F3] 导入 CSV 时提示编码错误。
```

应得到 CSV 导入 2 条（F1、F3）、深色模式 1 条（F2），不得推断客户身份。模型未配置时先到设置添加可用模型。需要固定做法时，再关联已安装的 [SKILL](https://docs.teloa.ai/markdown/develop/skills.md#create-in-chat)；岗位说明本身不等于已关联技能。

在员工档案的更多操作中选 **分享这位员工**，核对模板文件，再导出或发布链接。接收方从 **员工 > 导入模板** 添加副本；副本保持暂停，由接收方核对业务、模型、方法和权限后恢复，再用上述输入试做。分享不包含原员工的会话、记忆、凭据或在途工作。

<figure class="guide-screenshot">

[![自然语言创建的员工分享预览](https://docs.teloa.ai/assets/screenshots/nl-create-employee.jpg)](https://docs.teloa.ai/assets/screenshots/nl-create-employee.jpg)

</figure>

*本地 MiniMax 实测：分享岗位定义，接收方配置并启用自己的员工副本。 点击图片查看原图。*

也可以从 **市场 > 创建 > 创建 AI 员工** 直接制作待分发模板，检查后点 **预览并分享**。这条路径不会直接创建在岗员工。完整分发步骤见[分享方法](https://docs.teloa.ai/markdown/guides/sharing.md)。

## 从完整示例开始

[下载员工开发示例](https://docs.teloa.ai/examples/resource-authoring-024/employee.zip)。解压得到 `employee.json` 分享包及 `sources/` 原文件。示例含一位员工和一个方法，指令使用英文，不连接外部账号。到 **员工** 页右上角 **导入模板**，选择解压后的 `employee.json`，先检查预览；不要把整个 ZIP 当作分享 JSON。

## 编写职责

先写一份具体的岗位说明，再把内容放进支持的字段。以“资料简报员”为例：输入是带编号的用户笔记，输出是三条带来源的发现、一段结论和未核实问题；笔记不足时交回缺口，不自行搜索补成事实。这比“你是一位优秀分析师”更容易测试和维护。

| 字段 | 作者需要作出的决定 | 本例的验收点 |
| --- | --- | --- |
| `name` | 安装者能辨认的岗位名称 | 简报员与复核员能区分 |
| `kind` | 普通员工使用 `employee` | 不把个人分身当作可分发员工 |
| `duty` | 该岗位交付什么结果 | 三条发现、结论、问题 |
| `dataScope` | 可以根据哪些资料作判断 | 仅本任务提供的笔记 |
| `executionScope` | 可以执行哪些动作 | 阅读、比较、起草 |
| `triggers` | 什么输入足以接手 | 收到本人交办和笔记 |
| `autonomousActions` | 在已有授权内自行完成什么 | 计算、比较、整理文字 |
| `confirmationPoints` | 哪些后续动作需要本人决定 | 扩大资料范围、外发或发布 |
| `escalationRules` | 缺信息、冲突或权限时如何处理 | 列出缺口，不编造证据 |
| `deliveryChecks` | 交付前逐项检查什么 | 每条结论有来源，未知项明确 |

`name` 最多 80 字符；`duty`、`dataScope`、`executionScope` 各最多 4,000 字符。结构化职责是 `responsibility` 内的五个字段，不是顶层字段。岗位职责、方法正文和工具授权分别维护：职责说明目标，SKILL 说明做法，接收端授权决定实际能访问什么。不要在多个文件复制整段同义提示词。

示例 `sources/roles/employee-0.json` 的完整定义如下：

```json
{
  "format": "teloa.role/v1",
  "name": "Evidence writer",
  "kind": "employee",
  "duty": "Draft an evidence-based brief from supplied notes, citing sources and retaining unresolved questions.",
  "dataScope": "Only material supplied or already authorized for this task.",
  "executionScope": "Read, compare and draft. Ask before sending or publishing.",
  "responsibility": {
    "triggers": [
      "When assigned numbered source notes and a brief to draft."
    ],
    "autonomousActions": [
      "Compare supplied notes and draft three sourced findings and a short conclusion."
    ],
    "confirmationPoints": [
      "Ask before accessing additional material or distributing the draft."
    ],
    "escalationRules": [
      "Identify unsupported claims and conflicting evidence without inventing a resolution."
    ],
    "deliveryChecks": [
      "Cite a source for each finding and retain unresolved questions."
    ]
  }
}
```

五组 `responsibility` 都用字符串数组。写清接手条件、可自主动作、必要确认、阻塞升级和交付检查。`autonomousActions` 只能描述既有授权内的动作，不创建权限。当前每组最多 30 条，每条最多 1,000 字符。

## 关联方法与资料

```text
employee.json                       # 实际选择导入的分享文件
sources/
  teloa.json                        # 内部资源清单
  roles/employee-0.json              # 一位员工的岗位定义
  skills/evidence-brief/SKILL.md      # 可复用方法
```

内部清单把方法绑定到岗位，完整示例可写成：

```json
{
  "format": "teloa.business-package/v2",
  "id": "example-employee-brief",
  "version": "1.0.1",
  "title": "Evidence brief employee",
  "description": "A local authoring example with no account connection or automatic execution.",
  "domain": "general",
  "scope": "general",
  "resources": [
    {
      "id": "evidence-brief",
      "kind": "skill",
      "title": "evidence-brief",
      "version": "1.0.1",
      "required": true,
      "source": {
        "kind": "local",
        "path": "skills/evidence-brief/SKILL.md"
      }
    },
    {
      "id": "employee-0",
      "kind": "role",
      "title": "employee-0",
      "version": "1.0.1",
      "required": true,
      "source": {
        "kind": "local",
        "path": "roles/employee-0.json"
      }
    }
  ],
  "relations": [
    {
      "kind": "role-skill",
      "from": "employee-0",
      "to": "evidence-brief"
    }
  ],
  "entrypoints": [
    "evidence-brief"
  ]
}
```

`employee-0` 是包内资源引用；安装后的员工实例有自己的身份。`entrypoints` 指向可执行的方法或任务模板，不能填员工资源 ID。增加资料时，声明 `kind: "knowledge"` 的资源，再添加 `role-knowledge` 关系；资料必须有权分发，不能放入私人聊天、客户原始数据或含凭据文件。

方法正文可先保持简短，把“如何工作”写具体：

```md
---
name: evidence-brief
description: Summarize supplied notes with sources and unresolved questions.
---

# Evidence brief

Read only the supplied, numbered notes. Write:
1. Three findings, citing the note ID for each.
2. A short conclusion, distinguishing observations from interpretation.
3. Unresolved questions and any missing evidence.

Do not invent sources. Do not browse, send, publish or modify external systems.
```

## 重新打包并导入

下载包已带 `pack.mjs`。修改 `sources/` 后，在解压目录运行：

```sh
node pack.mjs employee.json
```

再选择更新后的 `employee.json` 导入。新增资源、版本和脚本原理见[资源打包与分发](https://docs.teloa.ai/markdown/develop/packages.md)。安装者在自己的实例中选择业务、模型和工具权限。

## 本地核对与交付

先按[格式校验方法](https://docs.teloa.ai/markdown/develop/packages.md#validate-authoring-examples)检查文件。预览中核对一位员工、正确的方法与来源；明确添加后，再核对默认暂停状态、业务归属和接收端模型。配置必要授权后，用一份虚构资料完成小任务，检查来源与待确认项。解析通过不代表模型质量已通过。

使用以下输入做第一次验收，不需要外部系统：

```text
请按资料简报方法整理，只使用下面的虚构笔记：
[N1] 周一收到 12 条反馈，其中 4 条提及导入失败。
[N2] 周二收到 8 条反馈，其中 2 条提及导入失败。
[N3] 尚未记录反馈来自新用户还是老用户。
交付三条带来源的发现、简短结论和未核实问题。
```

应得到总计 20 条反馈、6 条导入问题及相应来源；不能推断新老用户比例。然后补充“将 N2 的导入失败改为 3 条”续做，检查更新为 7 条；再要求“直接发布到公司群”，确认不会凭模板描述取得外发权限。停止运行后核对实际终态，刷新后核对员工定义和结果仍可读。

| 现象 | 优先检查 |
| --- | --- |
| 预览拒绝职责 | 五组字段均为字符串数组，没有拼错或未知字段 |
| 修改后导入仍是旧内容 | 是否重新生成了外层 `files[].text` |
| 看到员工却没有方法 | `role-skill` 的两端资源 ID 和类型是否正确 |
| 启用后模型报错 | 接收端模型提供商、默认选择和凭据；模板不提供密钥 |
| 有工具名称却不能调用 | 连接准备状态、员工授权与本轮审批；声明不授予权限 |
| 想加入 AI Worker 标准中的更多属性 | 先核对当前读取器；未支持的合同信息放在随附说明中，不发明 JSON 字段 |

更新实际指令或随附文件时提高固定版本，保留旧版；按[分享方法](https://docs.teloa.ai/markdown/guides/sharing.md)选择离线文件或在线链接。需业务系统调用这位员工时，使用[员工 API/SDK/MCP](https://docs.teloa.ai/markdown/develop/employee-api.md)，不要复制内部 RPC。