创建操作
本指南将指导您完成在LLM Apps UI中定义操作的过程。 有关操作的背景及其工作方式，请参阅核心概念。
打开“操作”页面
导航到左侧边栏中的操作，或单击“应用程序详细信息”页面上的转到操作。 如果尚未执行任何操作，则页面将显示空状态。
单击 +创建操作 以打开全屏对话框。
操作卡
每个操作都会显示为一个信息卡，其中显示：
- 操作 name 和description
- 构件预览图像 — 从构件自动生成，显示LLM平台内的操作输出外观
- 徽章：构件类型(EDS)、部署状态（未部署、部署到暂存、部署到生产）、自上次部署以来修改操作时未部署更改，以及参数计数
- 可见性切换 — 启用或禁用实时终结点上的操作，而不重新部署
- 右上角的 Review 链接可打开操作编辑器
如果自上次部署以来修改了一个或多个操作，“操作”页面的顶部会显示 需要部署 横幅。 重新部署应用程序以应用更改。
“操作”选项卡
该对话框有两个选项卡： 操作和小组件元数据。
基本信息
-
操作名称（必需） — 操作的标识符（例如，搜索产品）。
-
描述（必需） — 该操作的明确说明。 LLM平台将使用此项来决定何时调用操作。 例如：按关键字搜索产品目录。 返回与名称、类别、图像和价格匹配的产品。
-
注释 — 描述操作行为的可选提示：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 注释 描述 破坏性提示 操作可修改或删除数据 幂等 使用相同的参数多次调用该操作会生成相同的结果 Open World提示 该操作与外部系统交互 只读提示 该操作只读取数据，从不写入 有关详细信息，请参阅引用：元数据字段。
OpenAI元数据
- 调用状态文本 — 操作运行时在LLM平台中显示的消息（最多64个字符）。 示例： 正在加载产品……
- 调用状态文本 — 操作完成后显示的消息（最多64个字符）。 示例： 产品已加载。
可见性和输入参数
可见性控制操作可用位置：
- 向AI模型公开 — AI模型可以调用操作。
- 在应用程序表面中显示为构件 — 该操作将呈现可视化构件。
输入参数是LLM平台发送到您的处理程序的值。 模型会自动从用户消息中提取这些参数。 对于搜索产品，我们定义：
- 类别 （字符串，可选） — 用于缩小结果的类别筛选器（例如，产品类型或部门）。
- 查询 （字符串，可选） — 自由文本搜索词。
每个参数都有一个Name、Type(String， Number， Integer， Boolean)、Description和 Required 复选框。 单击 +添加 以添加更多参数。
有关更多详细信息，请参阅引用：操作参数。
分析
- 用户意图 — 启用时，将要求ChatGPT总结导致调用此操作的对话。 该摘要将在Analytics中收集和显示，为您提供insight有关触发操作时用户尝试完成的任务的信息。
“小组件元数据”选项卡
此选项卡配置操作的可视响应在LLM平台中的呈现方式。 有关构件工作方式的完整说明，请参阅指南：设置构件(EDS)。
构件信息
- 类型 — 构件技术（当前为EDS）。
- 小组件域（沙盒源） — 托管小组件的源。 将应用程序提交到OpenAI时需要；每个应用程序必须是唯一的。
- 首选边框 — 在边框卡中呈现构件。
模板URL
- 脚本URL — 引导小部件的入口点，在所有操作之间共享：
https://main--<repo>--<owner>.aem.live/scripts/aem-embed.js - Widget嵌入URL — 此特定操作的EDS页面：
https://main--<repo>--<owner>.aem.live/eds-widgets/<action-name>
权限
构件可以访问的硬件和浏览器API：
CSP配置
控制构件iframe可以联系的外部域。 每个外部域都必须明确列入允许列表。
fetch、XHR或WebSocket联系的域openExternal个重定向链接的受信任目标（特定于ChatGPT）base-uri CSP指令（仅MCP应用SDK，不受ChatGPT支持）单击 新建操作 以进行保存。
创建操作后
您的操作将作为卡片显示在“操作”页面上：
每个卡片都显示操作名称、说明、类型徽章(EDS)、部署状态（未部署）和参数计数。 您可以单击 … 进行编辑或删除，或单击 查看 检查配置。
操作元数据已保存，但尚未部署任何代码。 要使操作正常运行，您需要：
- 设置EDS构件 — 请参阅指南：设置构件(EDS)。
- 编写处理程序 — 请参阅指南：编写操作处理程序。
- 部署 — 请参阅指南：部署您的应用程序。