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

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

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

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

대화형 상담사 도구란 무엇인가요?

대화형 에이전트 (Dialogflow CX)에서 도구는 대화형 에이전트가 액세스할 수 있는 특정 기능 또는 서비스를 나타냅니다. 도구는 플레이북 내에 정의되며 에이전트가 데이터 검색, API 실행, 외부 시스템과의 상호작용과 같은 작업을 실행할 수 있도록 지원합니다. 애플리케이션 통합은 통합의 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 트리거로 구성되어 있는지 확인합니다.
통합 버전을 게시합니다.
디자이너 툴바에서 (작업 메뉴)를 클릭하고 대화형 상담사 도구 만들기를 선택합니다.
애플리케이션 통합은 필수 API가 사용 설정되어 있는지 확인합니다. 사용 설정되어 있지 않으면 사용 설정하라는 메시지가 표시됩니다.
Create Conversational Agent Tool 창에 다음 입력을 제공합니다.
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 트리거로 구성되어 있는지 확인합니다.
통합 버전을 게시합니다.
디자이너 툴바에서 (작업 메뉴)를 클릭하고 대화형 상담사 도구 만들기를 선택합니다.
애플리케이션 통합은 필수 API가 사용 설정되어 있는지 확인합니다. 사용 설정되어 있지 않으면 사용 설정하라는 메시지가 표시됩니다.
Create Conversational Agent Tool 창에서 다음 입력을 제공합니다.
1. API 트리거: 통합의 모든 API 트리거가 기본적으로 선택됩니다. 원하는 경우 도구에 포함하지 않을 API 트리거를 선택 해제할 수 있습니다.
2. 유형: 기존 대화형 에이전트 선택을 선택하고 다음을 실행합니다.
  1. 대화형 에이전트: 프로젝트에서 사용할 수 있는 상담사 목록이 표시됩니다. 사용할 상담사를 선택합니다.
  2. 도구: 새 도구 만들기 또는 기존 도구 선택을 선택합니다.
    새 도구 만들기를 선택하면 도구 이름을 입력합니다.
    
    Choose existing Tool(기존 도구 선택)을 선택하면 선택한 상담사의 사용 가능한 도구 목록이 표시됩니다. 사용할 도구를 선택합니다.
3. 서비스 계정: 상담사의 리소스 액세스에 필요한 역할 및 권한이 있는 서비스 계정을 선택합니다. 역할이 없으면 부여하라는 메시지가 표시됩니다.
사양 보기를 클릭하여 선택한 트리거에 대해 생성된 사양을 검토합니다. 원하는 경우 저장하기 전에 사양을 수정할 수 있습니다.
저장을 클릭합니다.
도구가 생성되었다는 메시지가 표시됩니다. 보기를 클릭하여 대화형 에이전트 (Dialogflow CX) 콘솔에서 에이전트를 엽니다.
대화형 에이전트 (Dialogflow CX) 콘솔에서 플레이북으로 이동하여 만든 에이전트의 플레이북을 클릭하고 도구를 사용하기 위한 안내를 플레이북에 추가합니다. 자세한 내용은 플레이북 도구를 참고하세요.

고려사항

대화형 에이전트 도구를 사용할 때는 다음 고려사항이 적용됩니다.

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