自动创建您的第一个应用程序 create-first-app

IMPORTANT
Adobe LLM Apps当前在Beta中。
此处显示的功能、工作流和UI不一定表示产品的最终状态。 要加入Beta,请发送电子邮件至llm-apps-beta@adobe.com 。

该平台可将您的网站变成功能齐全的应用程序。 它建议操作、编写处理程序代码和测试、创建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或许可证初始化任一存储库。 该平台准备了所需的项目结构。

TIP
使用可标识应用程序和每个存储库用途的存储库名称。 这使得在应用程序创建对话框中更容易识别它们。

启动应用程序

  1. 打开Adobe LLM应用程序并选择​创建应用程序

  2. 输入​ LLM应用程序名称 ​和可选描述。

  3. 选择​Analytics区域

    note important
    IMPORTANT
    创建应用程序后,无法更改Analytics区域。
  4. 在​ 构建我的应用程序 ​中,选择​自动构建我的应用程序

  5. 在​ 您的网站 ​中,输入包括https://协议的网站URL。 该平台会分析此站点,以确定有用的操作和具有代表性的示例结果。

创建LLM应用程序 — 启用应用程序详细信息并构建我的应用程序

授予LLM Apps对存储库的访问权限

Adobe LLM Apps GitHub应用程序为您选择的存储库授予LLM Apps访问权限。

NOTE
连接GitHub组织是一次性设置。 如果该组织已出现在对话框中,请使用​ 在GitHub ​上管理存储库,而不是再次连接它。

连接的组织

如果在创建存储库之前已安装Adobe LLM应用程序GitHub应用程序:

  1. 选择连接的组织。
  2. 选择​在GitHub上管理存储库
  3. 将两个存储库添加到现有的GitHub应用程序安装中。
  4. 返回到LLM Apps并刷新存储库列表。

仅首次连接

如果组织未显示在对话框中:

  1. 选择​连接GitHub组织
  2. 安装Adobe LLM应用程序GitHub应用程序。
  3. 选择​ 仅选择存储库 ​并选择两个存储库。
  4. 返回创建LLM应用程序对话框。

如果无法安装或更新GitHub应用程序,请咨询组织管理员。

选择存储库

  1. 在​ 样板存储库 ​下,选择组织和空处理程序存储库。

  2. 在​ EDS存储库 ​下,选择组织和空的EDS存储库。

    构建我的应用程序 — 选择GitHub组织、样板存储库和EDS存储库

  3. 根据​条款和条件,选中​我接受Adobe Developer条款

  4. 选择​创建应用程序

完成EDS设置

当选定的EDS存储库为空时,LLM Apps会使用AEM样板将其初始化。 然后,该对话框会要求您在尝试再次创建应用程序之前安装AEM代码同步。

  1. 在EDS存储库下面的消息中,选择​安装AEM代码同步

  2. 在GitHub上,安装AEM Code Sync并授予它访问EDS存储库的权限。

    在​ AEM Code Sync已注册 ​确认页面的​ 站点用户 ​下,选择​ +添加用户 ​并添加用于使用​ 管理员 ​角色登录到LLM Apps的电子邮件地址。 然后选择页面底部的​完成设置

    AEM代码同步已注册 — 请将您自己添加为具有管理员角色的网站用户

  3. 返回创建LLM应用程序对话框。

创建LLM应用程序 — 初始化了空的EDS存储库,需要AEM代码同步

您必须是EDS站点的管理员。 如果对话框报告您不是管理员:

创建LLM应用程序 — 需要EDS管理员访问权限

  1. 选择​打开AEM Live Admin

  2. 通过单击​ +添加用户 ​按钮,将您添加为EDS站点的管理员。

    创建LLM应用程序 — 将您添加为EDS管理员

  3. 返回LLM Apps,刷新EDS存储库,然后再次选择​创建应用程序

在存储库和管理员检查通过后,LLM Apps将创建应用程序并开始生成操作。

等待操作生成

从左侧转到​ 操作 ​页面。 “操作”页面显示​在代理分析网站并生成应用程序时发现对话体验的操作。 生成通常大约需要15分钟。 您可以离开此页面,稍后再返回。

操作 — 生成推荐

在生成期间,LLM Apps:

  1. 分析网站并确定有用的客户意图。
  2. 创建操作元数据,包括说明和输入参数。
  3. 为处理程序存储库中的每个操作生成一个处理程序并进行测试。
  4. 为EDS存储库中的每个操作生成一个EDS小组件。
  5. 准备操作以供您审阅。

生成的处理程序最初使用从网站派生的示例数据。 它们演示了完整的体验,但未连接到您的生产系统。

查看生成的操作

生成完成后,“操作”页面将显示生成的操作和构件预览。 每个操作都有一个​ AI生成的操作,需要审核 ​徽章。

操作 — 生成的操作已准备好审查

对于每个操作:

  1. 选择​审阅
  2. 查看名称、描述、参数、注释、生成的处理程序和小组件。
  3. 选择​标记为已审阅。 这将合并生成的拉取请求。
  4. 返回到“操作”页面,然后对其余操作重复此操作。

生成的操作 — 已准备好标记为已审阅

审核所有操作后,选择​转到应用程序页面

操作 — 已审阅所有生成的操作

NOTE
生成的代码是您拥有的起点。 您可以在查看后更改操作元数据、处理程序、测试、构件JavaScript和小组件样式。

部署应用程序

  1. 返回到“应用程序详细信息”页面。
  2. 选择​部署
  3. 选择​ Stage ​作为目标环境。
  4. 选择​部署

部署 — 选择暂存环境

LLM Apps正在准备、生成和发布应用程序,请稍候。

部署 — 部署管道正在运行

部署 — 成功的暂存部署

部署后,测试应用程序​部分显示暂存MCP服务器URL。 选择​复制URL

应用程序详细信息 — 复制暂存MCP服务器URL

在ChatGPT中测试

在ChatGPT🔗中执行测试,以使用暂存MCP服务器URL创建插件。

提出与生成的操作之一匹配的问题。 验证:

  • ChatGPT选择所需的操作。
  • 构件将渲染并包含预期的示例数据。
  • 构件控件产生预期的跟进行为。
  • 文本响应准确地总结了结果。

ChatGPT — 生成的LLM应用程序插件响应

您现在拥有功能齐全的端到端应用程序。

使应用程序做好生产准备

生成的应用程序使用示例数据。 在与客户一起使用之前:

  1. 连接您的系统自定义每个生成的处理程序,将样本数据替换为对API或数据源的调用。
  2. 保护凭据 — 将API URL和凭据存储在托管运行时配置中,而不是在源代码或小组件JavaScript中。
  3. 验证数据 — 验证操作参数和API响应,添加请求超时并返回安全错误消息。
  4. 更新构件 — 使每个构件与其处理程序的structuredContent保持一致,然后应用您的品牌推广和可访问性要求。 请参阅自定义生成的构件
  5. 测试处理程序 — 涵盖有效输入、无效输入、空结果、API失败以及构件预期的数据形状。
  6. 在暂存中验证 — 通过ChatGPT插件重新部署和测试每个操作。
  7. 部署到生产 — 暂存测试成功后,部署到生产,并使用生产MCP服务器URL创建或更新插件。

若要添加平台未创建的功能,请参阅从头开始创建操作

recommendation-more-help
llm-apps-help-main-toc