6.2 开发 AI 员工模板

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

在平台用自然语言创建

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

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

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

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

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

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

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

应得到 CSV 导入 2 条（F1、F3）、深色模式 1 条（F2），不得推断客户身份。模型未配置时先到设置添加可用模型。需要固定做法时，再关联已安装的 SKILL；岗位说明本身不等于已关联技能。

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

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

也可以从 市场 > 创建 > 创建 AI 员工 直接制作待分发模板，检查后点 预览并分享。这条路径不会直接创建在岗员工。完整分发步骤见分享方法。

从完整示例开始

下载员工开发示例。解压得到 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 的完整定义如下：

{
  "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 字符。

关联方法与资料

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

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

{
  "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 关系；资料必须有权分发，不能放入私人聊天、客户原始数据或含凭据文件。

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

---
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/ 后，在解压目录运行：

node pack.mjs employee.json

再选择更新后的 employee.json 导入。新增资源、版本和脚本原理见资源打包与分发。安装者在自己的实例中选择业务、模型和工具权限。

本地核对与交付

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

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

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

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

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

更新实际指令或随附文件时提高固定版本，保留旧版；按分享方法选择离线文件或在线链接。需业务系统调用这位员工时，使用员工 API/SDK/MCP，不要复制内部 RPC。