自动创建您的第一个应用程序 create-first-app
该平台可将您的网站变成功能齐全的应用程序。 它建议操作、编写处理程序代码和测试、创建EDS小部件,并将生成的文件发送到您拥有的两个GitHub存储库。
生成大约需要15分钟。 在本教程结束时,您将拥有一个已部署的应用程序,您可以在支持的LLM平台(如ChatGPT)中测试该应用程序。
历程:确认→创建两个存储库→创建应用程序→查看生成的操作→部署到暂存环境→测试插件→连接生产系统的要求。
开始之前
在开始本教程之前,请先完成所有LLM应用要求。
本教程将为Frescopa Coffee创建一个LLM应用。
创建两个空存储库
该平台需要两个空存储库。 在同一个GitHub帐户或组织下创建两者:
- 处理程序存储库 — 存储操作处理程序和测试。 例如,
my-brand-llm-app。 - EDS存储库 — 存储生成的构件块和样式。 例如,
my-brand-llm-app-eds。
前往每个存储库的github.com/new。
不要使用README、.gitignore或许可证初始化任一存储库。 该平台准备了所需的项目结构。
启动应用程序
-
打开Adobe LLM应用程序并选择创建应用程序。
-
输入 LLM应用程序名称 和可选描述。
-
选择Analytics区域。
note important IMPORTANT 创建应用程序后,无法更改Analytics区域。 -
在 构建我的应用程序 中,选择自动构建我的应用程序。
-
在 您的网站 中,输入包括
https://协议的网站URL。 该平台会分析此站点,以确定有用的操作和具有代表性的示例结果。
授予LLM Apps对存储库的访问权限
Adobe LLM Apps GitHub应用程序为您选择的存储库授予LLM Apps访问权限。
连接的组织
如果在创建存储库之前已安装Adobe LLM应用程序GitHub应用程序:
- 选择连接的组织。
- 选择在GitHub上管理存储库。
- 将两个存储库添加到现有的GitHub应用程序安装中。
- 返回到LLM Apps并刷新存储库列表。
仅首次连接
如果组织未显示在对话框中:
- 选择连接GitHub组织。
- 安装Adobe LLM应用程序GitHub应用程序。
- 选择 仅选择存储库 并选择两个存储库。
- 返回创建LLM应用程序对话框。
如果无法安装或更新GitHub应用程序,请咨询组织管理员。
选择存储库
-
在 样板存储库 下,选择组织和空处理程序存储库。
-
在 EDS存储库 下,选择组织和空的EDS存储库。
-
根据条款和条件,选中我接受Adobe Developer条款。
-
选择创建应用程序。
完成EDS设置
当选定的EDS存储库为空时,LLM Apps会使用AEM样板将其初始化。 然后,该对话框会要求您在尝试再次创建应用程序之前安装AEM代码同步。
-
在EDS存储库下面的消息中,选择安装AEM代码同步。
-
在GitHub上,安装AEM Code Sync并授予它访问EDS存储库的权限。
在 AEM Code Sync已注册 确认页面的 站点用户 下,选择 +添加用户 并添加用于使用 管理员 角色登录到LLM Apps的电子邮件地址。 然后选择页面底部的完成设置。
-
返回创建LLM应用程序对话框。
您必须是EDS站点的管理员。 如果对话框报告您不是管理员:
-
选择打开AEM Live Admin。
-
通过单击 +添加用户 按钮,将您添加为EDS站点的管理员。
-
返回LLM Apps,刷新EDS存储库,然后再次选择创建应用程序。
在存储库和管理员检查通过后,LLM Apps将创建应用程序并开始生成操作。
等待操作生成
从左侧转到 操作 页面。 “操作”页面显示在代理分析网站并生成应用程序时发现对话体验的操作。 生成通常大约需要15分钟。 您可以离开此页面,稍后再返回。
在生成期间,LLM Apps:
- 分析网站并确定有用的客户意图。
- 创建操作元数据,包括说明和输入参数。
- 为处理程序存储库中的每个操作生成一个处理程序并进行测试。
- 为EDS存储库中的每个操作生成一个EDS小组件。
- 准备操作以供您审阅。
生成的处理程序最初使用从网站派生的示例数据。 它们演示了完整的体验,但未连接到您的生产系统。
查看生成的操作
生成完成后,“操作”页面将显示生成的操作和构件预览。 每个操作都有一个 AI生成的操作,需要审核 徽章。
对于每个操作:
- 选择审阅。
- 查看名称、描述、参数、注释、生成的处理程序和小组件。
- 选择标记为已审阅。 这将合并生成的拉取请求。
- 返回到“操作”页面,然后对其余操作重复此操作。
审核所有操作后,选择转到应用程序页面。
部署应用程序
- 返回到“应用程序详细信息”页面。
- 选择部署。
- 选择 Stage 作为目标环境。
- 选择部署。
LLM Apps正在准备、生成和发布应用程序,请稍候。
部署后,测试应用程序部分显示暂存MCP服务器URL。 选择复制URL。
在ChatGPT中测试
在ChatGPT🔗中执行测试,以使用暂存MCP服务器URL创建插件。
提出与生成的操作之一匹配的问题。 验证:
- ChatGPT选择所需的操作。
- 构件将渲染并包含预期的示例数据。
- 构件控件产生预期的跟进行为。
- 文本响应准确地总结了结果。
您现在拥有功能齐全的端到端应用程序。
使应用程序做好生产准备
生成的应用程序使用示例数据。 在与客户一起使用之前:
- 连接您的系统 — 自定义每个生成的处理程序,将样本数据替换为对API或数据源的调用。
- 保护凭据 — 将API URL和凭据存储在托管运行时配置中,而不是在源代码或小组件JavaScript中。
- 验证数据 — 验证操作参数和API响应,添加请求超时并返回安全错误消息。
- 更新构件 — 使每个构件与其处理程序的
structuredContent保持一致,然后应用您的品牌推广和可访问性要求。 请参阅自定义生成的构件。 - 测试处理程序 — 涵盖有效输入、无效输入、空结果、API失败以及构件预期的数据形状。
- 在暂存中验证 — 通过ChatGPT插件重新部署和测试每个操作。
- 部署到生产 — 暂存测试成功后,部署到生产,并使用生产MCP服务器URL创建或更新插件。
若要添加平台未创建的功能,请参阅从头开始创建操作。