---
title: 制作业务资源包
description: 将岗位、技能、资料和模板打包为可导入内容。
lastVerified: 2026-10-01
---

# 6.4 制作业务资源包

业务资源清单继续支持 `teloa.business-package/v2`；`v3` 增加固定模型依赖，`v4` 增加完整业务配置资源。先从[通用研究示例包](https://docs.teloa.ai/v/0.2.0/examples/general-research.zip)学习 v2 的完整结构，再减少到自己的必要资源。

## 业务资源包与引擎 Bundle

业务资源包分发岗位定义、方法、资料、模板及其关联；引擎 Bundle 组合运行插件和配置。导入前者不等于安装任意引擎代码，也不授予员工全部工具权限。扩展依赖仍分别经过安装、配置和授权检查。详见[执行引擎接入边界](https://docs.teloa.ai/v/0.2.0/markdown/develop/engine-integration.md)。

## 包结构

```text
research/
  teloa.json
  skills/研究简报/SKILL.md
  roles/研究分析员.json
  knowledge/通用研究方法.md
  workflows/资料研究.json
  plans/每日资料核对.json
```

## 一份最小清单

下例只列出一个技能。与它一起打包前一篇的 `skills/research-brief/SKILL.md`：

```json
{
  "format": "teloa.business-package/v2",
  "id": "research-starter",
  "title": "研究入门",
  "version": "1.0.0",
  "domain": "general",
  "description": "根据授权资料生成带来源的研究简报。",
  "resources": [{
    "id": "research-brief",
    "kind": "skill",
    "title": "研究简报",
    "version": "1.0.0",
    "required": true,
    "source": {"kind": "local", "path": "skills/research-brief/SKILL.md"}
  }],
  "relations": [],
  "entrypoints": ["research-brief"]
}
```

## 关键校验

- 资源 ID 唯一；关联必须指向包中存在且类型匹配的资源。
- 版本使用固定的三段版本号，不能使用 `latest`。
- 本地路径是包内相对路径，不能包含绝对路径、`..` 或反斜杠。
- `required: true` 的本地资源必须实际存在。
- `scope` 可选，省略时使用 `domain`；范围标识为 1–64 位字母、数字、下划线或连字符。
- 入口只能指向技能或任务模板；列出资源和授权是两回事。

## 完整业务配置与独立看板

方案 v4 可包含 `kind: "business-configuration"`。正文格式为 `teloa.business-dashboard-resource/v1`，固定 `id`、三段 `version` 和一份完整的 `teloa.business-configuration/v2` 配置；配置带齐对象类型、视图、组件、看板、页面与首页引用，至少包含一个看板页。所有引用须在配置内闭合，配置范围必须与清单一致。v2/v3 不接受这一新资源类型。

公开市场的独立看板使用 `kind: "dashboard"`，放在 `catalog/dashboards/<资源标识>.json`；工件放在 `artifacts/dashboards/<资源标识>/<版本>/`。工件根目录 `teloa.json` 为 v4，恰好声明一个必需的本地完整配置资源，`relations` 和 `entrypoints` 为空。方案可用固定 `source.id` 与相同 `source.version` 引用唯一的公共看板资源；来源不得再包含公共引用。

看板及 v4 方案只进入新版 v2 市场索引，并要求 Teloa `0.2.0-alpha.7` 及以上。添加后先选择目标业务、核对对象与字段映射，生成草案，再预览并由本人采用。资源不携带真实记录、密钥、已有同步绑定或默认动作身份；连接、同步与业务动作须在目标业务另行配置，也不会自动授予员工权限。已有数据不会根据标题或字段名自动猜测映射。

## 验证导入

先在单独的测试环境导入，检查预览中的内容和关联。确认后逐一打开岗位、技能和模板，完成一项小任务；对缺文件、错误版本和不匹配的关联，再分别验证会被拒绝。

内容导入限制当前为 1–500 个文件、单文件最多 2 MiB、总内容最多 20 MiB；界面或上传层可能还有额外限制。发布到公共目录需要更多发布元数据，不等于完整公开发布服务已开放。

格式细节见[资源格式与内部接口](https://docs.teloa.ai/v/0.2.0/markdown/develop/formats.md)。