이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Chat, Vertex AI, Firestore를 사용한 프로젝트 관리

이 튜토리얼에서는 팀이 사용할 수 있는 Google Chat 앱을 만드는 방법을 보여줍니다. 실시간으로 프로젝트를 관리하는 데 사용할 수 있습니다 Chat 앱은 이를 통해 팀이 사용자 스토리 (사용자 스토리)를 작성하는 데 사용자의 관점에서 팀이 개발할 수 있는 소프트웨어 시스템) Firestore 데이터베이스에 스토리를 유지합니다

그림 1. 찰리가 팀과 함께 Chat 스페이스의 기능 개발에 대해 논의합니다. 프로젝트 관리를 언급하면 채팅 앱에서 도움을 제공하라는 메시지가 표시됩니다.
그림 2. 찰리는 /createUserStory 슬래시 명령어를 사용하여 스토리를 만듭니다.
그림 3. 프로젝트 관리의 채팅 앱은 Vertex AI를 사용해 스토리 설명을 작성한 다음 스페이스에서 스토리를 공유합니다.
그림 4. 찰리는 수정을 클릭하여 스토리 세부정보를 마무리합니다. AI 설명은 정확하지만 찰리는 더 많은 세부정보를 원하므로 펼치기를 클릭하여 Vertex AI가 스토리 설명에 요구사항을 추가하도록 합니다. 찰리는 자신에게 스토리를 할당하고, 상태를 시작됨으로 설정하고, 적절한 우선순위와 크기를 선택한 다음 저장을 클릭합니다.
그림 5. 찰리는 언제든지 /manageUserStories 슬래시 명령어로 팀의 모든 사용자 스토리를 확인하고 관리할 수 있습니다.

기본 요건

비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
Google Cloud 서비스에 액세스하여 다음 작업을 수행할 수 있습니다.
- Google Cloud 프로젝트를 만듭니다.
- Google Cloud 결제 계정을 Cloud 프로젝트에 연결합니다. 받는사람 액세스 권한이 있는지 알아보려면 결제를 사용 설정하는 데 필요한 권한.
- 인증되지 않은 Google Cloud 함수 호출 사용 이는 Google Cloud 서비스 또는 조직에서 도메인 제한 공유를 사용합니다.
필요한 경우 Google Cloud 관리자에게 액세스 권한을 요청하거나 권한을 부여했는지 확인합니다.
Google Cloud CLI를 사용하는 경우 Node.js gcloud CLI와 함께 작동하도록 구성된 개발 환경 자세한 내용은 Node.js 개발 설정 환경을 참조하세요.

목표

민첩한 소프트웨어를 관리하는 채팅 앱 빌드 살펴보겠습니다
사용자가 생성형 AI를 통해 사용자 스토리를 작성하도록 지원 Vertex AI 기반의 AI 지원 스토리 작성 도구: <ph type="x-smartling-placeholder">
- 스토리 설명을 생성하고 재생성합니다.
- 메모에서 스토리 설명을 펼쳐 요구사항을 완료하세요.
- 문법을 수정하여 오타를 수정합니다.
Firestore 데이터베이스에 쓰고 읽어서 작업을 최신 상태로 유지합니다.
사용자가 Chat 스페이스에서 원활하게 협업할 수 있도록 대화에서 바로 스토리를 생성, 수정, 할당, 시작할 수 있습니다.

사용 제품

프로젝트 관리 앱은 다음 Google Workspace를 사용합니다. Google Cloud 제품:

Chat API: 다음을 수신하고 응답하는 Google Chat 앱을 개발하기 위한 API입니다. 채팅 상호작용 이벤트(예: 메시지) 프로젝트 관리 Google Chat 앱이 Chat API를 사용하여 수신 및 응답 채팅에서 전송된 상호작용 이벤트에 추가하고, 이름, 아바타 이미지 등 Chat에 표시되는 방식을 결정합니다.
Vertex AI API: 생성형 AI 플랫폼 프로젝트 관리 Vertex AI API를 사용하여 사용자 스토리를 작성하는 Google Chat 앱 선택할 수 있습니다
Firestore: 서버리스 문서 데이터베이스입니다. 프로젝트 관리 Google Chat 앱은 Firebase를 사용하여 사용자 스토리에 대한 데이터를 저장합니다.
Cloud Functions: 간단한 서버리스 컴퓨팅 서비스로, Chat에 응답할 수 있는 단일 목적의 독립형 기능 상호작용 이벤트를 생성할 수 있습니다. 이 프로젝트 관리 Google Chat 앱은 Cloud Functions를 사용하여 Chat이 상호작용 이벤트를 보내는 HTTP 엔드포인트를 컴퓨팅 플랫폼을 사용하여 이러한 이벤트를 처리하고 이에 응답하는 로직을 실행합니다.

Cloud Functions는 다음과 같은 Google Cloud 제품을 사용하여 상호작용 이벤트를 처리하고 컴퓨팅 리소스를 호스팅합니다.
- Cloud Build: 완전 관리형 지속적 통합, 배포, 배포 플랫폼 실행할 수도 있습니다
- Pub/Sub: 서비스를 분리하는 확장 가능한 비동기 메시징 서비스입니다. 생성하는 방법을 살펴봤습니다
- Cloud Run Admin API 컨테이너화된 앱 실행을 위한 완전 관리형 환경입니다.

아키텍처

프로젝트 관리 Google Chat 앱 아키텍처는 HTTP 엔드포인트에서 Chat 상호작용 이벤트를 처리하고 Vertex AI를 사용하여 사용자 스토리를 작성하고, Firestore 데이터베이스에 사용자 스토리 세부정보를 저장합니다. 이 다음 다이어그램은 Google Workspace 및 사용된 Google Cloud 리소스입니다.

프로젝트 관리 Google Chat 앱의 아키텍처 다이어그램

프로젝트 관리 Google Chat 앱은 다음과 같이 작동합니다.

사용자가 Chat에서 메시지를 보내고 Google Chat 앱에서 스페이스에서 언급하거나 슬래시 명령어를 입력할 수 있습니다.
Chat은 동기 HTTP 요청을 Cloud 함수의 HTTP 엔드포인트
프로젝트 관리 Google Chat 앱은 HTTP(S) 요청을 요청:
1. Vertex AI는 사용자 스토리를 작성하거나 업데이트하는 데 도움이 됩니다.
2. Firestore 데이터베이스는 사용자 스토리를 저장, 검색, 업데이트 또는 삭제합니다. 데이터를 수집하는 데 사용됩니다
Cloud Functions는 Chat에 HTTP 응답을 반환하며 메시지 또는 대화상자로 사용자에게 표시합니다.

환경 준비

이 섹션에서는 Google Cloud 프로젝트를 만들고 구성하는 방법을 보여줍니다. 채팅 앱

Google Cloud 프로젝트 만들기

Google Cloud 콘솔

Google Cloud 콘솔에서 메뉴 로 이동합니다. > IAM 및 관리자 > 프로젝트 만들기를 클릭합니다.
프로젝트 만들기로 이동
프로젝트 이름 필드에 프로젝트를 설명하는 이름을 입력합니다.
선택사항: 프로젝트 ID를 수정하려면 수정을 클릭합니다. 프로젝트 ID는 변경할 수 없습니다. 따라서 수명 주기 동안 필요에 맞는 ID를 선택하세요. 살펴보겠습니다
위치 입력란에서 찾아보기를 클릭하여 내 비즈니스의 예상 위치를 표시합니다. 살펴보겠습니다 그런 다음 선택을 클릭합니다. <ph type="x-smartling-placeholder">
</ph> 주의: Google Workspace 조직을 찾을 수 없나요?
이는 Google Workspace 계정에 로그인하지 않았음을 의미합니다. 몇 가지 기능 Google Workspace 개발자 문서에 설명된 작업은 프로젝트에서만 사용할 수 있습니다. 조직과 관련이 있습니다
만들기를 클릭합니다. 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
```
드림 만들려는 프로젝트의 ID를 설정하여 PROJECT_ID를 바꿉니다.

Cloud 프로젝트에 결제 사용 설정

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, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API Pub/Sub API, Cloud Run Admin API입니다

API 사용 설정
올바른 Cloud 프로젝트에서 선택한 후 다음을 클릭합니다.
올바른 API를 사용 설정했는지 확인한 다음 사용 설정을 클릭합니다.

gcloud CLI

필요한 경우 현재 Cloud 프로젝트를 gcloud config set project 명령어로 생성됩니다.
```
gcloud config set project PROJECT_ID
```
PROJECT_ID을 프로젝트 ID로 Cloud 프로젝트입니다
Google Chat API, Vertex AI API, Cloud Functions API를 사용 설정합니다. Firestore API, Cloud Build API, Pub/Sub API, gcloud services enable 명령어로 Cloud Run Admin API를 실행합니다.
```
gcloud services enable chat.googleapis.com \
aiplatform.googleapis.com \
cloudfunctions.googleapis.com \
firestore.googleapis.com \
cloudbuild.googleapis.com \
pubsub.googleapis.com \
run.googleapis.com
```
Cloud Build, Pub/Sub, Cloud Run Admin API는 Cloud Functions가 있습니다

인증 및 승인

이를 수행하기 위해 인증 및 승인 구성이 필요하지 않습니다. 튜토리얼을 확인하세요.

Firestore 및 Vertex AI API를 호출하기 위해 이 튜토리얼에서는 다음을 사용합니다. 애플리케이션 기본 사용자 인증 정보 Cloud 함수에 연결된 기본 서비스 계정으로 바꿉니다. 설정할 필요가 없습니다. 프로덕션 환경에서는 일반적으로 만들기 및 첨부 Cloud 함수에 서비스 계정을 대신 연결할 수 있습니다.

Google Chat 앱 만들기 및 배포하기

이제 Google Cloud 프로젝트를 만들고 구성했으므로 빌드할 수 있습니다. Google Chat 앱을 배포합니다 이 섹션에서는 있습니다.

사용자 스토리를 유지하고 가져올 Firestore 데이터베이스를 만듭니다.
필요한 경우 샘플 코드를 검토합니다.
다음을 호스팅하고 실행할 Cloud 함수를 만듭니다. 이벤트에 대한 응답의 채팅 앱 코드 채팅에서 HTTP 요청으로 수신됩니다
Google Chat API에서 Google Chat 앱 만들기 및 배포 구성 페이지로 이동합니다

Firestore 데이터베이스 만들기

이 섹션에서는 유지하고 검색할 Firestore 데이터베이스를 만듭니다. 데이터 모델을 정의하지는 않습니다. 데이터 모델은 model/user-story.js 및 model/user.js에 의해 샘플 코드에 암시적으로 할 수 있습니다.

프로젝트 관리 채팅 앱 데이터베이스는 NoSQL을 사용합니다. 기반으로 하는 문서 개 구성 방식 컬렉션을 비교할 수 있습니다. 자세한 내용은 Firestore 데이터 모델.

다음 다이어그램은 프로젝트 관리의 개요입니다. Google Chat 앱의 데이터 모델:

Firestore 데이터베이스의 데이터 모델입니다.

루트 컬렉션은 spaces이며, 여기서 각 문서는 스토리를 만든 채팅 앱 각 사용자 스토리는 userStories 하위 컬렉션의 문서로 표현되며, 각 사용자는 users 하위 컬렉션의 문서로 표현됩니다.

컬렉션, 문서, 필드 정의 보기

`spaces`

Chat 앱에서 스토리를 만든 스페이스

필드
`Document ID`	`String` 스토리가 생성된 특정 스페이스의 고유 ID입니다. Chat API의 스페이스 리소스 이름에 해당합니다.
`userStories`	`Subcollection of Documents (userStories)` 채팅 앱 및 사용자가 만든 스토리 Firebase에서 `userStories`의 `Document ID`에 해당합니다.
`users`	`Subcollection of Documents (user)` 스토리를 만들었거나 할당된 사용자
`displayName`	`String` Chat API에서 스페이스의 표시 이름입니다. 사용자와의 채팅 메시지에는 설정되지 않습니다.

`userStories`

채팅 앱 및 사용자가 만든 스토리입니다.

필드
`Document ID`	`String` 채팅 앱 및 해당 사용자가 생성한 특정 사용자 스토리의 고유 ID입니다.
`assignee`	`Document (user)` 스토리 완료를 위해 할당된 사용자의 리소스 이름입니다. `users` 문서의 `Document ID` 및 Chat API의 사용자 리소스 이름에 상응합니다.
`description`	`String` 사용자의 관점에서 소프트웨어 기능에 대한 설명
`priority`	`Enum` 작업을 완료해야 하는 긴급성 가능한 값은 `Low`, `Medium` 또는 `High`입니다.
`size`	`Enum` 업무의 양 가능한 값은 `Small`, `Medium` 또는 `Large`입니다.
`status`	`Enum` 작업 단계. 가능한 값은 `OPEN`, `STARTED` 또는 `COMPLETED`입니다.
`title`	`String` 스토리 제목 요약해 보겠습니다

`users`

스토리를 만들었거나 할당된 사용자

필드
`Document ID`	`String` 특정 사용자의 고유 ID입니다. Firebase의 `userStories` `assignee` 및 Chat API의 사용자 리소스 이름에 상응합니다.
`avatarUrl`	`String` 사용자의 채팅 아바타 이미지를 호스팅하는 URL입니다.
`displayName`	`String` 사용자의 Chat 표시 이름입니다.

Firestore 데이터베이스를 만드는 방법은 다음과 같습니다.

Google Cloud 콘솔

Google Cloud Console에서 Firestore로 이동합니다. 클릭 메뉴 > Firestore

Firestore로 이동
데이터베이스 만들기를 클릭합니다.
Firestore 모드 선택에서 Native 모드를 클릭합니다.
계속을 클릭합니다.
데이터베이스를 구성합니다.
1. 데이터베이스 이름 지정에서 데이터베이스 ID를 (default)로 둡니다.
2. 위치 유형에서 데이터베이스의 리전을 지정합니다(예: us-central1입니다. 최상의 성능을 위해 동일하거나 가까운 옵션을 선택하세요. 채팅 앱의 Cloud 함수로 사용합니다.
데이터베이스 만들기를 클릭합니다.

gcloud CLI

다음 명령어로 기본 모드로 Firestore 데이터베이스를 만듭니다. gcloud firestore databases create 명령어:
```
gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native
```
LOCATION을 Firestore의 이름으로 바꿉니다. 리전(예: us-central1 형식으로.

샘플 코드 검토

필요한 경우 Cloud 함수를 만들기 전에 잠시 시간을 내어 GitHub에 호스팅된 샘플 코드에 익숙해지세요.

GitHub에서 보기

다음은 각 파일의 개요입니다.

env.js: 배포할 환경 구성 변수 채팅 앱을 지정된 Google Cloud 프로젝트에 연결합니다. 리전으로 나뉩니다 이 파일에서 구성 변수를 업데이트해야 합니다.
package.json 및 package-lock.json: Node.js 프로젝트 설정 및 종속 항목
index.js: 채팅 앱의 Cloud 함수의 진입점입니다. 그것은 읽기 채팅 이벤트: 앱 핸들러를 호출하고 HTTP 응답을 JSON 객체입니다.
controllers/app.js: 기본 애플리케이션 로직. 처리 상호작용 이벤트의 응답을 처리하여 채팅 앱 멘션 및 슬래시 명령어 카드 클릭에 응답하기 위해 app-action-handler.js를 호출합니다.
controllers/app-action-handler.js: 카드 클릭을 처리하는 애플리케이션 로직 채팅 상호작용 이벤트.
services/space-service.js, services/user-service.js, services/user-story-service.js: 이 파일에는 Chat 스페이스 작업과 관련된 애플리케이션 로직 사용자 스토리가 포함됩니다 이러한 파일의 함수는 app.js에서 호출합니다. 또는 app-action-handler.js. 데이터베이스 작업을 수행하기 위해 이러한 파일은 firestore-service.js에서 함수를 호출합니다.
services/firestore-service.js: 데이터베이스 작업을 처리합니다. 이 파일의 함수는 services/space-service.js, services/user-service.js 외 services/user-story-service.js입니다.
services/aip-service.js: 생성형 AI 텍스트에 대해 Vertex AI API를 호출합니다. 살펴보겠습니다
model/*.js: 이 파일에는 애플리케이션이 사용하는 클래스 및 enum에 대한 정의가 포함되어 있습니다. 서비스 간에 데이터를 저장하고 함수 간에 전달하는 데 사용하는 서비스입니다. 이들은 Firestore 데이터베이스용 데이터 모델
views/*.js: 이 디렉터리의 각 파일은 카드 객체를 그러면 채팅 앱이 다음 형식으로 Chat에 다시 전송합니다. 카드 메시지 또는 대화상자 작업 응답을 반환합니다.
views/widgets/*.js: 각 파일은 widget의 유형 앱이 views/ 디렉터리에 카드를 빌드하는 데 사용하는 객체입니다.
test/**/*.test.js: 이 디렉터리와 하위 디렉터리의 각 파일에는 단위 테스트가 포함되어 있습니다. 를 사용해야 합니다. npm run test를 실행하여 모든 단위 테스트를 실행할 수 있습니다. 프로젝트 루트 디렉터리입니다

Cloud 함수 만들기 및 배포

이 섹션에서는 프로젝트 관리 채팅 앱의 애플리케이션 로직입니다.

Cloud 함수가 응답으로 실행됩니다. 채팅이 포함된 Chat의 HTTP 요청에 상호작용 이벤트입니다. 실행되면 Cloud 함수 코드는 이벤트를 처리하고 는 Chat이 또는 기타 유형의 사용자 상호작용을 포함할 수 있습니다. 해당하는 경우 이 함수는 Firestore 데이터베이스에서 읽거나 Firestore 데이터베이스에 씁니다.

Cloud 함수를 만드는 방법은 다음과 같습니다.

Google Cloud 콘솔

GitHub에서 코드를 ZIP 파일로 다운로드합니다.

zip 파일 다운로드
다운로드한 zip 파일의 압축을 풉니다.

추출된 폴더에는 전체 Google Workspace 샘플이 포함되어 있습니다. 저장소
추출된 폴더에서 다음으로 이동합니다. google-chat-samples-main/node/project-management-app/ 후 압축 project-management-app 폴더를 ZIP 파일로 만듭니다.

ZIP 파일의 루트 디렉터리에는 파일 및 폴더:
- env.js
- README.md
- gcloudignore.text
- package-lock.json
- package.json
- index.js
- model/
- controllers/
- views/
- services/
Google Cloud 콘솔에서 Cloud Functions 페이지로 이동합니다.

Cloud Functions로 이동

프로젝트의 Google Cloud 프로젝트가 채팅 앱이 선택되었습니다.
함수 만들기를 클릭합니다.
함수 만들기 페이지에서 함수를 설정합니다.
1. 환경에서 2세대를 선택합니다.
2. 함수 이름에 project-management-tutorial를 입력합니다.
3. 리전에서 리전을 선택합니다.
4. 인증에서 다음을 선택합니다. 인증되지 않은 호출을 허용합니다.
5. 다음을 클릭합니다.
런타임에서 Node.js 20을 선택합니다.
진입점에서 기본 텍스트를 삭제하고 다음을 입력합니다. projectManagementChatApp입니다.
소스 코드에서 Zip 업로드를 선택합니다.
대상 버킷에서 만들기 또는 버킷을 선택합니다.
1. 탐색을 클릭합니다.
2. 버킷을 선택합니다.
3. 선택을 클릭합니다.
Google Cloud가 ZIP 파일을 구성요소 파일에 업로드하고 이를 추출합니다. 이 버킷에 들어갑니다 그러면 Cloud Functions가 구성요소 파일을 살펴보겠습니다
Zip 파일에 GitHub에서 다운로드한 ZIP 파일을 업로드합니다. 다시 압축됩니다.
1. 탐색을 클릭합니다.
2. ZIP 파일로 이동하여 선택합니다.
3. 열기를 클릭합니다.
배포를 클릭합니다.

Cloud Functions 세부정보 페이지가 열리고 함수가 표시됩니다. 두 개의 진행률 표시기가 있습니다. 하나는 빌드이고 다른 하나는 서비스입니다. 두 진행률 표시기가 모두 사라지고 체크표시로 바뀐 경우 함수가 배포되고 준비되었습니다.
샘플 코드를 수정하여 상수를 설정합니다.
1. Cloud 함수 세부정보 페이지에서 수정을 클릭합니다.
2. 다음을 클릭합니다.
3. 소스 코드에서 인라인 편집기를 선택합니다.
4. 인라인 편집기에서 env.js 파일을 엽니다.
5. project-id를 Cloud 프로젝트 ID로 바꿉니다.
6. 선택사항: us-central1를 지원되는 위치 볼 수 있습니다
배포를 클릭합니다.
함수 배포가 완료되면 트리거 URL을 복사합니다.
1. 함수 세부정보 페이지에서 트리거를 클릭합니다.
2. URL을 복사합니다. 이 파일은 포드의 채팅 앱에 대해 자세히 알아보세요.

gcloud CLI

GitHub에서 코드를 클론합니다.

git clone https://github.com/googleworkspace/google-chat-samples.git

이 프로젝트의 코드가 있는 디렉터리로 전환합니다. 관리 채팅 앱:
```
cd google-chat-samples/node/project-management-app
```
env.js 파일을 수정하여 환경 변수를 설정합니다.
1. project-id를 Google Cloud 프로젝트 ID로 바꿉니다.
2. us-central1를 Google Cloud 프로젝트 위치로 바꿉니다.

Google Cloud에 Cloud 함수를 배포합니다.

gcloud functions deploy project-management-tutorial \
--gen2 \
--region=REGION \
--runtime=nodejs20 \
--source=. \
--entry-point=projectManagementChatApp \
--trigger-http \
--allow-unauthenticated

REGION를 Cloud 함수 위치 인프라가 호스팅되는 위치(예: us-central1)

함수 배포가 완료되면 url 속성을 있습니다. 이 URL은 다음 섹션에서 Google Chat 앱을 구성할 수 있습니다

Google Cloud 콘솔에서 Google Chat 앱 구성

이 섹션에서는 채팅 앱에 대한 정보가 포함된 Google Cloud 콘솔 채팅 앱 이름, 지원되는 슬래시 포함 명령어, 채팅 앱 클라우드의 트리거 URL 채팅 상호작용 이벤트를 전송하는 함수입니다.

Google Cloud 콘솔에서 메뉴를 클릭합니다. <ph type="x-smartling-placeholder"></ph> > 제품 더보기 > Google Workspace > 제품 라이브러리 > Google Chat API > 관리 > 구성.

Chat API 구성으로 이동
앱 이름에 Project Manager를 입력합니다.
아바타 URL에 https://developers.google.com/chat/images/quickstart-app-avatar.png을 입력합니다.
설명에 Manages projects with user stories.를 입력합니다.
양방향 기능 사용 설정 전환 버튼을 클릭하여 On(사용)으로 설정합니다.
기능에서 1:1 메시지 수신, 스페이스 및 그룹 대화 참여를 선택합니다.
연결 설정에서 앱 URL을 선택합니다.
앱 URL에 클라우드에서 복사한 트리거 URL을 붙여넣습니다. 함수 배포(형식: https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial입니다. gcloud CLI로 Cloud 함수를 배포한 경우 url입니다. 속성

채팅 앱의 슬래시 명령어 슬래시 명령어를 등록하려면 다음 안내를 따르세요.

슬래시 명령어에서 슬래시 명령어 추가를 클릭합니다.

다음 표에 설명된 각 슬래시 명령어에 대해 이름, 명령어 ID, 설명을 입력하고 슬래시 명령어 대화상자 열기를 입력한 후 완료를 클릭합니다.

이름	명령어 ID	설명	대화상자 열기
`/createUserStory`	1	지정된 제목으로 스토리를 만듭니다.	선택 해제됨
`/myUserStories`	2	사용자에게 할당된 모든 스토리를 나열합니다.	선택 해제됨
`/userStory`	3	지정된 스토리의 현재 상태를 표시합니다.	선택 해제됨
`/manageUserStories`	4	스토리를 수정할 수 있는 대화상자가 열립니다.	선택됨
`/cleanupUserStories`	5	스페이스의 모든 스토리를 삭제합니다.	선택 해제됨

공개 상태에서 Workspace 도메인으로 이동하여 내 이메일 주소를 입력합니다.
필요한 경우 로그에서 Logging에 오류 로깅을 선택합니다.
저장을 클릭합니다. 구성에 저장된 메시지가 표시됩니다. 즉, 채팅 앱 테스트할 수 있습니다

채팅 앱 테스트

메시지를 보내 프로젝트 관리 채팅 앱 테스트 슬래시 명령어를 사용하여 사용자 스토리를 생성, 수정, 삭제할 수 있습니다.

사용하는 Google Workspace 계정을 사용하여 Google Chat을 엽니다. 제공됩니다.

Google Chat으로 이동
새 채팅을 클릭합니다.
1명 이상 사용자 추가 입력란에 채팅 앱
검색 결과에서 채팅 앱을 선택합니다. 직접 메시지가 열립니다.

참고: 사용 중인 채팅 앱이 Google Workspace 계정이 Chat API 구성의 공개 상태 설정 페이지를 참조하세요.
앱과의 새 채팅 메시지에 Hello를 입력하고 enter 키를 누릅니다. 프로젝트 관리 채팅 앱에서 자세한 내용을 설명하는 도움말 메뉴로 응답합니다. 할 수 있습니다.
스토리를 만들려면 입력란에 /createUserStory Test story을(를) 입력하세요. 전송합니다. 프로젝트 관리 채팅 앱이 다음을 자세히 설명하는 카드 메시지로 응답합니다. Vertex AI의 생성형 AI를 사용하여 생성하는 사용자 스토리입니다
콘솔에서 Firestore 데이터베이스를 확인하여 내가 추가한 스페이스에 관해 생성된 기록 상호작용한 사용자를 생성한 사용자 스토리가 표시됩니다

Firestore로 이동
Google Chat으로 돌아갑니다.

Google Chat으로 이동
스토리를 수정하려면 수정을 클릭합니다. 다음에 만족할 때 저장을 클릭합니다.
앱에서 지원하는 각 슬래시 명령어를 테스트합니다. 확인하려면 /하거나 채팅 앱을 멘션합니다.
/cleanupUserStories를 실행하여 테스트 사용자 스토리를 삭제합니다. 사용할 수 있습니다 이와 달리 앱을 삭제하거나 제거합니다. 삭제하면 앱이 스페이스에서 생성된 모든 사용자 스토리를 삭제합니다.

문제 해결

Google Chat 앱 또는 card가 오류를 반환하는 경우 Chat 인터페이스에 '문제가 발생했습니다'라는 메시지가 표시됨 또는 '요청을 처리할 수 없습니다'와 같은 메시지가 표시됩니다. 채팅 UI가 오류 메시지가 표시되지 않지만 채팅 앱 또는 카드에서 예기치 않은 결과가 발생합니다. 예를 들어 카드 메시지가 나타납니다.

채팅 UI에 오류 메시지가 표시되지 않을 수도 있지만 오류 해결에 도움이 되는 오류 메시지 및 로그 데이터를 사용할 수 있음 채팅 앱의 오류 로깅이 사용 설정된 경우 보는 데 도움이 필요한 경우 오류를 수정하는 방법에 대한 자세한 내용은 Google Chat 오류 문제 해결하기

삭제

서비스 요금이 Google Cloud 계정에 청구되지 않도록 리소스 사용을 중단하려면 Cloud 프로젝트입니다.

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.

프로젝트의 모든 항목이 삭제됩니다. 이 튜토리얼의 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com의 URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내의 선택한 리소스만 삭제하세요.

여러 튜토리얼과 빠른 시작을 살펴보려는 경우 프로젝트를 재사용하면 프로젝트 할당량 한도 초과를 방지할 수 있습니다.

Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다. 클릭 메뉴 > IAM 및 관리자 > 리소스 관리를 클릭합니다.
<ph type="x-smartling-placeholder"></ph> Resource Manager로 이동 를 통해 개인정보처리방침을 정의할 수 있습니다.
프로젝트 목록에서 삭제할 프로젝트를 선택한 후 를 삭제합니다.
대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭하여 삭제합니다. 프로젝트입니다

Google Chat, Vertex AI, Firestore를 사용한 프로젝트 관리

기본 요건

목표

사용 제품

아키텍처

환경 준비

Google Cloud 프로젝트 만들기

Google Cloud 콘솔

gcloud CLI

Cloud 프로젝트에 결제 사용 설정

Google Cloud 콘솔

gcloud CLI

API 사용 설정

Google Cloud 콘솔

gcloud CLI

인증 및 승인

Google Chat 앱 만들기 및 배포하기

Firestore 데이터베이스 만들기

컬렉션, 문서, 필드 정의 보기

spaces

userStories

users

Google Cloud 콘솔

gcloud CLI

샘플 코드 검토

Cloud 함수 만들기 및 배포

Google Cloud 콘솔

gcloud CLI

Google Cloud 콘솔에서 Google Chat 앱 구성

채팅 앱 테스트

문제 해결

삭제

관련 주제

`spaces`

`userStories`

`users`