버전 및 환경

에이전트 버전을 여러 개 만들어 별도의 환경에 게시할 수 있습니다.

에이전트를 수정할 때는 초안 에이전트를 수정합니다. 언제든지 초안 에이전트를 특정 에이전트 버전으로 저장할 수 있으며, 이는 에이전트의 변경할 수 없는 스냅샷이 됩니다.

초안 에이전트를 저장하면 이 에이전트가 기본 환경에 게시됩니다. 에이전트 버전을 만들 때는 커스텀 환경에 게시할 수 있습니다. 다음 용도로 다양한 커스텀 환경을 만들 수 있습니다.

  • 테스트
  • 개발
  • 프로덕션
  • 기타

프로덕션 트래픽

프로덕션 트래픽에 항상 에이전트 버전 사용

팀의 개발자가 변경할 때마다 초안 에이전트가 업데이트됩니다. 특히 여러 사람에게 에이전트에 대한 쓰기 액세스 권한이 있는 경우 초안 에이전트가 의도치 않게 중단되기 쉽습니다. 또한 학습이 지연되거나 수동 실행이 필요할 수 있으므로 최근에 수정한 초안 에이전트가 학습된 모델과 일치하지 않을 수 있습니다.

항상 프로덕션 트래픽에 에이전트 버전을 사용해야 합니다. 초안 에이전트를 프로덕션 버전으로 승격하기 전에 테스트해야 합니다. 그러면 문제가 발견될 경우 이전 버전으로 롤백할 수 있습니다.

버전 변경 중에 발생할 수 있는 에이전트 오류 고려

세션이 활성 상태인 동안 프로덕션 환경에서 에이전트 버전을 변경할 경우 일부 활성 세션에 에이전트 오류가 발생할 수 있습니다. 이러한 오류는 이전 및 신규 버전이 서로 일치하지 않아 세션 상태가 중단될 경우에 발생할 수 있습니다. 이로 인해 다운타임 또는 사용량이 많지 않은 시간 중에 버전을 변경하도록 계획해야 합니다.

새 환경에서 버전 게시

에이전트 초안을 특정 버전으로 게시하고 커스텀 환경을 만들려면 다음 안내를 따르세요.

콘솔

  1. Dialogflow ES 콘솔로 이동합니다.
  2. 왼쪽 사이드바 메뉴의 상단 근처에 있는 에이전트를 선택합니다.
  3. 에이전트 이름 옆에 있는 설정 버튼을 클릭합니다.
  4. 환경 탭을 클릭합니다.
  5. 버전 게시를 클릭합니다.
  6. 설명(선택사항)을 추가하고 다음을 클릭합니다.
  7. +새 환경을 선택합니다.

  8. 환경 이름을 입력합니다.

  9. 환경의 fulfillment 메서드를 선택합니다.

  10. 환경의 텍스트 음성 변환 설정을 선택합니다.

  11. 게시를 클릭합니다.

  12. 이제 환경 정보가 커스텀 환경 섹션에 나열됩니다.

API

  1. 버전 유형에 대해 create 메서드를 호출하여 새 에이전트 버전을 만듭니다.
  2. 환경 유형에 대해 create 메서드를 호출하여 새 환경을 만듭니다. 바로 전에 만든 에이전트 버전을 agentVersion 필드에 입력합니다.

환경을 이전 버전으로 되돌리기

환경을 이전 에이전트 버전으로 되돌릴 수 있습니다.

Console

  1. 커스텀 환경 섹션에서 환경을 클릭합니다.
  2. 환경 설정 대화상자가 열립니다.
  3. 게시 내역 섹션에서 이전에 게시한 버전의 옵션 버튼을 클릭합니다.
  4. 이 버전으로 되돌리기를 클릭합니다.
  5. 게시 내역이 업데이트됩니다.

API

환경 유형에 대해 patch/update 메서드를 호출하여 환경을 업데이트합니다. 이전에 만든 에이전트 버전을 agentVersion 필드에 제공합니다.

초안에 이전 버전 로드

초안에 이전 버전을 로드하면 기본 환경에서 초안 에이전트를 선택한 에이전트 버전으로 덮어씁니다.

이전 버전을 초안으로 로드하려면 다음 안내를 따르세요.

콘솔

  1. Dialogflow ES 콘솔로 이동합니다.
  2. 왼쪽 사이드바 메뉴의 상단 근처에 있는 에이전트를 선택합니다.
  3. 에이전트 이름 옆에 있는 설정 버튼을 클릭합니다.
  4. 환경 탭을 클릭합니다.
  5. 초안 섹션에서 모든 버전 보기를 클릭합니다.
  6. 초안으로 로드할 버전의 옵션 버튼을 클릭합니다.
  7. 초안에 로드를 클릭합니다.
  8. 를 클릭합니다.
  9. 열려 있는 콘솔 브라우저 탭을 다시 로드하여 최신 에이전트 데이터로 새로고칩니다.

API

다음 입력을 사용하여 환경 유형에 대해 patch/update 메서드를 호출합니다.

  • -를 환경 ID로 사용하여 기본 환경을 지정합니다.
  • allowLoadToDraftAndDiscardChanges를 true로 설정합니다.
  • agentVersion 필드에서 초안 에이전트를 덮어쓸 에이전트 버전을 제공합니다.

버전 내보내기

버전을 내보내려면 먼저 초안에 로드한 다음 에이전트를 내보내야 합니다.

환경에서 에이전트 테스트

API를 사용하여 커스텀 환경에서 에이전트를 테스트할 수 있습니다. 인텐트 감지 메서드를 호출하되 agentsessions 사이에 environments/environment-name/users/-/를 삽입하여 엔드포인트 URL을 변경합니다.

예를 들어 다음 엔드포인트는 지정되지 않은 사용자에 '개발' 환경을 사용합니다.

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

환경별 설정

Fulfillment 및 텍스트 음성 변환은 환경에서 구성되므로 에이전트는 이러한 기능에 환경 설정을 사용합니다.

다양한 수준에서 데이터가 적용되는 방식에 대한 자세한 내용은 에이전트 애플리케이션 수준을 참조하세요.

Google 어시스턴트

Actions on Google 출시 환경을 사용하는 경우 Dialogflow fulfillment 라이브러리의 버전 관리 제한사항을 참조하세요.

메가 에이전트

메가 에이전트에서 버전 및 환경 작동 방법을 참조하세요.

제한사항

다음과 같은 제한사항이 적용됩니다.

  • 에이전트당 최대 환경 수: 10
  • 에이전트당 최대 버전 수: 1,000