GSP929

개요

대부분의 비즈니스는 프로젝트 개발 및 프로덕션 주기의 다양한 단계를 거칩니다. 이러한 프로젝트를 효과적으로 유지보수하려면 버전과 환경을 관리하는 시스템과 프로세스가 필요합니다. 대화형 에이전트는 UI 내에서 여러 버전을 관리하고 특정 버전을 전용 환경에 로드할 수 있는 도구를 제공하므로 다양한 용도로(또한 다양한 팀에서) 사용할 수 있습니다. 이 실습에서는 대화형 에이전트 버전과 환경을 관리하는 방법을 살펴봅니다.

다음은 대화형 에이전트와 관련한 버전 및 환경의 정의입니다.

• 버전: 개발 주기가 끝나면 가상 에이전트를 동결하여 QA 주기를 거치고 나중에 프로덕션에 배포하는 것이 일반적입니다. 에이전트를 동결할 때마다 버전 번호와 설명이 포함된 에이전트 버전이 생성됩니다.
• 환경: 개발 주기 동안 여러 팀에서 서로 다른 버전에 액세스해야 할 수 있으며, 프로덕션의 경우 다음 업데이트가 있을 때까지 변경되지 않는 QA 버전이 필요합니다. 비즈니스 규모가 더 큰 경우 자체 가상 에이전트를 보유한 독립적인 비즈니스 부문이 있을 수도 있습니다. 다양한 환경을 만들고 각 팀에서 액세스해야 하는 버전을 로드할 수 있습니다. 기본적으로 에이전트에 대한 모든 변경사항이 대화형 에이전트 사용자 인터페이스를 사용하여 이루어지는 Draft라는 작업 환경이 있습니다. Draft 환경에서 수정한 가상 에이전트를 다른 환경에 로드하려면 먼저 해당 에이전트의 버전을 만들어야 합니다.

목표

이 실습의 목표는 다음과 같습니다.

• 가상 에이전트의 버전을 만듭니다.
• 가상 에이전트가 게시될 환경을 만듭니다.
• 저장된 가상 에이전트 버전을 환경에 로드합니다.
• 환경에 로드되는 버전을 변경합니다.

기본 요건

이 실습에서는 대화형 에이전트: 봇 빌드 기본사항에서 개발한 기본 Flight Booker 에이전트를 사용하며, 테스트 시뮬레이터 사용 방법과 인텐트, 흐름, 페이지의 작동 방식 등 대화형 에이전트에 대한 기본적인 지식이 있다고 가정합니다.

설정

실습 시작 버튼을 클릭하기 전에

다음 안내를 확인하세요. 실습에는 시간 제한이 있으며 일시중지할 수 없습니다. 실습 시작을 클릭하면 타이머가 시작됩니다. 이 타이머는 Google Cloud 리소스를 사용할 수 있는 시간이 얼마나 남았는지를 표시합니다.

실무형 실습을 통해 시뮬레이션이나 데모 환경이 아닌 실제 클라우드 환경에서 실습 활동을 진행할 수 있습니다. 실습 시간 동안 Google Cloud에 로그인하고 액세스하는 데 사용할 수 있는 새로운 임시 사용자 인증 정보가 제공됩니다.

이 실습을 완료하려면 다음을 준비해야 합니다.

• 표준 인터넷 브라우저 액세스 권한(Chrome 브라우저 권장)

참고: 이 실습을 실행하려면 시크릿 모드(권장) 또는 시크릿 브라우저 창을 사용하세요. 개인 계정과 학습자 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.

• 실습을 완료하기에 충분한 시간(실습을 시작하고 나면 일시중지할 수 없음)

참고: 이 실습에는 학습자 계정만 사용하세요. 다른 Google Cloud 계정을 사용하는 경우 해당 계정에 비용이 청구될 수 있습니다.

실습을 시작하고 Google Cloud 콘솔에 로그인하는 방법

1. 실습 시작 버튼을 클릭합니다. 실습 비용을 결제해야 하는 경우 결제 수단을 선택할 수 있는 대화상자가 열립니다. 왼쪽에는 다음과 같은 항목이 포함된 실습 세부정보 창이 있습니다.

   • Google Cloud 콘솔 열기 버튼
   • 남은 시간
   • 이 실습에 사용해야 하는 임시 사용자 인증 정보
   • 필요한 경우 실습 진행을 위한 기타 정보

2. Google Cloud 콘솔 열기를 클릭합니다(Chrome 브라우저를 실행 중인 경우 마우스 오른쪽 버튼으로 클릭하고 시크릿 창에서 링크 열기를 선택합니다).

   실습에서 리소스가 가동되면 다른 탭이 열리고 로그인 페이지가 표시됩니다.

   팁: 두 개의 탭을 각각 별도의 창으로 나란히 정렬하세요.

   참고: 계정 선택 대화상자가 표시되면 다른 계정 사용을 클릭합니다.

3. 필요한 경우 아래의 사용자 이름을 복사하여 로그인 대화상자에 붙여넣습니다.

   {{{user_0.username | "Username"}}}

   실습 세부정보 창에서도 사용자 이름을 확인할 수 있습니다.

4. 다음을 클릭합니다.

5. 아래의 비밀번호를 복사하여 시작하기 대화상자에 붙여넣습니다.

   {{{user_0.password | "Password"}}}

   실습 세부정보 창에서도 비밀번호를 확인할 수 있습니다.

6. 다음을 클릭합니다.

   중요: 실습에서 제공하는 사용자 인증 정보를 사용해야 합니다. Google Cloud 계정 사용자 인증 정보를 사용하지 마세요. 참고: 이 실습에 자신의 Google Cloud 계정을 사용하면 추가 요금이 발생할 수 있습니다.

7. 이후에 표시되는 페이지를 클릭하여 넘깁니다.

   • 이용약관에 동의합니다.
   • 임시 계정이므로 복구 옵션이나 2단계 인증을 추가하지 않습니다.
   • 무료 체험판을 신청하지 않습니다.

잠시 후 Google Cloud 콘솔이 이 탭에서 열립니다.

참고: Google Cloud 제품 및 서비스에 액세스하려면 탐색 메뉴를 클릭하거나 검색창에 제품 또는 서비스 이름을 입력합니다.

작업 1. 대화형 에이전트 시작하기

이 작업에서는 대화형 에이전트에 로그인하고 Flight Booker - Env Mgt라는 새 가상 에이전트를 만듭니다.

가정: 아래 단계를 계속하기 전에 이미 Google Cloud에 로그인한 상태입니다.

1. 새 시크릿 창에서 대화형 에이전트 페이지로 이동합니다.

2. 프로젝트 선택 대화상자에서 전체 탭을 클릭합니다.

3. 프로젝트 ID()를 클릭합니다.

4. Google Dialogflow API 대화상자에서 'API 사용 설정'을 클릭하여 계속합니다.

5. 에이전트 창에서 에이전트 만들기를 클릭합니다.

6. 직접 만들기를 클릭합니다.

7. 에이전트 만들기 대화상자에서 다음 필드를 설정합니다.

   필드	값
   표시 이름	Flight Booker - Env Mgt
   위치
   * 시간대	선택한 위치에 적용되는 GMT 오프셋을 선택합니다.
   대화 시작	흐름을 선택합니다.

   GMT 오프셋을 찾는 방법:
   1. Google Cloud 콘솔 제목 표시줄에서 Gemini AI 채팅 열기 또는 닫기()를 클릭합니다.
   2. 필수 API 섹션에서 사용 설정을 클릭합니다.
   3. 채팅 시작을 클릭하고 선택한 위치의 GMT 오프셋을 묻는 프롬프트를 입력합니다.

8. 만들기를 클릭합니다.

   에이전트를 만들면 기본 시작 흐름 창이 열립니다.

9. 에이전트를 만든 후 설정 > 일반 > Logging 설정으로 이동하여 Cloud Logging 사용 설정 및 대화 기록 사용 설정을 클릭합니다. 이렇게 하면 이 에이전트에 대한 로그가 생성됩니다.

10. 저장을 클릭합니다.

아래의 내 진행 상황 확인하기를 클릭하여 실습 진행 상황을 확인하세요.

대화형 에이전트 시작하기

작업 2. .blob 가상 에이전트 파일 가져오기

이전 실습인 대화형 에이전트: 봇 빌드 기본사항에서 가상 에이전트를 가져와 환경 기능을 살펴봅니다.

1. 다음 링크를 클릭하여 샘플 실습 1 가상 에이전트 솔루션인 gsp929-start-agent를 로컬 하드 드라이브에 다운로드합니다.

2. 에이전트 개요 페이지에서 내보내기/복원 버튼을 클릭합니다.

3. 확장된 메뉴 옵션에서 에이전트 복원을 선택합니다.

4. 업로드 라디오 버튼을 선택합니다.

5. 파일 선택을 클릭합니다.

6. 하드 드라이브에 다운로드한 gsp929-start-agent.blob로 이동하여 선택합니다.

7. 열기를 클릭합니다.

8. 복원을 클릭합니다.

필요한 경우 대화형 에이전트 '복원' 문서를 참조하세요.

이제 이전 실습에서 모든 것을 완료한 가상 에이전트가 준비되었습니다.

아래의 내 진행 상황 확인하기를 클릭하여 실습 진행 상황을 확인하세요. .blob 가상 에이전트 파일 가져오기

작업 3. Draft 환경에서 테스트하기

1. 에이전트를 테스트하려면 오른쪽 상단의 시뮬레이터 전환을 클릭하여 엽니다.

2. 환경 드롭다운이 있습니다.

   다른 환경을 아직 만들지 않았으므로 기본적으로 이 드롭다운에 Draft가 표시됩니다.

3. 두 번째에 시작 리소스 드롭다운이 있습니다.

   다른 흐름이 없으므로 기본적으로 이 드롭다운에 Flow가 표시됩니다. Default Start Flow를 선택할 수도 있지만 지금은 선택하지 않아도 됩니다.

4. '에이전트에게 말하기' 상자에 'i want to book a flight'를 입력합니다.

   에이전트의 다음 응답은 'What city would you like the flight to depart from?'입니다.

5. 대화 상단에 Flow: Default Start Flow가 표시된 데이터를 확인합니다.

   이전 실습을 완료하는 동안 이러한 내용을 일부 확인했을 것입니다. 이제 이 실습을 진행하면서 드롭다운에서 선택하는 항목에 더 주의를 기울여야 합니다.

아래의 내 진행 상황 확인하기를 클릭하여 실습 진행 상황을 확인하세요. Draft 환경에서 테스트하기

작업 4. 환경 만들기

1. 왼쪽에서 환경을 선택합니다.

2. + 만들기를 클릭하여 새 환경을 만듭니다.

3. 표시 이름에 'QA'를 입력합니다.

4. 저장을 클릭합니다.

참고: 시작 흐름 리소스에 버전을 제공해야 합니다라는 메시지가 표시됩니다. 왜 그럴까요?

지금까지 기본 시작 흐름의 게시된 버전이나 게시된 버전이 있는 다른 흐름을 만들지 않았습니다. 기본 시작 흐름 옆의 버전 아래 드롭다운 목록에 '게시되지 않음'이라는 항목 하나만 표시됩니다.

대화형 에이전트를 환경에 게시하려면 시작 흐름이 하나 이상 필요합니다. 에이전트 버전(시작 흐름 포함)을 게시하면 대화형 에이전트에서 더 이상 이 오류가 발생하지 않습니다.

6. x를 클릭하여 환경 생성 오류 메시지를 닫습니다.

7. 기본 메뉴에서 버전을 선택합니다.

8. 흐름 탭에서 기본 시작 흐름을 클릭합니다.

9. + 만들기를 클릭하여 흐름 버전을 만듭니다.

10. 표시 이름 필드에 'Flight booker main v1 chat bot'을 입력합니다.

11. 설명 상자에 이 버전의 가상 에이전트에 포함된 내용을 설명합니다.

12. 저장을 클릭합니다.

이제 버전 목록에 # versions가 1인 Default Start Flow가 표시됩니다.

13. 상태가 준비되지 않음 또는 준비됨으로 표시되는지 확인합니다.

14. 환경을 선택하여 새 환경 구성을 다시 시도합니다.

15. + 만들기를 클릭합니다.

16. 표시 이름에 'QA'를 입력합니다.

17. 흐름 섹션의 기본 시작 흐름 옆에 있는 버전 드롭다운 목록에서 Flight booker main v1 chat bot을 선택합니다. 이전 드롭다운에는 이 항목이 없었습니다.

18. 저장을 클릭합니다.

참고: 다음과 같은 메시지가 표시될 수 있습니다.

Version 'projects/qwiklabs-gcp-03-407df58d36b0/locations///agents/e2779218-b813-4844-a0ea-ec2ef504636d/flows/00000000-0000-0000-0000-000000000000/versions/1' is not ready to serve because its training is RUNNING. Wait for training to finish or fix the version if its training failed.

이는 대화형 에이전트가 버전 관리되는 에이전트를 계속 캡처하고 학습시키고 있기 때문에 발생합니다. 버전 생성 상태가 준비되지 않음으로 표시되었는지 기억하시나요? 버전 생성 상태가 준비됨으로 변경될 때까지 잠시 기다린 후 다시 저장해 보세요.

이제 목록에 새 QA 환경이 마지막 수정 날짜와 함께 표시됩니다.

작업 5. 새 환경에서 테스트하기

다음으로, 생성한 환경에서 버전 관리되는 가상 에이전트를 테스트할 수 있습니다.

1. 에이전트를 테스트하려면 오른쪽 상단에서 시뮬레이터 전환을 클릭하여 시뮬레이터를 엽니다(아직 열려 있지 않은 경우).

2. 이전 테스트의 시뮬레이터가 있는 경우 에이전트 테스트 창에서 '대화 재설정' 버튼을 클릭합니다.

3. 환경 드롭다운에서 QA를 선택합니다.

참고: QA 환경이 표시되지 않으면 페이지를 새로고침해 보세요. 참고: 이 단계는 특정 환경에서 특정 버전을 테스트하기 위해 중요합니다. 그렇지 않으면 예상치 못한 버전을 테스트하게 될 수 있습니다.

4. 에이전트에게 말하기 상자에 'i want to book a flight'를 입력합니다.

   이는 다양한 환경에서 테스트 사례를 실행할 수 있는 방법 중 하나입니다. 하지만 QA에 로드된 버전이 Draft에 있는 버전과 동일하다면 테스트 결과도 동일할 것이라고 생각할 수 있습니다. 맞습니다. 다음에는 더 명확하게 알 수 있도록 변경해 보겠습니다.

아래의 내 진행 상황 확인하기를 클릭하여 실습 진행 상황을 확인하세요. QA 환경에서 테스트하기

작업 6. 추가 버전 만들기

다음으로 가상 에이전트에 변경사항을 적용하고, 이를 새 버전으로 저장하고, 새 환경에 로드하겠습니다.

1. 기본 메뉴에서 흐름 탭을 클릭합니다.

2. 티켓 정보 페이지를 클릭합니다.

3. fulfillment 수정을 클릭하여 항목 fulfillment 정보를 수정합니다.

4. 대답을 추가하려면 +대화 대답 추가를 클릭한 다음 에이전트 대답 아래에서 에이전트 대화를 선택합니다. '에이전트 대화 입력' 상자에 'I'll be happy to assist you with that.'이라는 프롬프트를 입력합니다.

5. 추가를 클릭하고 저장합니다.

   이 시점에서 작업 초안에 변경사항이 저장됩니다. 다음으로 이 변경사항을 포함하는 가상 에이전트의 새 버전을 만듭니다.

6. 버전으로 돌아갑니다.

7. 흐름 탭에서 기본 시작 흐름을 클릭하여 새 버전을 만드는 프로세스를 시작합니다.

8. 위의 버전 관리 단계를 반복하여 'Flight booker main v2 chat bot'이라는 기본 시작 흐름의 새 버전을 만듭니다.

9. '버전 2는 항공편 세부정보를 묻기 전에 친절한 인사말을 추가합니다.'와 같은 설명을 추가합니다.

10. 저장을 클릭합니다.

이제 버전 목록에서 기본 시작 흐름의 버전 수가 2개로 증가한 것을 확인할 수 있습니다.

작업 7. 추가 환경 만들기

1. 위에서 수행한 단계를 반복하여 기본 시작 흐름의 새 버전 2를 사용하는 'Dev'라는 새 환경을 만듭니다.

2. 버전 드롭다운에서 Flight booker main v2 chat bot을 선택합니다.

3. 저장을 클릭합니다.

참고: 다음과 비슷한 오류가 다시 발생할 수 있으므로 잠시 기다린 후 다시 저장해 보세요.

Version 'projects/qwiklabs-gcp-00-fe6cab958249/locations//agents/6792c492-5f79-4ccf-8f17-e757b34f38b9/flows/00000000-0000-0000-0000-000000000000/versions/2' is not ready to serve because its training is RUNNING. Wait for training to finish or fix the version if its training failed.

이제 흐름의 최신 버전이 Dev 환경에 로드됩니다.

다음으로 시뮬레이터로 돌아가서 새로운 Flight booker main v2 chat bot 버전을 테스트합니다.

4. 에이전트 테스트 창을 엽니다(아직 열려 있지 않은 경우).

5. 이전 테스트의 시뮬레이터가 있는 경우 에이전트 테스트 창에서 대화 재설정 버튼을 클릭합니다.

6. 환경 드롭다운에서 Dev를 선택합니다.

참고: Dev 환경이 표시되지 않으면 페이지를 새로고침해 보세요.

7. 에이전트에게 말하기 상자에 'i want to book a flight'를 입력합니다.

   에이전트가 I'll be happy to assist you with that.이라는 답변과 함께 출발 도시를 묻는 프롬프트를 표시합니다. 이는 에이전트의 v2 버전이 실행 중임을 나타냅니다.

아래의 내 진행 상황 확인하기를 클릭하여 실습 진행 상황을 확인하세요. Dev 환경에서 테스트하기

배운 내용 확인(선택사항)

작업 8. 다양한 환경 관리

지금까지 두 개의 환경을 만들고 각 환경에 다른 버전을 로드했습니다. 이러한 환경 중 하나에 로드된 버전을 변경해야 하는 경우 어떻게 해야 할까요?

1. 필요에 따라 왼쪽 창에서 환경을 클릭하여 QA 환경과 Dev 환경을 모두 볼 수 있는 뷰로 이동합니다.

2. QA 환경을 클릭합니다.

3. 버전 드롭다운에서 Flight booker main v2 chat bot을 선택합니다.

4. 저장을 클릭합니다.

5. 버전의 Last modified 시간을 확인합니다.

6. 테스트 시뮬레이터를 사용하여 버전 2가 로드되었는지 확인합니다. (이 버전에 친절한 인사말을 추가했음을 기억하세요.) '대화 재설정'을 클릭하여 새로운 테스트 시나리오를 시작하고 환경 드롭다운에서 QA를 선택해야 합니다.

7. 뒤로 돌아가서 QA 환경에 Flight booker main v1 chat bot을 로드합니다.

8. 다시 테스트합니다. 답변이 예상했던 대로 표시되나요? 출발 도시를 묻는 프롬프트에 앞서 친절한 인사말이 더 이상 표시되지 않습니다.

작업 환경에 대해 논의해 보겠습니다. Draft 환경을 사용하여 테스트 시뮬레이터를 실행하면 에이전트의 어떤 버전이 테스트될까요? 맞습니다. 최근에 저장하거나 업로드한 작업 사본이 테스트됩니다. 버전을 만들 준비가 될 때까지 가상 에이전트의 작업 사본을 Draft에서 테스트할 수 있습니다. 이 시점에서 작업 사본을 다른 환경에 저장하여 다른 팀이 동결된 버전을 테스트하도록 할 수 있습니다.

특정 환경을 선택하면 테스트는 지정된 환경에 로드된 가상 에이전트의 버전을 실행합니다(이 버전은 현재 대화형 에이전트의 Draft 모드에서 작업 중인 버전과 다를 수 있음). 또 다른 이점은 모델을 재학습시키는 과정을 거치지 않고도 다양한 버전을 테스트할 수 있다는 것입니다. 더 크고 복잡한 가상 에이전트의 경우 재학습에 다소 시간이 걸릴 수 있습니다.

학습 내용 점검하기

로그아웃하기 전에 원하는 경우 가상 에이전트를 내보낼 수 있습니다. 이 작업은 다음과 같은 일반적인 단계를 통해 수행됩니다.

1. 상단의 에이전트 드롭다운에서 View all agents를 선택합니다.

2. 컨텍스트 메뉴(세로로 나열된 점 3개)를 클릭하고 내보내기를 선택합니다.

3. 다운로드 라디오 버튼을 클릭합니다.

4. 내보내기를 클릭합니다.

수고하셨습니다

이제 가상 에이전트의 여러 버전을 관리하고 다양한 환경에서 테스트를 실행할 수 있습니다.

Google Cloud 교육 및 자격증

Google Cloud 기술을 최대한 활용하는 데 도움이 됩니다. Google 강의에는 빠른 습득과 지속적인 학습을 지원하는 기술적인 지식과 권장사항이 포함되어 있습니다. 기초에서 고급까지 수준별 학습을 제공하며 바쁜 일정에 알맞은 주문형, 실시간, 가상 옵션이 포함되어 있습니다. 인증은 Google Cloud 기술에 대한 역량과 전문성을 검증하고 입증하는 데 도움이 됩니다.

설명서 최종 업데이트: 2025년 7월 21일

실습 최종 테스트: 2025년 7월 21일

Copyright 2025 Google LLC. All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.