操作和构件字段 action-widget-configuration
IMPORTANT
Adobe LLM Apps当前在Beta中。
此处显示的功能、工作流和UI不一定表示产品的最终状态。 要加入Beta，请发送电子邮件至llm-apps-beta@adobe.com 。
使用此页可在操作编辑器中查找字段。 有关完整的创建历程，请参阅从头开始创建操作。
操作参数
输入参数是LLM平台发送到操作处理程序的值。 该模型从用户的消息中提取这些字段并将它们映射到这些字段。
属性
描述
名称
参数标识符（例如，
category，query）类型
String、Number、Integer或Boolean描述
易于用户识别的解释 — LLM平台使用它来提取正确的值
必需
如果选中，则在调用操作之前，模型必须提供此参数
文件参数
文件参数是在操作编辑器中配置的输入字段名称。 当用户上传文件时，主机会为这些参数（通常包括download_url和file_id）提供文件对象。
元数据字段
基本信息
字段
必需
描述
操作名称
是
操作的显示名称（例如，搜索产品）
描述
是
操作功能的说明 — LLM平台使用此项来决定何时调用它
创建后，编辑器还会显示不可变的代码标识符。 它将操作映射到处理程序存储库中的actions/<code-identifier>/index.js。
注释
描述操作行为的可选提示：
注释
描述
破坏性提示
操作可修改或删除数据
幂等
使用相同的参数多次调用该操作将获得相同的结果
Open World提示
该操作与外部系统交互
只读提示
该操作只读取数据，从不写入
OpenAI元数据
字段
最大长度
描述
正在调用状态文本
64个字符
运行操作时在LLM平台中显示的消息（例如，正在加载产品…… ）
调用状态文本
64个字符
操作完成后显示的消息（例如，产品已加载……）
构件描述
512个字符
映射到
_meta["openai/widgetDescription"]；汇总模型的渲染组件并减少重复的旁白操作描述控制模型何时选择操作。 构件描述说明了组件在呈现之后显示的内容。
可见性
切换
描述
公开给AI模型
AI模型可在对话期间调用操作
在应用程序表面中显示为小组件
操作在应用程序中呈现可视化构件
分析
字段
描述
收集用户意图
收集导致执行分析操作的对话摘要
构件字段
构件信息
字段
描述
类型
构件技术 — 当前为EDS
Widget域（沙盒源）
托管构件的来源；每个应用程序必须是唯一的
首选边框
如果选中，该构件将在LLM平台中的边框卡中呈现
模板URL
字段
描述
脚本URL
EDS
scripts/aem-embed.js入口点的HTTPS URL。 在同一EDS项目中跨操作共享小组件URL
此操作渲染的EDS页面的HTTPS URL。 生成的操作可自动配置此项
CSP配置
内容安全策略控制构件iframe可以联系哪些外部域。 每个外部域都必须明确列入允许列表。
指令
描述
资源域
静态资产的域 — 图像、字体、脚本、样式
连接域
构件可能通过
fetch、XHR或WebSocket联系的域帧域
允许嵌套iframe的源；触发更严格的应用程序审核
重定向域
openExternal个重定向链接的受信任目标（特定于ChatGPT）基本URI域
base-uri CSP指令（仅MCP应用SDK，而不是ChatGPT）权限
允许构件访问的硬件和浏览器API。 这些将映射到iframe权限策略。
权限
描述
摄像头
访问设备摄像头
麦克风
访问设备麦克风
地理位置
访问用户的位置
剪贴板
从剪贴板读取或写入剪贴板
recommendation-more-help
llm-apps-help-main-toc