데이터 에이전트 만들기

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

대화형 데이터 에이전트를 사용하면 자연어 인터페이스를 사용하여 데이터베이스 데이터와 상호작용할 수 있습니다. 이러한 에이전트를 빌드하면 사용자가 복잡한 SQL 쿼리를 작성하지 않고도 운영 데이터베이스에서 인사이트를 얻을 수 있도록 '데이터와 대화'할 수 있습니다.

데이터 에이전트는 대략적으로 페르소나, 데이터 소스 집합, 목적에 중요한 비즈니스 지식 집합에 대한 액세스 권한의 조합입니다.

애플리케이션 개발자에게 이러한 에이전트는 다음과 같은 이점을 제공합니다.

• 높은 정확도: 작성된 컨텍스트를 사용하면 특정 비즈니스 질문에 대해 높은 정확도를 달성할 수 있습니다. 작성된 컨텍스트 는 에이전트 생성자가 정확도를 개선하는 데 사용할 수 있는 기본 키 요소입니다. 여기에는 스키마 설명, 시스템 안내, 예상 데이터베이스 쿼리에 대한 추가 정보를 제공하는 구조화된 컨텍스트가 포함됩니다.
• 복잡성 감소: 에이전트는 자연어를 SQL 쿼리, 실행, 데이터 요약 또는 시각화로 변환합니다.
• 유연성: 개인 테스트를 위해 에이전트를 작성하거나 API를 사용하여 프로그래매틱 방식으로 프로젝트의 다른 사용자가 사용할 수 있도록 에이전트를 게시할 수 있습니다.

시작하기 전에

1. 프로젝트에 결제가 사용 설정되어 있는지 확인합니다 Google Cloud .

2. Spanner, Gemini 기반 Data Analytics API, Gemini for Google Cloud APIs를 사용 설정합니다.

   API 사용 설정에 필요한 역할

   API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기.

   API 사용 설정

필요한 역할

데이터 에이전트를 사용하려면 다음 Conversational Analytics 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 역할 및 권한을 참조하세요.

데이터 에이전트 만들기

다음 섹션에서는 데이터 에이전트를 만드는 방법을 설명합니다. 에이전트를 만든 후에는 에이전트의 설정을 수정할 수 있습니다.

기본사항 구성

1. 콘솔에서 Spanner 페이지로 이동합니다. Google Cloud

   Spanner로 이동

2. 목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.

3. 탐색 메뉴에서 에이전트 를 클릭합니다.

4. 에이전트 탭을 클릭합니다.

5. 데이터베이스를 선택하고 IAM 계정을 사용하여 로그인합니다.

6. 새 에이전트 를 클릭합니다. 새 에이전트 페이지가 열립니다.

7. 편집기 섹션의 에이전트 이름 필드에 데이터 에이전트의 설명이 포함된 이름(예: Q4 sales data 또는 User activity logs)을 입력합니다.

8. 에이전트 설명 필드에 데이터 에이전트의 설명을 입력합니다. 좋은 설명은 에이전트가 수행하는 작업과 사용하는 데이터를 설명하고 대화에 사용할 올바른 데이터 에이전트인지 판단하는 데 도움이 됩니다(예: What are the top 10 selling products in Q2?)

9. 지식 소스 섹션에서 소스 추가 를 클릭합니다. 데이터 추가 페이지가 열립니다.

10. 에이전트가 질문에 답변할 때 주로 사용할 테이블을 선택합니다. 추가 지식 소스를 보려면 더보기 를 선택합니다.

11. 추가 를 클릭합니다. 새 에이전트 페이지가 다시 열립니다.

테이블 및 필드 설명 맞춤설정

대화형 데이터 에이전트의 정확도를 개선하기 위해 테이블 메타데이터를 추가로 제공할 수 있습니다(선택사항). 이 메타데이터는 데이터 에이전트만 사용하며 소스 테이블에는 영향을 미치지 않습니다. 다음 메타데이터를 추가할 수 있습니다.

• 스키마 설명: 에이전트가 데이터를 이해하는 데 도움이 되도록 테이블과 열에 설명을 추가합니다. 설명을 추가하지 않으면 에이전트는 데이터 정의의 스키마 설명을 사용합니다.

테이블 및 필드 설명을 추가할 때는 다음 권장사항을 따르세요.

• 데이터 에이전트 정의뿐만 아니라 데이터 정의에도 설명을 추가합니다. 이렇게 하면 다른 에이전트도 설명을 활용할 수 있습니다.
• 데이터 에이전트가 데이터를 이해하는 데 도움이 되는 적절한 설명을 프로토타입으로 만들려면 특정 에이전트에 설명을 추가합니다. 설명이 의도한 영향을 미치는지 확인한 후 데이터 정의에 설명을 추가할지 결정할 수 있습니다.

테이블 및 필드 설명을 구성하려면 다음 단계를 따르세요.

1. 에이전트 카탈로그 탭에서 맞춤설정할 에이전트를 엽니다.
2. 에이전트 수정 을 클릭합니다.
3. 지식 소스에서 맞춤설정할 테이블을 찾은 후 맞춤설정을 클릭합니다.
4. 테이블 설명을 입력합니다.
5. 필드 설명을 수정하려면 필드 옆에 있는 수정 을 클릭합니다. 필드 수정 창이 열립니다.
   1. ID 필드에 필드 설명을 입력합니다.
   2. 필드 설명을 저장하려면 업데이트 를 클릭합니다.
6. 설명 및 필드 업데이트를 저장하려면 업데이트 를 클릭합니다. 새 에이전트 페이지가 다시 열립니다.
7. 맞춤설정할 각 테이블에 대해 이 단계를 반복합니다.

데이터 에이전트에 라벨 추가

에이전트 설정 섹션에서 라벨을 만들어 리소스를 구성할 수 있습니다. Google Cloud 라벨은 관련 객체를 함께 그룹화하거나 다른 Google Cloud 리소스와 그룹화할 수 있게 해주는 키-값 쌍입니다.

1. 에이전트 카탈로그 탭에서 라벨을 추가할 에이전트를 엽니다.
2. 에이전트 수정 을 클릭합니다.
3. 에이전트 설정 섹션에서 라벨 추가 를 클릭합니다. 라벨 관리 창이 열립니다.
4. 라벨 추가 를 클릭합니다.
5. 키 및 값 필드에 라벨의 키-값 쌍을 입력합니다.
6. 라벨을 더 추가하려면 라벨 추가 를 다시 클릭합니다.
7. 라벨을 삭제하려면 삭제를 클릭합니다.
8. 완료되었으면 추가 를 클릭합니다. 새 에이전트 페이지가 다시 열립니다.

다음 섹션으로 이동하여 에이전트를 초안 모드로 전환하거나 에이전트를 게시합니다.

에이전트 미리보기 및 게시

1. 미리보기 섹션의 질문하기 필드에 질문 예시를 입력한 후 Enter 를 누릅니다.

   데이터 에이전트가 예상한 데이터를 반환하는지 확인하려면 에이전트의 응답을 검토합니다. 응답이 예상과 다른 경우 편집기 섹션에서 설정을 변경하여 만족스러운 응답을 얻을 때까지 데이터 에이전트 구성을 세부적으로 조정합니다. 에이전트를 계속 테스트하고 수정하여 에이전트의 결과를 세부적으로 조정할 수 있습니다.

2. 저장 을 클릭합니다.

3. 나중에 다시 수정할 수 있는 초안 모드로 데이터 에이전트를 전환하려면 뒤로 이동 을 클릭하여 에이전트 카탈로그 페이지로 돌아갑니다. 이제 에이전트가 초안 모드이므로 에이전트 카탈로그 탭의 내 초안 에이전트 섹션에 표시됩니다.

   에이전트를 게시하려면 에이전트 생성 페이지에 남아 다음 단계로 진행합니다.

4. 데이터 에이전트를 게시하고 프로젝트에서 사용할 수 있도록 하려면 게시 를 클릭합니다. 에이전트를 게시하면 동일한 데이터베이스 테이블에 액세스할 수 있는 다른 사용자가 생성한 안내 및 컨텍스트를 활용하여 에이전트를 보고 대화할 수 있습니다.

   콘솔의 에이전트 페이지를 사용하여 데이터 에이전트와 대화를 만들 수 있습니다. Google Cloud Conversational Analytics API를 사용하여 데이터 에이전트와 채팅할 수 있는 자체 인터페이스를 빌드할 수도 있습니다.

5. 선택사항: 에이전트가 게시됨 대화상자에서 공유 를 클릭하여 데이터 에이전트를 다른 사용자와 공유합니다.

   1. 권한 공유 창에서 주 구성원 추가 를 클릭합니다.
   2. 새 주 구성원 필드에 주 구성원을 하나 이상 입력합니다.
   3. 역할 선택 목록을 클릭합니다.
   4. 역할 목록에서 다음 역할 중 하나를 선택합니다.
      • Gemini 데이터 분석 데이터 에이전트 사용자(roles/geminidataanalytics.dataAgentUser): 데이터 에이전트와 채팅할 수 있는 권한을 부여합니다.
      • Gemini 데이터 분석 데이터 에이전트 편집자(roles/geminidataanalytics.dataAgentEditor): 데이터 에이전트를 수정할 수 있는 권한을 부여합니다.
      • Gemini 데이터 분석 데이터 에이전트 뷰어(roles/geminidataanalytics.dataAgentViewer): 데이터 에이전트를 볼 수 있는 권한을 부여합니다.

6. 저장 을 클릭합니다.

7. 새 에이전트 페이지로 돌아가려면 닫기 를 클릭합니다. 에이전트를 저장하거나 게시한 후에는 에이전트 카탈로그 에서 에이전트를 확인할 수 있습니다.

데이터 에이전트 관리

기존 에이전트는 세 개의 섹션으로 구성된 에이전트 카탈로그 탭에서 찾을 수 있습니다.

• 내 에이전트: 생성하고 게시한 모든 에이전트의 목록입니다. 게시된 에이전트를 수정하고 다른 사용자와 공유할 수 있습니다.
• 내 초안 에이전트: 아직 게시하지 않은 에이전트입니다. 초안 에이전트는 공유할 수 없습니다.
• 조직의 다른 사용자가 공유한 에이전트: 다른 사용자가 생성하고 공유한 에이전트입니다. 다른 사용자가 권한을 부여하면 이러한 공유 에이전트를 수정할 수 있습니다.

데이터 에이전트 수정

데이터 에이전트를 수정하려면 다음 단계를 따르세요.

1. 콘솔에서 Spanner 페이지로 이동합니다. Google Cloud

   Spanner로 이동

2. 목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.

3. 탐색 메뉴에서 에이전트 를 클릭합니다.

4. Identity and Access Management (IAM) 인증을 사용하여 에이전트 에 로그인합니다.

5. 에이전트 카탈로그 탭을 클릭합니다.

6. 수정할 데이터 에이전트의 에이전트 카드를 찾습니다.

7. 에이전트 편집기에서 데이터 에이전트를 열려면 작업 열기를 클릭한 후 에이전트 카드에서 수정을 클릭합니다.

8. 필요에 따라 데이터 에이전트의 구성을 수정합니다.

9. 게시하지 않고 변경사항을 저장하려면 저장 을 클릭합니다.

10. 변경사항을 게시하려면 게시 를 클릭합니다. 공유 대화상자에서 에이전트를 다른 사용자와 공유하거나 취소 를 클릭할 수 있습니다.

11. 에이전트 창으로 돌아가려면 뒤로 이동을 클릭합니다.

데이터 에이전트 공유

게시된 데이터 에이전트를 공유하려면 다음 단계를 따르세요. 초안 에이전트는 공유할 수 없습니다.

1. 콘솔에서 Spanner 페이지로 이동합니다. Google Cloud

   Spanner로 이동

2. 목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.

3. 탐색 메뉴에서 에이전트 를 클릭합니다.

4. Identity and Access Management (IAM) 인증을 사용하여 에이전트 에 로그인합니다.

5. 에이전트 카탈로그 탭을 클릭합니다.

6. 수정할 데이터 에이전트의 에이전트 카드를 찾습니다.

7. 에이전트 편집기에서 데이터 에이전트를 열려면 Open actions > 에이전트 카드에서 Edit 을 클릭합니다.

8. 데이터 에이전트를 다른 사용자와 공유하려면 공유 를 클릭합니다.

9. 권한 공유 창에서 주 구성원 추가 를 클릭합니다.

10. 주 구성원 추가 필드에 주 구성원을 하나 이상 입력합니다.

11. 역할 선택 을 클릭합니다.

12. 역할 목록에서 다음 역할 중 하나를 선택합니다.

    • Gemini 데이터 분석 데이터 에이전트 사용자(roles/geminidataanalytics.dataAgentUser): 데이터 에이전트와 채팅할 수 있는 권한을 부여합니다.
    • Gemini 데이터 분석 데이터 에이전트 편집자(roles/geminidataanalytics.dataAgentEditor): 데이터 에이전트를 수정할 수 있는 권한을 부여합니다.
    • Gemini 데이터 분석 데이터 에이전트 뷰어(roles/geminidataanalytics.dataAgentViewer): 데이터 에이전트를 볼 수 있는 권한을 부여합니다.

13. 저장 을 클릭합니다.

14. 에이전트 수정 페이지로 돌아가려면 닫기 를 클릭합니다.

15. 에이전트 창으로 돌아가려면 뒤로 이동을 클릭합니다.

데이터 에이전트 삭제

1. 콘솔에서 Spanner 페이지로 이동합니다. Google Cloud

   Spanner로 이동

2. 목록에서 인스턴스를 선택한 후 데이터베이스를 선택합니다.

3. 탐색 메뉴에서 에이전트 를 클릭합니다.

4. Identity and Access Management (IAM) 인증을 사용하여 에이전트 에 로그인합니다.

5. 에이전트 카탈로그 탭을 선택합니다.

6. 에이전트 카탈로그 탭의 에이전트 섹션에서 삭제할 데이터 에이전트의 에이전트 카드를 찾습니다.

7. 작업 열기 > 삭제를 클릭합니다.

8. 에이전트를 삭제하시겠습니까? 대화상자에서 삭제 를 클릭합니다. 에이전트를 삭제하면 에이전트가 프로젝트에서 영구적으로 삭제됩니다.

   에이전트를 삭제한 후에는 기존 대화를 보기 전용 모드로 사용할 수 있습니다. 삭제된 에이전트에게 새 질문을 할 수 없습니다.

위치

대화형 분석은 전역적으로 작동하므로 사용할 리전을 선택할 수 없습니다.

다음 단계

• Spanner의 대화형 분석에 대해 자세히 알아보세요.
• Conversational Analytics API에 대해 자세히 알아보세요.
• 대화로 데이터 분석하기.
• Gemini 데이터 분석 데이터 에이전트 뷰어 (roles/geminidataanalytics.dataAgentViewer) 역할이 데이터 에이전트를 볼 수 있는 권한을 부여하는 방법을 자세히 알아보세요.