用途:为 Lightning 平台(含 Einstein Agent 动作)创建 Custom Lightning Types(CLT),以 JSON Schema 描述结构化输入/输出,并驱动编辑器与渲染器体验。
主要能力:生成 schema.json;可选生成 editor.json 与 renderer.json;支持引用其他 CLT(c__<CLTName>)、标准 Lightning 类型、Apex 类类型(@apexClassType/...);支持 widget/mosaic/fragment 渲染(须先获取 references/widget-rendition.md 并按其中流程操作)。
必要用法:文件放入 lightningTypes/<TypeName>/schema.json,可选 lightningDesktopGenAi/editor.json、renderer.json。根对象须含 type: object、title、lightning:type: lightning__objectType、unevaluatedProperties: false;禁止 $schema 字段;根对象在严格校验下不得含 examples;嵌套对象不得设 lightning__objectType;数组规则严格,默认禁用 items。编辑器/渲染器使用 componentOverrides 与 layout,弃用 propertyRenderers 与 view;lightning/propertyLayout 仅接受 property 属性。自定义 LWC 需在 -meta.xml 中配置 lightning__AgentforceInput(编辑器)或 lightning__AgentforceOutput(渲染器)。
适用场景:为 Einstein Agent 动作定义结构化输入输出、自定义编辑/渲染 UI、widget 渲染及排查部署错误。
限制:CLT 元模式校验严格,未知关键字会失败;嵌套数组与 items 常被拒绝;Apex 类 CLT 仅含 title、可选 description 与 lightning:type;属性映射须引用 schema 中真实存在的属性。具体支持类型与约束见 assets/primitive-types-and-constraints.md。