이 페이지에서는 대화형 Google Chat 앱을 빌드하는 방법을 간략하게 설명합니다. 대화형 Chat 앱은 Google Chat을 확장하는 Google Workspace 부가기능으로 빌드됩니다.
대화형 채팅 앱을 사용하면 다음 작업을 할 수 있습니다.
- Chat 스페이스 또는 다이렉트 메시지에 Chat 앱을 추가합니다.
- 텍스트, 카드, 대화형 UI 요소가 포함된 Chat 앱으로 메시지를 보내거나 Chat 앱에서 메시지를 받습니다.
- 채팅 앱과의 1:1 채팅 메시지의 홈 탭에서 앱 홈 카드를 보고 상호작용합니다.
- 슬래시 명령어, 빠른 명령어 또는 메시지 작업으로 Chat 앱에 프롬프트를 표시합니다.
- Chat 메시지의 링크를 미리 보고 대화를 종료하지 않고도 조치를 취할 수 있습니다.
- 대화상자 또는 카드 메시지에 텍스트를 입력하는 등 정보를 Chat 앱에 제출합니다.
- Google Workspace 애플리케이션 전반에서 작업을 자동화하거나 수행하고 외부 도구 또는 서비스에 연결할 수 있습니다.
사용자가 대화형 Chat 앱을 검색하고 사용하는 방법
Chat에서 Chat을 확장하는 부가기능은 사용자에게 Google Chat 앱으로 표시됩니다. 사용자는 다음과 같은 다양한 방법으로 Marketplace에 게시된 Chat 앱을 검색하고 사용할 수 있습니다.
- Google Chat 또는 Marketplace에서 Chat 앱을 검색하고 설치합니다.
- Chat 스페이스에 추가된 Chat 앱과 상호작용
- Google Workspace 관리자가 사용자를 대신하여 Chat 앱을 설치한 후 채팅 메시지 패널에서 Chat 앱을 확인할 수 있습니다.
Google Chat 사용자는 Chat 앱을 사용하기 위해 Chat 앱으로 채팅 메시지를 시작하거나 스페이스에 추가할 수 있습니다. 사용자는 @멘션하여 Chat 앱을 추가할 수도 있습니다. 자세한 내용은 Chat 앱 사용하기를 참고하세요.
다음 예는 사용자가 스페이스에 추가하기 위해 채팅 앱을 @멘션하는 방법을 보여줍니다.
시작하기
양방향 채팅 앱 빌드를 시작하려면 다음 문서를 참고하세요.
- Google Chat API를 구성하고 Chat 앱의 대화형 기능을 사용 설정합니다.
- 트리거, 이벤트 객체, 작업을 사용하여 사용자 상호작용을 수신하고 응답하는 방법을 알아봅니다.
- 빠른 시작을 통해 원하는 Google Chat 앱 아키텍처에 맞는 기본 Chat 앱을 빌드해 보세요.
기본 Chat 앱 구성 및 만들기
다음 표에는 각 Google Chat 앱 아키텍처에 대해 Chat API를 구성하고 기본적인 대화형 Chat 앱을 만드는 방법에 관한 문서가 나와 있습니다.
| 아키텍처 또는 작업 | 가이드 |
|---|---|
| Chat API 구성 | Google Chat API 구성 |
| 빠른 시작 | |
| Apps Script | Apps Script로 Chat 앱 빌드하기 |
| HTTP 서비스 (Cloud Run Functions) | HTTP Chat 앱 빌드 |
| Pub/Sub | Pub/Sub로 채팅 앱 빌드 |
| Dialogflow CX | Dialogflow CX Chat 앱 빌드 |
| Dialogflow ES | Dialogflow ES Chat 앱 빌드 |
| 에이전트 개발 키트 (ADK) AI 에이전트 | ADK AI 에이전트 채팅 앱 빌드 |
| Agent2Agent (A2A) AI 에이전트 | A2A AI 에이전트 채팅 앱 빌드 |
| A2UI AI 에이전트 | A2UI AI 에이전트 채팅 앱 빌드 |
| Gemini Enterprise AI 에이전트 | Gemini Enterprise AI 에이전트 채팅 앱 빌드 |
양방향 기능 빌드
다음 표에는 대화형 Chat 앱 기능을 빌드하는 문서가 나와 있습니다.
| 기능 | 가이드 |
|---|---|
| 사용자 상호작용 수신 및 응답 | 사용자 상호작용 수신 및 응답 |
| 메시지 보내기 (상호작용에 답장하거나 선제적으로 보내기) | 메시지로 답장 또는 Chat API를 사용하여 메시지 보내기 |
| 슬래시 명령어, 빠른 명령어, 메시지 작업에 응답 | 명령에 응답하기 |
| 대화형 대화상자 빌드 | 대화형 대화상자 열기 |
| 카드 및 대화상자에서 정보 수집 및 처리 | 카드에서 사용자가 입력한 양식 데이터 읽기 |
| Chat 메시지에서 링크 미리보기 | 링크 미리보기 |
| 1:1 채팅 메시지에서 홈페이지 (앱 홈) 빌드 | Chat 앱의 홈페이지 빌드 |
| 외부 시스템 및 도구에 연결 | Chat 앱을 다른 서비스 및 도구와 연결하기 |
Google Workspace 부가기능의 제한사항 및 고려사항
Chat 앱은 Chat을 확장하는 Google Workspace 부가기능으로 빌드되므로 다음 기능 제한사항을 참고하세요.
- AppSheet Google Workspace 부가기능으로 빌드할 때는 채팅 앱 아키텍처를 사용할 수 없습니다. 대신 HTTP 서비스, Apps Script, Dialogflow ES, Dialogflow CX 또는 Pub/Sub을 사용하여 Chat 앱을 빌드하세요.
- Chat에서는 맞춤 승인 카드가 지원되지 않습니다. Chat에서 서비스를 인증하고 서비스에 승인을 부여하려면 Chat 앱이 기본 승인 카드를 반환해야 합니다.
- Chat 사이드바의 부가기능 홈페이지는 지원되지 않습니다. 매니페스트 (
addons.common.homepageTrigger)에서 홈페이지 트리거를 구성한 경우 홈페이지는 부가기능이 확장하는 다른 Google Workspace 애플리케이션의 사이드바에만 표시됩니다. 대신 채팅 앱과의 1:1 채팅 메시지의 홈 탭에 표시되는 채팅 앱의 홈페이지를 빌드할 수 있습니다.
Chat에서 작동하도록 기존 Google Workspace 부가기능을 확장하는 경우 Chat 앱의 다음 구성 요구사항을 고려하세요.
- Google Workspace Marketplace 설치 설정에서 개인과 Google Workspace 관리자 모두 부가기능을 설치할 수 있도록 허용해야 합니다.
- 애드온의 매니페스트 (
addons.common)에 있는 일반적인 구성 설정은 Chat에서 무시됩니다. Chat에서 작동하도록 부가기능을 구성하려면 Chat API를 사용 설정하고 구성해야 합니다. 단계는 Google Chat API 구성을 참고하세요. - Chat에서 부가기능을 배포하고 테스트하려면 Chat API의 공개 상태 설정을 사용해야 합니다. Google Workspace Marketplace SDK에서 구성한 공개 상태 또는 테스트 설정은 무시됩니다. Chat에 테스트 버전의 부가기능을 배포하려면 Google Chat 앱의 대화형 기능 테스트하기를 참고하세요.
- 부가기능이 Google Workspace Marketplace에 게시된 경우 Google Chat API 구성 설정의 변경사항 초안을 저장할 수 없습니다. Chat API 구성 설정을 업데이트하면 업데이트된 채팅 앱을 모든 기존 사용자가 즉시 사용할 수 있습니다. 마켓플레이스 등록정보를 업데이트하려면 변경사항을 제출하기 전에 초안을 만드세요.
관련 주제
부가기능이 아닌 Chat 앱: 대화형 Google Chat 앱 빌드
Google Workspace 부가기능이 아닌 채팅 앱은 Google Workspace 부가기능 이벤트 객체 (EventObject) 및 작업 대신 Chat API 상호작용 이벤트 (Event)를 수신하는 채팅 전용 앱으로 빌드됩니다.
부가기능이 아닌 Chat 앱을 유지하는 경우 다음 작업을 할 수 있습니다.
- 부가기능이 아닌 채팅 앱을 Google Chat을 확장하는 Google Workspace 부가기능으로 변환하세요. Google Chat 앱을 Google Workspace 부가기능으로 변환하기를 참고하세요.
- 요청 및 응답 형식은 이 문서 세트의 각 대화형 기능 가이드 하단에 있는 펼칠 수 있는 부가기능이 아닌 채팅 앱 섹션을 참고하세요.