이 튜토리얼에서는 다음 작업을 수행하는 Google Chat 앱을 만드는 방법을 보여줍니다. 사고에 실시간으로 대응할 수 있습니다 사고에 대응할 때 앱은 Chat 스페이스를 만들어 채우며 이슈를 촉진 메시지, 슬래시 명령어, 대화상자를 사용해 문제를 해결하고 AI를 사용하여 사고 대응을 문서화합니다
이슈는 팀의 즉각적인 주의가 필요한 사건입니다. 해결할 수 있습니다. 이슈의 예는 다음과 같습니다.
- 고객 관계 관리 (CRM)에서 시간에 민감한 케이스가 생성됨 서비스팀이 협력하여 해결 방법을 찾아야 하는 경우가 많습니다
- 시스템이 오프라인으로 전환되어 사이트 안정성 엔지니어 (SRE) 그룹에 경고 그들이 함께 작업하여 온라인에 다시 게재할 수 있습니다.
- 강한 지진이 발생하여 긴급 구조원이 필요한 상황은 사용하여 대응을 조율할 수 있습니다.
이 튜토리얼에서는 누군가가 웹 페이지에서 버튼을 클릭하여 침해 사고를 보고합니다. 웹페이지는 사용자에게 기본 사고 정보(제목, 설명 및 응답자의 이메일 주소가 포함됩니다.
이슈 관리 채팅 앱의 작동 방식을 확인하세요.
-
그림 1. 누군가가 사고를 신고할 수 있는 웹사이트입니다. -
그림 2. Chat 스페이스가 생성되었다는 알림 -
그림 3. 이슈 대응 Chat 공간 -
그림 4. 슬래시 명령어로 이슈를 해결합니다. -
그림 5. 이슈 해결 대화상자 -
그림 6. 이슈 해결 Google Docs 문서가 스페이스에서 공유됩니다. -
그림 7. AI 요약 이슈 해결 Google Docs 문서
기본 요건
조직에 이러한 기본 요건을 사용 설정해야 하는 경우 Google Workspace 관리자가 사용 설정하려면 다음 안내를 따르세요.
- 비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
- 갖기 위해 디렉터리 (연락처 공유)가 Google Workspace에 사용 설정되어 있습니다. 이슈 앱은 해당 디렉터리에 있는 이슈 대응자의 연락처 정보(예: 이름) 이메일 주소가 필요합니다. 이슈 대응자는 Google Chat 사용자여야 합니다. 계정에 액세스할 수 있습니다
목표
- 이슈에 대응하는 채팅 앱을 빌드합니다.
- 다음을 수행하여 사용자가 이슈에 대응할 수 있도록 지원합니다.
<ph type="x-smartling-placeholder">
- </ph>
- 이슈 대응 공간 생성.
- 사고 및 대응을 요약한 메시지 게시
- 대화형으로 공동작업 지원 채팅 앱 기능
- Vertex AI를 사용해 대화와 해결 방법을 요약합니다.
아키텍처
다음 다이어그램은 Google Workspace 및 이슈 대응에 사용되는 Google Cloud 리소스 Google Chat 앱
아키텍처는 침해 사고 대응이 어떻게 Google Chat 앱에서 사고 및 해결 방법을 처리합니다.
사용자가 다음에서 호스팅되는 외부 웹사이트에서 이슈를 시작함 Apps Script
웹사이트는 비동기 HTTP 요청을 Apps Script에서 호스팅되는 Google Chat 앱
이슈 대응 Google Chat 앱은 다음과 같이 요청을 처리합니다.
Apps Script Admin SDK 서비스에 팀원이 추가됨 사용자 ID 및 이메일 주소와 같은 정보를 수집합니다.
다음을 사용하여 Chat API에 대한 HTTP 요청 집합 Apps Script 고급 채팅 서비스를 사용하면 침해 사고 대응 Google Chat 앱에서 이슈 Chat 생성 스페이스에 팀원을 채우고 스페이스에 메시지를 보냅니다.
팀원이 Chat 스페이스에서 이슈에 대해 토론합니다.
팀원이 슬래시 명령을 호출하여 있습니다
Apps Script를 사용하여 Chat API에 대한 HTTP 호출 고급 채팅 서비스에 모든 채팅 목록이 표시됨 스페이스의 메시지로 이동합니다.
Vertex AI가 나열된 메시지를 수신하고 요약을 생성합니다.
Apps Script
DocumentApp
서비스는 Docs 문서를 작성하고 Vertex AI의 요약을 문서를 참조하세요.Google Chat 앱이 호출하는 이슈 대응 Chat API에서 요약 링크를 공유하는 메시지를 전송합니다. Docs 문서입니다.
환경 준비
이 섹션에서는 Google Cloud 프로젝트를 만들고 구성하는 방법을 보여줍니다. 채팅 앱
Google Cloud 프로젝트 만들기
Google Cloud 콘솔
- Google Cloud 콘솔에서 메뉴 > IAM 및 관리자 > 프로젝트 만들기를 클릭합니다. 로 이동합니다.
-
프로젝트 이름 필드에 프로젝트를 설명하는 이름을 입력합니다.
선택사항: 프로젝트 ID를 수정하려면 수정을 클릭합니다. 프로젝트 ID는 변경할 수 없습니다. 따라서 수명 주기 동안 필요에 맞는 ID를 선택하세요. 살펴보겠습니다
- 위치 입력란에서 찾아보기를 클릭하여 내 비즈니스의 예상 위치를 표시합니다. 살펴보겠습니다 그런 다음 선택을 클릭합니다. <ph type="x-smartling-placeholder">
- 만들기를 클릭합니다. Google Cloud 콘솔이 대시보드 페이지로 이동하고 프로젝트가 생성됩니다. 몇 분 이내에 다시 시작할 수 있습니다.
gcloud CLI
다음 개발 환경 중 하나에서 Google Cloud CLI (`gcloud`):
-
Cloud Shell: gcloud CLI로 온라인 터미널 사용
설정되어 있다면 Cloud Shell을 활성화합니다
Cloud Shell 활성화 -
로컬 셸: 로컬 개발 환경을 사용하려면
install 및
초기화
gcloud CLI에 연결할 수 있습니다
Cloud 프로젝트를 만들려면 `gcloud projects create`명령어를 사용합니다.gcloud projects create PROJECT_ID
Cloud 프로젝트에 결제 사용 설정
<ph type="x-smartling-placeholder">Google Cloud 콘솔
- Google Cloud 콘솔에서 결제로 이동합니다. 클릭 메뉴 > 결제 > 내 프로젝트를 클릭합니다.
- 조직 선택에서 Google Cloud 프로젝트에 액세스할 수 있습니다
- 프로젝트 행에서 작업 메뉴를 엽니다. ( ), 결제 변경을 클릭하고 Cloud Billing 계정
- 계정 설정을 클릭합니다.
gcloud CLI
- 사용 가능한 결제 계정을 나열하려면 다음을 실행합니다.
gcloud billing accounts list
- 결제 계정을 Google Cloud 프로젝트에 연결합니다.
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
다음을 바꿉니다.
PROJECT_ID
는 다음 프로젝트의 프로젝트 ID입니다. 결제를 사용 설정할 Cloud 프로젝트입니다.BILLING_ACCOUNT_ID
는 연결할 결제 계정 ID입니다. Google Cloud 프로젝트입니다
API 사용 설정
Google Cloud 콘솔
Google Cloud 콘솔에서 Google Chat API, Google Docs API, Admin SDK API, Vertex AI API입니다
올바른 Cloud 프로젝트에서 선택한 후 다음을 클릭합니다.
올바른 API를 사용 설정했는지 확인한 다음 사용 설정을 클릭합니다.
gcloud CLI
필요한 경우 현재 Cloud 프로젝트를 생성한 프로젝트로 설정합니다.
gcloud config set project
명령어를 사용하여 다음을 실행합니다.gcloud config set project PROJECT_ID
PROJECT_ID을 프로젝트 ID로 Cloud 프로젝트입니다
Google Chat API, Google Docs API, Admin SDK API, Vertex AI API 사용 설정
gcloud services enable
명령어를 사용하여 다음을 실행합니다.gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
인증 및 승인 설정
인증 및 승인을 통해 Google Workspace의 채팅 앱 액세스 리소스 Google Cloud를 사용하여 이슈 대응을 처리합니다
이 튜토리얼에서는 앱을 내부적으로 게시하므로 자리표시자를 사용해도 괜찮습니다. 확인할 수 있습니다 앱을 외부에 게시하기 전에 자리표시자를 교체하세요. 실제 정보가 포함된 동의 화면을 표시합니다.
Google Cloud 콘솔에서 다음으로 이동합니다. 메뉴 > API 및 서비스 > OAuth 동의 화면으로 이동합니다.
사용자 유형에서 내부를 선택한 다음 만들기를 클릭합니다.
앱 이름에
Incident Management
를 입력합니다.사용자 지원 이메일에서 내 이메일 주소 또는 적절한 주소를 선택합니다. Google 그룹
개발자 연락처 정보에 이메일 주소를 입력합니다.
저장하고 계속하기를 클릭합니다.
범위 추가 또는 삭제를 클릭합니다. 범위 목록이 포함된 패널이 표시됨 .
수동으로 범위 추가 아래에 다음 범위를 붙여넣습니다.
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
테이블에 추가를 클릭합니다.
Update를 클릭합니다.
저장하고 계속하기를 클릭합니다.
앱 등록 요약을 검토한 후 대시보드로 돌아가기를 클릭합니다.
채팅 앱 만들기 및 배포
다음 섹션에서는 필요한 모든 애플리케이션이 포함된 Apps Script 프로젝트 채팅 앱에 사용할 수 있으므로 복사해서 붙여넣을 필요가 없습니다. 각 파일을 붙여넣습니다
다음과 같이 일부 함수에는 이름 끝에 밑줄이 포함됩니다.
ChatApp.gs
의 processSlashCommand_()
입니다. 밑줄은 함수
인시던트 초기화 웹 페이지에서 인코더-디코더를 제거합니다. 자세한 내용은
자세한 내용은
비공개 함수.
Apps Script는 .gs
스크립트와 .html
라는 두 가지 파일 형식을 지원합니다.
할 수 있습니다. 이 지원을 준수하기 위해 앱의 클라이언트 측 JavaScript가 포함됩니다.
<script />
태그 내부에 있고 해당 CSS는 내부 <style />
태그 내에 포함됩니다.
있습니다.
원하는 경우 GitHub에서 전체 프로젝트를 볼 수 있습니다.
다음은 각 파일의 개요입니다.
Consts.gs
다른 코드 파일에서 참조하는 상수 정의 Cloud 프로젝트 ID, Vertex AI 위치 ID, 슬래시 명령어 ID를 사용하는 것이 좋습니다
Consts.gs
코드 보기ChatApp.gs
다음을 포함한 Chat 상호작용 이벤트 처리 메시지, 카드 클릭, 슬래시 명령 및 대화상자가 포함됩니다. 다음에 응답:
/closeIncident
슬래시 명령어(대화상자를 열어 이슈 수집) 해결 세부정보를 확인하세요. 다음을 호출하여 스페이스의 메시지를 읽습니다. Chat API의spaces.messages.list
메서드 Admin SDK 디렉터리 서비스를 사용하여 사용자 ID를 가져옵니다. Apps ScriptChatApp.gs
코드 보기ChatSpaceCreator.gs
사용자가 이슈에 입력한 양식 데이터 수신 이를 사용하여 Chat을 만든 다음 '공간'에 대한 메시지를 게시하여 있습니다
ChatSpaceCreator.gs
코드 보기DocsApi.gs
Google Docs API를 호출하여 사용자의 Google Drive에 돌아가 이슈 정보의 요약을 작성한 생성된 파일을
VertexAiApi.gs
문서에 추가합니다.DocsApi.gs
코드 보기VertexAiApi.gs
Chat의 대화를 요약합니다. Vertex AI를 사용하여 ML 모델을 빌드할 수 있습니다 이 요약은 특별히 만든
DocsAPI.gs
문서VertexAiApi.gs
코드 보기WebController.gs
이슈 초기화 웹사이트를 제공합니다.
WebController.gs
코드 보기Index.html
이슈 초기화 웹사이트를 구성하는 HTML입니다.
Index.html
코드 보기JavaScript.html
양식 동작 처리(예: 제출, 오류를 확인하고 삭제합니다. 포함되어 있습니다
WebController.gs
의 맞춤include
함수를 통해Index.html
로 변환합니다.JavaScript.html
코드 보기Stylesheet.html
이슈 초기화 웹사이트의 CSS입니다. 그것은 맞춤
include
함수에 의해Index.html
에 포함됨WebController.gs
입니다.Stylesheet.html
코드 보기
Cloud 프로젝트 번호 및 ID 찾기
Google Cloud 콘솔에서 Cloud 프로젝트로 이동합니다.
설정 및 유틸리티를 클릭합니다. > 프로젝트 설정으로 이동합니다.
프로젝트 번호 및 프로젝트 ID 필드의 값을 확인합니다. 나 다음 섹션에서 사용하세요
Apps Script 프로젝트 만들기
Apps Script 프로젝트를 만들어 Cloud 프로젝트:
- 다음 버튼을 클릭하여 Google Chat으로 이슈에 대응 Apps Script 프로젝트를 엽니다.
프로젝트 열기 - Overview(개요)를 클릭합니다.
- 개요 페이지에서
사본 만들기를 클릭합니다.
Apps Script 프로젝트 사본의 이름을 지정합니다.
Copy of Incident to 사고 with Google Chat(Google Chat으로 이슈에 대응하기의 사본)을 클릭합니다.
프로젝트 제목에
Incident Management Chat app
를 입력합니다.이름 바꾸기를 클릭합니다.
Apps Script 프로젝트 사본에서
Consts.gs
으로 이동합니다. 파일의 ID로 시작하고YOUR_PROJECT_ID
를 Cloud 프로젝트입니다.
Apps Script 프로젝트의 Cloud 프로젝트 설정
- Apps Script 프로젝트에서
프로젝트 설정을 클릭합니다.
- Google Cloud Platform(GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
- GCP 프로젝트 번호에 Cloud 프로젝트의 프로젝트 번호를 붙여넣습니다.
- 프로젝트 설정을 클릭합니다. Cloud 프로젝트 및 Apps Script 프로젝트가 연결되었습니다.
Apps Script 배포 만들기
이제 모든 코드가 준비되었으므로 Apps Script를 배포합니다. 살펴보겠습니다 배포 ID는 Google Cloud의 채팅 앱
Apps Script에서 이슈 대응 앱의 프로젝트를 엽니다.
배포를 클릭합니다. 새 배포.
부가기능 및 웹 앱을 아직 선택하지 않은 경우 유형 선택, 배포 유형
을 차례로 클릭한 다음, 부가기능 및 웹 앱을 선택합니다.
설명에 이 버전에 대한 설명을 입력합니다. 예를 들면 다음과 같습니다.
Complete version of incident management app
입니다.다음으로 실행에서 웹 앱에 액세스하는 사용자를 선택합니다.
액세스 권한이 있는 사용자에서 Workspace 조직 내 모든 사용자를 선택합니다. 여기에서 'Workspace 조직'은 의 이름은 Google Workspace 조직입니다.
배포를 클릭합니다. Apps Script 보고서 완료 배포 ID와 이슈의 URL을 제공합니다. 초기화해야 합니다
나중에 이슈가 시작될 때 방문할 수 있도록 웹 앱 URL을 기록해 둡니다. 배포 ID를 복사합니다. 이 ID는 Google Cloud 콘솔의 채팅 앱
완료를 클릭합니다.
Google Cloud 콘솔에서 채팅 앱 구성
이 섹션에서는 Google Cloud 콘솔에서 Google Chat API를 구성하는 방법을 보여줍니다. 다음과 같은 채팅 앱 관련 정보가 포함됩니다. Apps Script에서 방금 만든 배포의 ID입니다. 살펴보겠습니다
Google Cloud 콘솔에서 메뉴를 클릭합니다. <ph type="x-smartling-placeholder">> 제품 더보기 > Google Workspace > 제품 라이브러리 > Google Chat API > 관리 > 구성.
</ph>앱 이름에
Incident Management
를 입력합니다.아바타 URL에
https://developers.google.com/chat/images/quickstart-app-avatar.png
을 입력합니다.설명에
Responds to incidents.
를 입력합니다.양방향 기능 사용 설정 전환 버튼을 클릭하여 On(사용)으로 설정합니다.
기능에서 1:1 메시지 수신, 스페이스 및 그룹 대화 참여를 선택합니다.
연결 설정에서 Apps Script 프로젝트를 선택합니다.
배포 ID에 Apps Script 배포 ID를 붙여넣습니다. 이전에 Apps Script 프로젝트에서 복사한 배포할 수 있습니다
슬래시 명령어를 완전히 구현된 채팅 앱은 다음을 사용합니다.
슬래시 명령어에서 슬래시 명령어 추가를 클릭합니다.
이름에
/closeIncident
를 입력합니다.명령어 ID에
1
를 입력합니다.설명에 <ph type="x-smartling-placeholder">
Closes the incident being discussed in the space.
</ph>대화상자 열기를 선택합니다.
완료를 클릭합니다. 슬래시 명령어가 등록되고 나열됩니다.
공개 상태에서 Workspace 도메인을 클릭하고 이메일 주소를 입력합니다.
로그에서 Logging에 오류 로깅을 선택합니다.
저장을 클릭합니다. 구성에 저장된 메시지가 표시됩니다. 즉, 앱이 테스트할 수 있습니다
채팅 앱 테스트
이슈 관리 채팅 앱을 테스트하려면 다음을 시작하세요. 문제를 확인하고 채팅 앱이 예상대로 작동합니다.
Apps Script 배포 웹 앱 URL로 이동합니다.
Apps Script에서 데이터에 액세스할 권한을 요청하면 권한 검토를 클릭하고 적절한 Google 계정으로 로그인합니다. 허용을 클릭합니다.
이슈 초기화 웹페이지가 열립니다. 테스트 정보를 입력합니다.
- 이슈 제목에
The First Incident
를 입력합니다. - 필요한 경우 Incident Responseers(이슈 대응 담당자)에 도움을 받을 수 있습니다 해당 사용자는 반드시 Google Workspace 조직의 Google Chat 계정 또는 스페이스를 만들 수 없습니다. 본인의 이메일 주소는 입력하지 마세요. 자동으로 포함됩니다
- 초기 메시지에
Testing the incident management Chat app.
를 입력합니다.
- 이슈 제목에
Chat 스페이스 만들기를 클릭합니다.
creating space
메시지가 표시됩니다.스페이스가 생성되면
Space created!
메시지가 표시됩니다. 클릭 스페이스 열기: 새 탭에서 Chat의 스페이스를 엽니다.원하는 경우 관리자와 다른 이슈 대응자는 있습니다. 앱은 Vertex AI를 사용하여 이러한 메시지를 요약하고 소급 문서입니다.
사고 대응을 종료하고 해결 프로세스를 시작하려면 Chat 스페이스,
/closeIncident
를 입력합니다. 사고 관리 대화상자가 열립니다.이슈 종료에 이슈 해결에 대한 설명을 입력합니다. (예:
Test complete
)이슈 종료를 클릭합니다.
Incident Management 앱에서 스페이스의 메시지를 나열하고 요약함 Google Docs 문서에 요약을 붙여넣고 할 수 있습니다.
삭제
서비스 요금이 Google Cloud 계정에 청구되지 않도록 리소스 사용을 중단하려면 Cloud 프로젝트입니다.
-
Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다. 클릭
메뉴 > IAM 및 관리자
> 리소스 관리를 클릭합니다.
<ph type="x-smartling-placeholder"></ph> Resource Manager로 이동 를 통해 개인정보처리방침을 정의할 수 있습니다.
- 프로젝트 목록에서 삭제할 프로젝트를 선택한 후 를 삭제합니다.
- 대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭하여 삭제합니다. 프로젝트입니다
관련 주제
- Gemini AI Chat 앱을 통해 Chat 대화를 기반으로 한 질문에 답변하기
- Google Chat, Vertex AI, Firestore를 사용한 프로젝트 관리
- 이슈 대응 앱은 사용자 인증 정보로 인증하여 API를 호출합니다.
Chat API 및 Vertex AI API와 같은 Google Cloud 서비스를 호출할 수 있습니다.
즉, 이슈를 초기화하는 사용자는
제공합니다 앱을 더 견고하게 만들려면 Vertex AI API를 호출해 보세요.
사용자 인증 정보 대신 서비스 계정으로
/closeIncident
슬래시 명령어 서비스 계정 구성 관련 도움말 Vertex AI API에 관한 자세한 내용은 커스텀 서비스 계정 사용