이 문서에서는 Spanner에서 대화를 만들고, 수정하고, 삭제하는 방법을 설명합니다. 대화는 데이터 에이전트와의 지속적인 채팅입니다.
테이블 필드 이름을 지정하거나 데이터를 필터링하는 조건을 정의하지 않고도 일반적인 용어(예: '판매' 또는 '가장 인기 있는')를 사용하는 다중 질문을 데이터 에이전트에게 할 수 있습니다. 채팅 응답은 질문에 대한 답변을 텍스트와 코드로 제공하며, 적절한 경우 차트를 생성합니다. 응답에는 결과의 근거가 포함됩니다.
데이터 에이전트와 대화를 만들 수 있습니다. 직접 대화를 만들면 대화형 분석 API 는 데이터 에이전트가 제공하는 컨텍스트 및 처리 안내 없이 질문을 해석합니다.
시작하기 전에
-
Spanner, Gemini 기반 Data Analytics API, Gemini for Google Cloud APIs를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기.
필요한 역할
데이터 에이전트를 사용하려면 다음 대화형 분석 API Identity and Access Management (IAM) 역할 중 하나가 있어야 합니다.
QueryData메서드를 사용하여 지원되는 데이터베이스 소스에서 데이터 쿼리: 프로젝트 수준의 Gemini 데이터 분석 데이터 쿼리 사용자 (roles/geminidataanalytics.queryDataUser)- 프로젝트의 모든 데이터 에이전트 만들기, 수정, 공유, 삭제: 프로젝트 수준의 Gemini 데이터 분석 데이터 에이전트 소유자(
roles/geminidataanalytics.dataAgentOwner) - 프로젝트에서 자체 데이터 에이전트 만들기: 프로젝트 수준의 Gemini 데이터 분석 데이터 에이전트 생성자(
roles/geminidataanalytics.dataAgentCreator) 이 역할은 생성하는 데이터 에이전트에 대한 Gemini 데이터 분석 데이터 에이전트 소유자 역할을 자동으로 부여합니다. - 프로젝트의 모든 데이터 에이전트 보기 및 수정: 프로젝트 수준의 Gemini 데이터 분석 데이터 에이전트 편집자 (
roles/geminidataanalytics.dataAgentEditor) - 프로젝트의 모든 데이터 에이전트 보기: 프로젝트 수준의 Gemini 데이터 분석 데이터 에이전트 뷰어 (
roles/geminidataanalytics.dataAgentViewer)
또한 데이터 에이전트를 만들거나 수정하려면 다음 역할이 있어야 합니다.
- 클러스터에 추가된 IAM 사용자 또는 서비스 계정. 자세한 내용은 다음 IAM 역할 적용을 참조하세요.
- 프로젝트 수준에서 IAM 사용자에게 부여된
spanner.databaseReader역할. 자세한 내용은 프로젝트의 IAM 정책 바인딩 추가를 참조하세요. - 필요한 데이터베이스에 대해 프로젝트 수준에서 IAM 사용자에게 부여된 역할 및 권한. 자세한 내용은 역할 및 권한 부여를 참조하세요.
Spanner 리소스를 사용하려면 Spanner 역할 및 권한을 참조하세요.
대화 만들기
Spanner용 콘솔의 **에이전트** Google Cloud 페이지에 있는 **에이전트 카탈로그** 탭에서 에이전트 또는 데이터 소스와 지속적인 대화를 만들 수 있습니다.
데이터 에이전트와 대화 만들기
데이터 에이전트와 대화를 만들려면 먼저 데이터 에이전트 를 만들고 게시합니다. 다른 사용자가 공유한 에이전트와 대화를 시작할 수도 있습니다.
콘솔에서 데이터 에이전트와 대화를 만들려면 다음 단계를 따르세요. Google Cloud
콘솔에서 Spanner 페이지로 이동합니다. Google Cloud
목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.
탐색 메뉴에서 에이전트 를 클릭합니다.
내 에이전트 또는 조직의 다른 사용자가 공유함 섹션에서 채팅하려는 에이전트의 에이전트 카드를 클릭합니다.
대화 시작 을 클릭합니다. 새 채팅 패널이 열립니다.
질문하기 필드에 데이터 에이전트에 대한 질문을 입력합니다. 예를 들어 '지난 분기 총 매출은 얼마였나요?' 또는 '세션 시간별 상위 5명의 사용자를 보여주세요'와 같은 질문을 할 수 있습니다. Gemini에서 제안하는 질문 중 하나를 클릭하여 시작할 수도 있습니다.
데이터 에이전트는 질문에 답변하기 위해 취하는 조치를 명시하여 응답한 후 결과를 반환합니다.
데이터 에이전트가 질문에 대한 답변을 제공하기 위해 취하는 각 단계를 보려면 근거 표시 를 클릭하여 에이전트의 근거 프로세스에서 각 메시지를 확인합니다.
결과가 계산된 방법에 대한 정보를 보려면 계산 방법을 클릭합니다. 이제 요약 섹션에 생성된 쿼리와 쿼리 결과가 포함됩니다. 코드를 복사한 후 Studio 를 클릭하여 쿼리 편집기에 코드를 붙여넣을 수 있습니다.
데이터에 적합한 경우 데이터 에이전트는 차트, 표, 기타 시각화를 제공합니다. 채팅 기록을 보려면 대화 관리 목록으로 이동합니다.
에이전트 정보를 보려면 세부정보 패널로 이동합니다. 이 패널에는 에이전트 및 에이전트의 지식 소스에 대한 설명이 포함되어 있습니다.
대화 관리하기
에이전트 페이지에서 대화를 열거나, 이름을 바꾸거나, 삭제할 수 있습니다.
기존 대화 열기
콘솔에서 Spanner 페이지로 이동합니다. Google Cloud
목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.
탐색 메뉴에서 에이전트 를 클릭합니다.
대화 탭의 대화 목록에서 열려는 대화를 클릭합니다.
대화 이름 바꾸기
콘솔에서 Spanner 페이지로 이동합니다. Google Cloud
목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.
탐색 메뉴에서 에이전트 를 클릭합니다.
대화 탭의 대화 목록에서 이름을 바꾸려는 대화를 클릭합니다.
작업 보기 > 이름 바꾸기를 클릭합니다.
대화 이름 바꾸기 대화상자의 대화 이름 필드에 대화의 새 이름을 입력합니다.
이름 바꾸기 를 클릭합니다.
대화 삭제
콘솔에서 Spanner 페이지로 이동합니다. Google Cloud
목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.
탐색 메뉴에서 에이전트 를 클릭합니다.
대화 탭의 대화 목록에서 삭제하려는 대화를 클릭합니다.
작업 보기 > 삭제를 클릭합니다.
대화 삭제? 대화상자에서 삭제 를 클릭합니다.
위치
대화형 분석은 전역적으로 작동하므로 사용할 리전을 선택할 수 없습니다.
다음 단계
- Spanner의 대화형 분석에 대해 자세히 알아보세요.
- 대화형 분석 API에 대해 자세히 알아보세요.
- Spanner에서 데이터 에이전트를 만듭니다.