应用程序如何连接在一起 app-architecture

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

LLM应用程序​将您品牌的服务引入到AI对话中。 例如,客户请求提供咖啡推荐,您的应用程序找到匹配的产品,助手显示结果。

在本指南中:​了解应用程序每个部分的功能、更改位置以及当有人使用应用程序时,这些部分如何协同工作。

应用程序的三个部分

一个应用可以对多个相关操作进行分组,如​浏览产品、比较产品​和​查找商店。 每个操作都有自己的设置、处理程序和可选小组件。 添加操作不需要另一对存储库。

带交互式小组件的应用程序包含三个部分:操作设置、处理程序代码和小组件代码。 您管理LLM Apps中的设置。 处理程序和构件代码位于两个单独的GitHub存储库中。

┌───────────────────────┐   ┌───────────────────────┐   ┌───────────────────────┐
│ 1. LLM Apps UI        │   │ 2. Handler repository │   │ 3. Widget repository  │
│                       │   │                       │   │                       │
│ Action descriptions   │   │ Connects to your APIs │   │ Widget layout         │
│ Required information  │   │ Runs the task         │   │ Branding and styles   │
│ When to use an action │   │ Returns results       │   │ Interactive controls  │
└───────────────────────┘   └───────────────────────┘   └───────────────────────┘
            │                           │                           │
            └───────────────────────────┼───────────────────────────┘
                                        ▼
                    ┌───────────────────────────────────────┐
                    │ Your app in an AI conversation        │
                    │ The action runs and the widget        │
                    │ shows the result.                     │
                    └───────────────────────────────────────┘
  • 操作设置描述了任务。 他们告知助理何时使用操作以及操作需要哪些信息。 对于产品搜索,该信息可能是类别或搜索词。
  • 处理程序执行工作。 它从您的系统中获取数据或执行任务。 例如,产品搜索处理程序会从目录中检索匹配的产品。
  • 构件显示结果。 它控制客户看到的内容并与之交互,如带有名称、价格和按钮的产品卡。

我们建议为每个操作添加一个构件。 利用小组件,您可以控制结果的外观以及客户与它们的交互方式,而不是将演示文稿留给AI助手。 仅文本响应也受支持。

在何处进行更改

您要更改的内容
编辑位置
助理使用操作时,或操作请求的信息
LLM应用程序中的操作设置
结果来自何处,或者操作运行时会发生什么情况
处理程序存储库中的处理程序代码
结果的外观,包括布局、品牌和交互
构件存储库中的构件代码

保持这三个部分的一致性。 例如,如果更改处理程序返回的信息,请更新构件以显示新结果。

对话中发生的情况

部署后,您的应用程序有一个连接URL,称为​MCP服务器URL。 将此URL添加到支持的AI平台,以便助手能够发现并使用您应用程序的操作。

对于具有产品搜索操作和小组件的应用程序:

  1. 一位客户要求助理​给我看咖啡盒。
  2. 助手使用操作的描述来选择产品搜索操作。
  3. 处理程序从目录获取匹配的产品。
  4. 小组件会将产品显示为对话中的信息卡。
  5. 客户浏览结果或提出后续问题。

当您的应用程序提供信息或服务时,客户将留在对话中。 构件支持依赖于LLM平台。

应用并测试更改

先发布构件更改并部署操作更改,然后再测试更新的体验。 请按照部署您的应用程序以部署到暂存环境并在支持的LLM平台上测试该应用程序。

自动生成的操作以示例数据开头。 将处理程序连接到您的实际系统并测试应用程序,然后再将其提供给客户。

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