앱 연결 방법 app-architecture
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 도우미에 맡기지 않고 결과가 표시되는 방식과 고객이 상호 작용하는 방식을 제어할 수 있습니다. 텍스트 전용 응답도 지원됩니다.
변경할 위치
세 부분을 일관되게 유지하십시오. 예를 들어 핸들러가 반환하는 정보를 변경하는 경우 위젯을 업데이트하여 새 결과를 표시합니다.
대화에서 발생하는 작업
배포 후 앱에 MCP 서버 URL이라는 연결 URL이 있습니다. 도우미가 앱의 작업을 검색하고 사용할 수 있도록 지원되는 AI 플랫폼에 이 URL을 추가합니다.
제품 검색 작업 및 위젯이 있는 앱의 경우:
- 고객이 도우미 커피 팟을 보여 달라고 요청합니다.
- 도우미는 작업 설명을 사용하여 제품 검색 작업을 선택합니다.
- 핸들러가 카탈로그에서 일치하는 제품을 가져옵니다.
- 위젯은 대화에서 제품을 카드로 표시합니다.
- 고객이 결과를 탐색하거나 후속 질문을 합니다.
앱이 정보나 서비스를 제공하는 동안 고객은 대화에 남아 있습니다. 위젯 지원은 LLM 플랫폼에 따라 다릅니다.
변경 사항 적용 및 테스트
업데이트된 경험을 테스트하기 전에 위젯 변경 사항을 게시하고 작업 변경 사항을 배포하십시오. 앱 배포에 따라 Stage에 배포하고 지원되는 LLM 플랫폼에서 앱을 테스트합니다.
자동으로 생성된 작업은 샘플 데이터로 시작됩니다. 처리기를 실제 시스템에 연결하고 앱을 테스트한 후 고객이 사용할 수 있도록 합니다.