SuperAPI AI 工具集

generating-custom-lightning-type

智能体与模型

查看项目

更新于 10-15 21:43

技能介绍

用途:为 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。