
Puck AI 把页面生成约束为组件数据,再用业务上下文与服务端工具接入真实规则和数据,保留人工修改与发布边界。
components 定义组件,通过 render 描述呈现方式,再通过 fields 暴露可编辑输入。用户拖入一个标题组件后,编辑器生成的结果会落成一份包含 type 和 props 的 JSON 数据。3instructions 可以附着在组件或字段上。开发者可以告诉模型标题组件应当放在前面,也可以规定某个字段采用特定写法。规则跟着组件走,页面生成时便能复用同一套局部判断。5schema 把自定义字段的内部数据形状写出来。模型遇到自定义字段、外部字段或用户字段时,仍然能按照 JSON Schema 生成可识别的数据。5required 和 exclude 分别控制哪些字段必须出现、哪些字段永远交给人工或其他流程处理。图片地址这类字段还可以关闭流式生成,减少预览阶段出现半截值的情况。5context,用来告诉模型品牌、受众、语气和业务规则;第二种是 tool,让模型通过宿主服务器查询真实系统。官方文档分别给出了 context、puckHandler()、generate() 和 tool() 的接入方式。67context 负责解释“页面应该服务谁、遵循什么规则”;工具负责回答“这次页面生成需要从系统拿到什么”。例如,SaaS 产品可以把品牌颜色、目标客户和文案语气放进上下文,再提供一个查询价格数据的服务端工具。模型据此组合价格区块,价格本身仍然来自产品自己的系统。bind 绑定到某个字段,让字段严格使用指定工具的返回值。7generate() 更新。2Hero、PricingGrid、FAQ 这类真实存在的 React 组件注册进 components,为每个组件写清 fields、render 和 defaultProps。组件配置决定模型可以组合的页面语言。3PricingGrid 的字段补充 instructions,说明价格层级的顺序和展示条件;把内部结构复杂的字段补上 schema;把必须出现的字段标记为 required,把人工审核字段设为 exclude。5puckHandler() 或一次性的 generate() 请求里传入品牌、目标客户和文案语气。上下文描述业务规则,组件配置描述页面规则,两种规则各自放在最靠近它们的位置。6tool() 定义查询接口,写清工具用途与输入 schema;需要整页先拿到数据时使用 preload,需要某个字段严格接收工具结果时使用 bind。服务端先完成查询与权限处理,再把结果交给 agent。7generate() 返回的页面数据可以交给 Puck 编辑器修改,也可以交给渲染器直接展示。先检查价格、区块顺序和文案,再把 JSON 存进自己的后端;这个检查点把生成和发布分开。2instructions、schema、required 和 exclude 负责缩小局部自由度;context 与服务端 tool 负责把业务规则和真实数据接进生成链路;编辑器则给人工保留修改位置。puckeditor.com
puckeditor.com
puckeditor.com
puckeditor.com
puckeditor.com
puckeditor.com
puckeditor.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.