Method: projects.locations.chat

Message 객체 스트림을 생성하여 데이터 질문에 답변합니다.

HTTP 요청

POST https://geminidataanalytics.googleapis.com/v1alpha/{parent=projects/*/locations/*}:chat

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목. 채팅 요청의 상위 값입니다. 패턴: projects/{project}/locations/{location}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "project": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "credentials": {
    object (Credentials)
  },
  "thinkingMode": enum (ThinkingMode),
  "model": enum (Model),

  // Union field context_provider can be only one of the following:
  "inlineContext": {
    object (Context)
  },
  "conversationReference": {
    object (ConversationReference)
  },
  "dataAgentContext": {
    object (DataAgentContext)
  },
  "clientManagedResourceContext": {
    object (ClientManagedResourceContext)
  }
  // End of list of possible types for union field context_provider.

  // Union field datasource_settings can be only one of the following:
  "lookerSettings": {
    object (LookerSettings)
  }
  // End of list of possible types for union field datasource_settings.
}
필드
project
(deprecated)

string

선택사항입니다. 지원 중단됨: 대신 parent 필드를 사용하세요. 할당량 및 결제에 사용할 Google Cloud 프로젝트입니다.
messages[]

object (Message)

필수 항목. 현재 대화의 콘텐츠입니다.
credentials

object (Credentials)

선택사항입니다. 컨텍스트에 지정된 데이터 소스를 호출할 때 사용할 사용자 인증 정보입니다.

이 필드는 다양한 데이터 소스의 사용자 인증 정보를 제공하는 데 사용할 수 있습니다. 예를 들어 Looker에 연결할 때 현재 SDK를 사용한 인증에 설명된 대로 OAuth 토큰과 API 키 기반 사용자 인증 정보를 모두 지원합니다.
thinkingMode

enum (ThinkingMode)

선택사항입니다. 에이전트 루프에 사용할 사고 모드입니다. 지정하지 않을 경우 기본값은 THINKING_MODE_UNSPECIFIED입니다.
model

enum (Model)

선택사항입니다. 요청을 처리할 때 에이전트 루프에 사용할 모델입니다. 이 설정은 context.options.model이 설정되지 않은 경우에만 적용됩니다.
통합 필드 context_provider. 채팅 요청의 컨텍스트 제공업체입니다. inline_context(요청에 인라인으로 제공되는 컨텍스트), data_agent(데이터 에이전트 리소스에 대한 참조), conversation_reference(conversation_id 및 agent_id를 사용하여 지속되는 대화 및 컨텍스트에 대한 참조) 중 하나일 수 있습니다. context_provider는 다음 중 하나여야 합니다.
inlineContext

object (Context)

선택사항. 채팅 요청의 인라인 컨텍스트입니다. 모든 컨텍스트를 인라인으로 전달하여 관리되는 대화 지속성 및 에이전트 없이 스테이트리스(Stateless) 방식으로 채팅하는 데 사용합니다.
conversationReference

object (ConversationReference)

선택사항. 지속된 대화 및 에이전트 컨텍스트에 대한 참조입니다. 관리되는 대화 지속성을 사용하여 에이전트와 채팅하는 데 사용합니다.
dataAgentContext

object (DataAgentContext)

선택사항. 채팅 요청의 컨텍스트입니다. 관리되는 대화 지속성 없이 에이전트와 스테이트리스(Stateless) 방식으로 채팅하는 데 사용합니다.
clientManagedResourceContext

object (ClientManagedResourceContext)

선택사항. 클라이언트 관리 리소스에 대한 컨텍스트입니다. 일부 클라이언트는 GDA에서 관리하는 대화 및 에이전트 리소스를 사용하지 않고, 대신 자체적으로 대화 및 에이전트 리소스를 만들고 관리할 수 있습니다.
통합 필드 datasource_settings. 타겟 데이터 소스에 특화된 요청 동작을 맞춤설정하는 선택적 설정입니다. datasource_settings은 다음 중 하나여야 합니다.
lookerSettings

object (LookerSettings)

선택사항입니다. Looker 관련 설정입니다.

응답 본문

성공하면 응답 본문에 Message 인스턴스 스트림이 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

ConversationReference

지속된 대화 및 에이전트 컨텍스트에 대한 참조입니다.

JSON 표현 
{
  "conversation": string,
  "dataAgentContext": {
    object (DataAgentContext)
  }
}
필드
conversation

string

필수 항목. 대화 리소스의 이름입니다. 형식: projects/{project}/locations/{location}/conversations/{conversationId}
dataAgentContext

object (DataAgentContext)

필수 항목. 데이터 에이전트를 사용하는 채팅 요청의 컨텍스트입니다.

DataAgentContext

데이터 에이전트를 사용하는 채팅 요청의 컨텍스트입니다.

JSON 표현 
{
  "dataAgent": string,
  "credentials": {
    object (Credentials)
  },
  "contextVersion": enum (ContextVersion)
}
필드
dataAgent

string

필수 항목. 데이터 에이전트 리소스의 이름입니다.
credentials
(deprecated)

object (Credentials)

선택사항입니다. 지원 중단됨: ChatRequest에서 사용자 인증 정보를 사용하세요. Looker 데이터 소스를 호출할 때 사용할 사용자 인증 정보입니다.

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

enum (ContextVersion)

선택사항. DCS에서 사용할 컨텍스트 버전입니다(예: STAGING, PUBLISHED).

ContextVersion

DCS에서 지원하는 컨텍스트 버전 목록입니다. 컨텍스트에는 두 가지 버전이 있습니다. 이는 데이터 에이전트의 버전 관리를 유지하기 위한 것입니다.

열거형
CONTEXT_VERSION_UNSPECIFIED 지정되지 않았거나 인식할 수 없습니다.
STAGING 이 버전을 사용하면 DCS가 데이터 에이전트에 최신 스테이징 컨텍스트를 사용합니다.
PUBLISHED 이 버전을 사용하면 DCS가 데이터 에이전트에 대해 게시된 최신 컨텍스트를 사용합니다.

ClientManagedResourceContext

클라이언트 관리 리소스에 대한 컨텍스트입니다. 일부 클라이언트는 GDA에서 관리하는 대화 및 에이전트 리소스를 사용하지 않고, 대신 자체적으로 대화 및 에이전트 리소스를 만들고 관리할 수 있습니다.

JSON 표현 
{
  "inlineContext": {
    object (Context)
  },
  "conversationId": string,
  "agentId": string
}
필드
inlineContext

object (Context)

필수 항목. 채팅 요청의 컨텍스트입니다. 이 필드를 사용하면 GDA API가 관리하는 대화 및 에이전트 지속성 기능을 사용하지 않고, 모든 컨텍스트를 인라인으로 직접 전달하여 채팅을 수행할 수 있습니다.
conversationId

string

선택사항. 클라이언트 관리 대화 ID입니다.
agentId

string

선택사항. 클라이언트 관리 에이전트 ID입니다.

LookerSettings

Looker 관련 맞춤 설정을 보유하는 메시지입니다.

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

boolean

선택사항입니다. Looker의 개발 모드에서 작동할지 여부입니다. true인 경우 API 세션이 'dev' 워크스페이스로 전환되어 사용자의 개발 브랜치에서 LookML 변경사항과 상호작용할 수 있습니다. false이거나 설정되지 않은 경우 세션은 기본 상태 (프로덕션 모드)로 유지됩니다. https://cloud.google.com/looker/docs/dev-mode-prod-mode를 참고하세요.

ThinkingMode

에이전트의 사고 모드입니다.

열거형
THINKING_MODE_UNSPECIFIED 지정되지 않은 사고 모드입니다. BigQuery 사용자가 기본적으로 빠른 모드로 설정되는 경우를 제외하고 에이전트가 기본적으로 사고 모드를 사용합니다.
FAST 빠른 모드, 신속하게 답변합니다.
THINKING 사고 모드, 복잡한 문제를 해결합니다.

모델

BigQuery 사용자를 위한 에이전트의 모델 선택

열거형
MODEL_UNSPECIFIED 지정된 모델이 없습니다. 미리보기 모델 또는 비 미리보기 모델을 사용할 수 있습니다.
LATEST_GA_MODEL 최신 비미리보기 모델을 사용하세요. 이로 인해 특정 요청 수준 설정이 제한될 수 있습니다.