Application Integration으로 대화형 에이전트 빌드

이제 Application Integration이 대화형 에이전트 (Dialogflow CX)와 직접 통합되어 대화형 환경을 간소화합니다. 이 기능을 사용하면 API 트리거를 사용하여 통합 워크플로에서 직접 사용자 상호작용을 개선하고 작업을 자동화하는 지능형 챗봇과 도구를 빌드할 수 있습니다.

대화형 에이전트란 무엇인가요?

대화형 에이전트 (Dialogflow CX) 대화형 에이전트는 사용자와 자연어 대화로 소통하는 가상 에이전트입니다. 사용자 입력을 분석하고, 의도를 해석하고, 적절한 응답을 제공하여 대화형 맞춤 대화 경험을 지원합니다. 이러한 에이전트는 웹사이트, 모바일 앱, 메시지 플랫폼과 같은 다양한 채널에서 대화를 처리하도록 설계되었습니다.

대화형 에이전트 도구란 무엇인가요?

대화형 에이전트 (Dialogflow CX)에서 도구는 대화형 에이전트가 액세스할 수 있는 특정 기능 또는 서비스를 나타냅니다. 도구는 플레이북 내에 정의되며 에이전트가 데이터를 가져오거나, API를 실행하거나, 외부 시스템과 상호작용하는 등의 작업을 실행할 수 있도록 지원합니다. Application Integration은 통합의 API 트리거를 기반으로 이러한 도구를 생성하므로 통합 로직을 대화 흐름에 쉽게 연결할 수 있습니다.

시작하기 전에

Application Integration을 사용하여 대화형 에이전트 도구를 만들기 전에 다음을 확인하세요.

다음 IAM 역할을 주 구성원에 할당합니다.
- 서비스 계정 관리자(roles/iam.serviceAccountAdmin)
- 서비스 사용량 관리자(roles/serviceusage.serviceUsageAdmin)
- Dialogflow 콘솔 에이전트 편집자 (roles/dialogflow.consoleAgentEditor)
주 구성원에게 역할을 부여하는 방법에 대한 자세한 내용은 단일 역할 부여 또는 취소를 참고하세요.

서비스 계정에 필요한 IAM 역할

대화형 에이전트 도구를 만드는 데 사용되는 서비스 계정에는 다음 IAM 역할이 필요합니다.

서비스 계정	설명	필요한 역할
서비스 계정	대화형 에이전트 도구를 만드는 데 사용된 서비스 계정입니다.	Application Integration 호출자(`roles/integrations.integrationInvoker`)
Dialogflow 서비스 에이전트 (`service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com`)	대화형 에이전트 (Dialogflow CX)가 통합에 액세스하는 데 사용하는 서비스 계정입니다.	서비스 계정 토큰 생성자(`roles/iam.serviceAccountTokenCreator`)

새 대화형 에이전트 도구 만들기

Application Integration을 사용하여 새로운 대화형 에이전트 도구를 만들려면 다음 단계를 수행하세요.

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 통합을 클릭합니다.
Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 페이지가 나타납니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우 다음 단계를 따르세요.
1. 통합 만들기 창에 이름과 설명을 입력합니다.
2. 통합 리전을 선택합니다.
  참고: 리전 드롭다운에는 Google Cloud 프로젝트에 프로비저닝된 리전만 나열됩니다. 새 리전을 프로비저닝하려면 리전 사용 설정을 클릭합니다. 자세한 내용은 새 리전 사용 설정을 참조하세요.
3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
  참고: 서비스 계정 선택 옵션은 선택한 리전에 대해 통합 거버넌스를 사용 설정한 경우에만 표시됩니다.
4. 만들기를 클릭합니다.
  통합 편집기 페이지에서 통합이 열립니다.
기존 통합을 선택합니다. 통합 편집기 페이지에서 통합이 열립니다.
선택한 통합이 하나 이상의 API 트리거로 구성되어 있는지 확인합니다.
통합 버전을 게시합니다.
디자이너 툴바에서 (작업 메뉴)를 클릭하고 대화형 에이전트 도구 만들기를 선택합니다.
Application Integration은 필수 API가 사용 설정되어 있는지 확인합니다. 사용 설정되어 있지 않으면 사용 설정하라는 메시지가 표시됩니다.
대화형 에이전트 도구 만들기 창에서 다음 입력을 제공합니다.
1. API 트리거: 통합의 모든 API 트리거가 기본적으로 선택됩니다. 원하는 경우 도구에 포함하지 않을 API 트리거를 선택 해제할 수 있습니다.
2. 유형: 새 대화형 에이전트 만들기를 선택하고 다음 세부정보를 입력합니다.
  1. 리전: 에이전트의 리전을 선택합니다.
  2. 상담사 이름: 상담사 이름을 입력합니다.
  3. 도구 이름: 도구 이름을 입력합니다.
3. 서비스 계정: 에이전트의 리소스 액세스에 필요한 역할 및 권한이 있는 서비스 계정을 선택합니다. 권한이 없는 경우 부여하라는 메시지가 표시됩니다.
사양 보기를 클릭하여 선택한 트리거에 대해 생성된 사양을 검토합니다. 원하는 경우 저장하기 전에 사양을 수정할 수 있습니다.
저장을 클릭합니다.
도구가 성공적으로 생성되었음을 나타내는 메시지가 표시됩니다. 보기를 클릭하여 대화형 에이전트 (Dialogflow CX) 콘솔에서 에이전트를 엽니다.
대화형 에이전트 (Dialogflow CX) 콘솔에서 플레이북으로 이동하여 생성된 에이전트의 플레이북을 클릭하고 도구를 사용하도록 플레이북에 안내를 추가합니다. 자세한 내용은 플레이북 도구를 참고하세요.

기존 에이전트를 사용하여 대화형 에이전트 도구 만들기

기존 에이전트를 사용하여 대화형 에이전트 도구를 만들려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 통합을 클릭합니다.
Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 페이지가 나타납니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 창에 이름과 설명을 입력합니다.
2. 통합 리전을 선택합니다.
  참고: 리전 드롭다운에는 Google Cloud 프로젝트에 프로비저닝된 리전만 나열됩니다. 새 리전을 프로비저닝하려면 리전 사용 설정을 클릭합니다. 자세한 내용은 새 리전 사용 설정을 참조하세요.
3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
  참고: 서비스 계정 선택 옵션은 선택한 리전에 대해 통합 거버넌스를 사용 설정한 경우에만 표시됩니다.
4. 만들기를 클릭합니다.
  통합 편집기 페이지에서 통합이 열립니다.
기존 통합을 선택합니다. 통합 편집기 페이지에서 통합이 열립니다.
선택한 통합이 하나 이상의 API 트리거로 구성되어 있는지 확인합니다.
통합 버전을 게시합니다.
디자이너 툴바에서 (작업 메뉴)를 클릭하고 대화형 에이전트 도구 만들기를 선택합니다.
Application Integration은 필수 API가 사용 설정되어 있는지 확인합니다. 사용 설정되어 있지 않으면 사용 설정하라는 메시지가 표시됩니다.
대화형 에이전트 도구 만들기 창에서 다음 입력을 제공합니다.
1. API 트리거: 통합의 모든 API 트리거가 기본적으로 선택됩니다. 원하는 경우 도구에 포함하지 않을 API 트리거를 선택 해제할 수 있습니다.
2. 유형: 기존 대화형 에이전트 선택을 선택하고 다음을 실행합니다.
  1. 대화형 에이전트: 프로젝트에서 사용할 수 있는 에이전트 목록이 표시됩니다. 사용할 에이전트를 선택합니다.
  2. 도구: 새 도구 만들기 또는 기존 도구 선택을 선택합니다.
    새 도구 만들기를 선택하는 경우 도구 이름을 입력합니다.
    
    기존 도구 선택을 선택하면 선택한 에이전트에서 사용 가능한 도구 목록이 표시됩니다. 사용할 도구를 선택합니다.
3. 서비스 계정: 에이전트의 리소스 액세스에 필요한 역할 및 권한이 있는 서비스 계정을 선택합니다. 권한이 없는 경우 부여하라는 메시지가 표시됩니다.
사양 보기를 클릭하여 선택한 트리거에 대해 생성된 사양을 검토합니다. 원하는 경우 저장하기 전에 사양을 수정할 수 있습니다.
저장을 클릭합니다.
도구가 성공적으로 생성되었음을 나타내는 메시지가 표시됩니다. 보기를 클릭하여 대화형 에이전트 (Dialogflow CX) 콘솔에서 에이전트를 엽니다.
대화형 에이전트 (Dialogflow CX) 콘솔에서 플레이북으로 이동하여 생성된 에이전트의 플레이북을 클릭하고 도구를 사용하도록 플레이북에 안내를 추가합니다. 자세한 내용은 플레이북 도구를 참고하세요.

고려사항

대화형 에이전트 도구를 사용할 때는 다음 사항을 고려하세요.

대화형 에이전트 도구는 API 트리거가 있는 게시된 통합에 대해서만 만들 수 있습니다.
생성 후 대화형 에이전트 (Dialogflow CX) 콘솔에서 에이전트를 검토하고 테스트합니다.