REST Resource: projects.locations.dataAgents

리소스: DataAgent

DataAgent 객체를 설명하는 메시지입니다.

JSON 표현
{
  "name": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,

  // Union field type can be only one of the following:
  "dataAnalyticsAgent": {
    object (DataAnalyticsAgent)
  }
  // End of list of possible types for union field type.
}
필드
name

string

선택사항. 식별자. 에이전트의 고유 리소스 이름입니다. 형식: 'projects/{project}/locations/{location}/dataAgents/{dataAgentId}' {dataAgent}은 리소스 ID이며 63자(영문 기준) 이하여야 하고 https://google.aip.dev/122#resource-id-segments에 설명된 형식과 일치해야 합니다.

예: 'projects/1234567890/locations/us-central1/dataAgents/my-agent'

displayName

string

선택사항. 사용자 친화적인 표시 이름입니다.

  • 1~256자(영문 기준) 사이여야 합니다.
description

string

선택사항. 에이전트에 대한 설명입니다.

  • 1~1,024자(영문 기준) 사이여야 합니다.
labels

map (key: string, value: string)

선택사항. 사용자가 관련 에이전트를 필터링하는 데 도움이 되는 라벨입니다. 예: 'sales', 'business', 'etl' 등. 라벨은 필터링에만 사용되며 정책에는 사용되지 않습니다. 라벨 사용에 대한 자세한 내용은 라벨 개요를 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

createTime

string (Timestamp format)

출력 전용입니다. 데이터 에이전트가 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 데이터 에이전트가 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

dataAnalyticsAgent

object (DataAnalyticsAgent)

데이터 분석 에이전트입니다.

DataAnalyticsAgent

DataAnalyticsAgent 객체를 설명하는 메시지입니다.

JSON 표현
{
  "stagingContext": {
    object (Context)
  },
  "publishedContext": {
    object (Context)
  }
}
필드
stagingContext

object (Context)

선택사항. 에이전트의 스테이징 컨텍스트입니다. 이 컨텍스트는 게시 전에 변경사항을 테스트하고 검증하는 데 사용됩니다.

publishedContext

object (Context)

선택사항. 에이전트의 게시된 컨텍스트입니다. 이 컨텍스트는 프로덕션에서 Chat API에 의해 사용됩니다.

컨텍스트

이 대화에 적용할 컨텍스트 모음

JSON 표현
{
  "systemInstruction": string,
  "datasourceReferences": {
    object (DatasourceReferences)
  },
  "options": {
    object (ConversationOptions)
  }
}
필드
systemInstruction

string

선택사항. 데이터 소유자가 에이전트의 도메인 지식을 만드는 기본 진입점입니다.

datasourceReferences

object (DatasourceReferences)

필수 항목. 질문에 답변하는 데 사용할 수 있는 데이터 소스입니다.

options

object (ConversationOptions)

선택사항. 대화의 추가 옵션입니다.

DatasourceReferences

데이터 소스 참조 모음입니다.

JSON 표현
{

  // Union field references can be only one of the following:
  "bq": {
    object (BigQueryTableReferences)
  },
  "studio": {
    object (StudioDatasourceReferences)
  },
  "looker": {
    object (LookerExploreReferences)
  }
  // End of list of possible types for union field references.
}
필드
통합 필드 references. 사용할 데이터 소스입니다. references은 다음 중 하나여야 합니다.
bq

object (BigQueryTableReferences)

BigQuery 테이블에 대한 참조입니다.

studio

object (StudioDatasourceReferences)

Looker Studio 데이터 소스에 대한 참조입니다.

looker

object (LookerExploreReferences)

Looker Explore에 대한 참조입니다.

BigQueryTableReferences

BigQuery 테이블에 대한 참조를 나타내는 메시지입니다.

JSON 표현
{
  "tableReferences": [
    {
      object (BigQueryTableReference)
    }
  ]
}
필드
tableReferences[]

object (BigQueryTableReference)

필수 항목. BigQuery 테이블에 대한 참조입니다.

BigQueryTableReference

단일 BigQuery 테이블에 대한 참조를 나타내는 메시지입니다.

JSON 표현
{
  "projectId": string,
  "datasetId": string,
  "tableId": string
}
필드
projectId

string

필수 항목. 테이블이 속한 프로젝트입니다.

datasetId

string

필수 항목. 테이블이 속한 데이터 세트입니다.

tableId

string

필수 항목. 테이블 ID입니다.

StudioDatasourceReferences

Looker Studio 데이터 소스에 대한 참조를 나타내는 메시지입니다.

JSON 표현
{
  "studioReferences": [
    {
      object (StudioDatasourceReference)
    }
  ]
}
필드
studioReferences[]

object (StudioDatasourceReference)

스튜디오 데이터 소스에 대한 참조입니다.

StudioDatasourceReference

단일 Looker Studio 데이터 소스에 대한 참조를 나타내는 메시지입니다.

JSON 표현
{
  "datasourceId": string
}
필드
datasourceId

string

필수 항목. 데이터 소스의 ID입니다.

LookerExploreReferences

Looker Explore에 대한 참조를 나타내는 메시지입니다.

JSON 표현
{
  "exploreReferences": [
    {
      object (LookerExploreReference)
    }
  ],
  "credentials": {
    object (Credentials)
  }
}
필드
exploreReferences[]

object (LookerExploreReference)

필수 항목. Looker Explore에 대한 참조입니다.

credentials

object (Credentials)

선택사항. Looker API를 호출할 때 사용할 사용자 인증 정보입니다.

현재 SDK를 사용한 인증에 설명된 대로 OAuth 토큰과 API 키 기반 사용자 인증 정보를 모두 지원합니다.

LookerExploreReference

단일 Looker Explore에 대한 참조를 나타내는 메시지입니다.

JSON 표현
{
  "lookmlModel": string,
  "explore": string,
  "schema": {
    object (Schema)
  },

  // Union field instance can be only one of the following:
  "lookerInstanceUri": string,
  "privateLookerInstanceInfo": {
    object (PrivateLookerInstanceInfo)
  }
  // End of list of possible types for union field instance.
}
필드
lookmlModel

string

필수 항목. 주요 LookML 구조에 설명된 LookML 모델의 이름입니다.

explore

string

필수 항목. 주요 LookML 구조에 설명된 Looker Explore의 이름입니다.

schema

object (Schema)

선택사항. 데이터 소스의 스키마입니다.

통합 필드 instance. Looker Explore의 인스턴스입니다. instance은 다음 중 하나여야 합니다.
lookerInstanceUri

string

필수 항목. Looker 인스턴스의 기본 URL입니다.

privateLookerInstanceInfo

object (PrivateLookerInstanceInfo)

비공개 Looker 인스턴스 정보입니다.

PrivateLookerInstanceInfo

Looker 인스턴스가 비공개 네트워크 뒤에 있는 경우 필요한 비공개 Looker 인스턴스 정보를 나타내는 메시지입니다.

JSON 표현
{
  "lookerInstanceId": string,
  "serviceDirectoryName": string
}
필드
lookerInstanceId

string

Looker 인스턴스 ID입니다.

serviceDirectoryName

string

Looker 인스턴스의 서비스 디렉터리 이름입니다.

스키마

Datasource 또는 QueryResult 인스턴스의 스키마입니다.

JSON 표현
{
  "fields": [
    {
      object (Field)
    }
  ]
}
필드
fields[]

object (Field)

출력 전용입니다. 스키마의 필드입니다.

필드

스키마의 필드입니다.

JSON 표현
{
  "name": string,
  "type": string,
  "description": string,
  "mode": string,
  "displayName": string,
  "subfields": [
    {
      object (Field)
    }
  ]
}
필드
name

string

출력 전용입니다. 필드의 이름입니다.

type

string

출력 전용입니다. 필드 유형입니다.

description

string

출력 전용입니다. 필드에 대한 간단한 설명입니다.

mode

string

출력 전용입니다. 필드의 모드입니다(예: NULLABLE, REPEATED).

displayName

string

선택사항. 필드 displayName(라벨과 동일)

subfields[]

object (Field)

선택사항. 중첩된 스키마 구조의 재귀적 속성입니다.

사용자 인증 정보

다양한 형태의 사용자 인증 정보 사양을 나타냅니다.

JSON 표현
{

  // Union field kind can be only one of the following:
  "oauth": {
    object (OAuthCredentials)
  }
  // End of list of possible types for union field kind.
}
필드
oauth

object (OAuthCredentials)

OAuth 사용자 인증 정보입니다.

OAuthCredentials

OAuth 사용자 인증 정보를 나타냅니다.

JSON 표현
{

  // Union field kind can be only one of the following:
  "secret": {
    object (SecretBased)
  },
  "token": {
    object (TokenBased)
  }
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. OAuth 사용자 인증 정보의 종류입니다. kind은 다음 중 하나여야 합니다.
secret

object (SecretBased)

보안 비밀 기반 OAuth 사용자 인증 정보입니다.

token

object (TokenBased)

토큰 기반 OAuth 사용자 인증 정보입니다.

SecretBased

액세스 토큰이 포함된 보안 비밀의 이름입니다. 보안 비밀 기반 OAuth 사용자 인증 정보를 나타냅니다.

JSON 표현
{
  "clientId": string,
  "clientSecret": string
}
필드
clientId

string

필수 항목. OAuth 클라이언트 ID입니다.

clientSecret

string

필수 항목. OAuth 클라이언트 보안 비밀번호입니다.

TokenBased

Looker 액세스 토큰에 대한 자세한 내용은 Looker API 인증을 참고하세요.

JSON 표현
{
  "accessToken": string
}
필드
accessToken

string

필수 항목. 액세스 토큰이 포함된 보안 비밀의 이름입니다.

ConversationOptions

대화 옵션입니다.

JSON 표현
{
  "chart": {
    object (ChartOptions)
  },
  "analysis": {
    object (AnalysisOptions)
  }
}
필드
chart

object (ChartOptions)

선택사항. 차트 생성 옵션입니다.

analysis

object (AnalysisOptions)

선택사항. 분석 옵션입니다.

ChartOptions

차트 생성 옵션입니다.

JSON 표현
{
  "image": {
    object (ImageOptions)
  }
}
필드
image

object (ImageOptions)

선택사항. 지정된 경우 에이전트는 제공된 형식을 사용하여 생성된 차트를 렌더링합니다. 기본값은 이미지가 없습니다.

ImageOptions

생성된 차트의 이미지를 렌더링하는 옵션입니다.

JSON 표현
{

  // Union field kind can be only one of the following:
  "noImage": {
    object (NoImage)
  },
  "svg": {
    object (SvgOptions)
  }
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 렌더링할 이미지 종류입니다. kind은 다음 중 하나여야 합니다.
noImage

object (NoImage)

이미지 없음.

svg

object (SvgOptions)

SVG 형식.

NoImage

이 유형에는 필드가 없습니다.

이미지 없음.

SvgOptions

이 유형에는 필드가 없습니다.

SVG 옵션입니다.

AnalysisOptions

분석 옵션입니다.

JSON 표현
{
  "python": {
    object (Python)
  }
}
필드
python

object (Python)

선택사항. Python 분석 옵션입니다.

Python

Python 분석 옵션입니다.

JSON 표현
{
  "enabled": boolean
}
필드
enabled

boolean

선택사항. Python 분석을 사용 설정할지 여부입니다. 기본값은 false입니다.

메서드

create

특정 프로젝트와 위치에 새 DataAgent를 만듭니다.

delete

단일 DataAgent를 삭제합니다.

get

단일 DataAgent의 세부정보를 가져옵니다.

list

특정 프로젝트와 위치의 DataAgents를 나열합니다.

patch

단일 DataAgent의 파라미터를 업데이트합니다.