AgentKit Studio
参考

模板 Schema

`agentkit.studio.team-template/v1` 的字段约束、拒绝形状与 7 个 `TEAM_TEMPLATE_*` 错误码。

契约常量

专家团模板契约标识为 agentkit.studio.team-template/v1。它描述的是「目录里的模板」到 TeamDefinition 之间的归一化边界。

常量值说明
TEAM_TEMPLATE_CONTRACTagentkit.studio.team-template/v1契约版本
TEAM_TEMPLATE_RUNTIMESdsh-native · harness角色可用的运行时
TEAM_PLACEHOLDER_MODELSone-team-model占位模型,校验时拒绝
TEAM_DEFAULT_MODEL[内部模型代号,见源码]内部模型代号,本页脱敏

字段约束

validateTeamTemplate() 是唯一入口。下面的长度上限由校验器里的 requiredText / optionalText 调用抽出,与实现同源。

字段上限单位
instructions16000字符
roles[].instructions8000字符
roles[].template.id256字符
roles[].template.digest256字符
roles[].model / defaultModel256字符
id128字符
name120字符
roles[].label80字符
roles[].template.version64字符
roles[].name64字符

此外还有格式约束:

字段类型 / 正则约束
kind"team"固定值,其他值直接拒绝
id^[a-z][a-z0-9-]*$小写字母开头,只含小写字母、数字与短横线
version^\d+\.\d+\.\d+$严格三段 semver
rolesarray2–9 个角色,roles[0].name 必须是 lead
roles[].name^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$短横线分段,全员唯一
roles[].template.versionsemver缺省回退到专家团 version

拒绝的形状

输入规则改法
roles[].agentId角色不能引用普通 Agent改用不可变的 template 引用
roles[].source.kind值为 agent 时被拒绝同上
subAgents / sub_agents角色不能再声明嵌套 subagent在专家团层组合角色
roles[].template缺少 id 或 digest补上内容锁
占位模型one-team-model必须换成真实模型 profile
runtime.typedsh-native · harness只有这两种运行时可用

错误码

错误码位置含义
TEAM_TEMPLATE_INVALIDsrc/team-template-contract.mjs:21专家团角色与模板。
TEAM_TEMPLATE_MODEL_INVALIDsrc/team-template-contract.mjs:32专家团角色与模板。
TEAM_TEMPLATE_ROLE_SOURCE_INVALIDsrc/team-template-contract.mjs:38专家团角色与模板。
TEAM_TEMPLATE_ROLE_INVALIDsrc/team-template-contract.mjs:58专家团角色与模板。
TEAM_TEMPLATE_ROLE_SPEC_INVALIDsrc/team-template-contract.mjs:92专家团角色与模板。
TEAM_TEMPLATE_RUNTIME_UNSUPPORTEDsrc/team-template-contract.mjs:94专家团角色与模板。
TEAM_TEMPLATE_NESTED_TEAM_UNSUPPORTEDsrc/team-template-contract.mjs:95专家团角色与模板。

版本与兼容性

项值说明
契约agentkit.studio.team-template/v1新增必填字段是破坏性变更
角色数2–9单个专家团的上限
运行时dsh-native · harnesscodex 不能作为团队角色运行时
错误码7全部以 TEAM_TEMPLATE_ 或 TEAM_ 开头

开发者入口

内容源码位置
模板契约与校验src/team-template-contract.mjs
模板目录src/template-catalog-source.mjs
专家团运行时src/studio-team-runtime.mjs
模板召唤src/team-template-summon.mjs

相关测试:

测试文件位置
team-template-contract.test.mjstests/team-template-contract.test.mjs
team-template-summon.test.mjstests/team-template-summon.test.mjs

本页导航