---
title: 资源格式与内部接口
description: 核对格式、默认值、版本和错误，不依赖未稳定的 API。
lastVerified: 2026-09-23
---

# 6.9 资源格式与内部接口

这些格式服务于当前 Alpha 的导入与内部通信，版本升级时应重新验证，不是永久兼容的公开 API 承诺。

## 常用资源格式

| 格式 | 用途 | 核对重点 |
| --- | --- | --- |
| `teloa.business-package/v2` | 业务包清单 | 资源身份、固定版本、关联与范围 |
| `teloa.role/v1` | 岗位定义 | 职责、资料范围、执行范围 |
| `teloa.work-template/v1` | 任务模板 | 输入要求、输出、技能引用版本 |
| `teloa.mcp-connection/v1` | MCP 连接声明 | serverName 与工具集合 |
| `teloa.reference-list/v1` | MCP 资料列表 | 来源、字节数、SHA-256 版本 |
| `teloa.reference/v1` | MCP 读取结果 | 正文与同版本来源 |

资源包的 `scope` 默认取 `domain`。引用的版本与资源声明必须一致；不要依赖 JSON 字段顺序作为对象相等判据。

## 未知字段与损坏数据

多处读取器采用严格字段校验，拼错的字段不会自动忽略。格式不合法与已存数据损坏应分别处理：前者修正输入，后者保留证据并从可信备份或来源修复。

## 内部 RPC

客户端经 Harness 使用内部 RPC 请求。端点、请求信封、鉴权 Cookie 与返回解析会随版本变化，不应把浏览器抓到的请求直接当成面向第三方的稳定 REST 接口。

系统集成优先使用[已支持的 MCP 路径](https://docs.teloa.ai/markdown/develop/mcp.md)。若需要新的稳定集成接口，先明确身份、权限、幂等、版本和错误契约，再实现适配。