通过Foundry Templates部署Ontology Action遇OntologyMetadata:InvalidApiNameFormat错误求助

错误重现 #

部署Foundry模板时触发如下错误：

OntologyMetadata:InvalidApiNameFormat
Failed to deploy an action.

模板内的详细错误信息：

apiNames
[notional3-generated-8dasd32-4bc9-4c312-831231232-113d31231236d80-new-action-312391c1-af321d-24-03123213129c]
safeMessage
Failed to deploy an action. Unknown error encountered.

核心原因 #

为Action API名称添加前缀后，生成的最终名称违反了Foundry Ontology对API名称的格式约束，从给出的apiName来看，长度超标是主要问题。

Ontology API名称的格式约束 #

• 字符范围：仅允许小写字母（a-z）、数字（0-9）、连字符（-）；不能以连字符开头或结尾
• 长度限制：总长度不得超过64个字符
• 结构要求：禁止连续出现连字符，不能包含大写字母、下划线或其他特殊符号

解决步骤 #

1. 缩短自定义前缀的长度，同时限制自动生成后缀（如UUID片段）的字符数，确保拼接后的总长度≤64
2. 检查前缀是否包含非法字符，统一转为小写，将非允许字符替换为单个连字符（避免连续连字符）
3. 调整模板中API名称的生成逻辑，比如只保留UUID的前8-12位，减少自动生成部分的长度

内容的提问来源于stack exchange，提问作者Rover