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)
    }
  ],

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

string

(선택사항) 할당량 및 결제에 사용할 Google Cloud 프로젝트입니다.
messages[]

object (Message)

(필수 항목) 현재 대화의 콘텐츠입니다.
통합 필드 context_provider. 채팅 요청의 컨텍스트 제공자입니다. inline_context(요청에 인라인으로 제공되는 컨텍스트), data_agent(데이터 에이전트 리소스에 대한 참조), conversation_reference(conversation_id 및 agent_id를 사용하여 지속되는 대화 및 컨텍스트에 대한 참조) 중 하나일 수 있습니다. context_provider는 다음 중 하나여야 합니다.
inlineContext

object (Context)

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

object (ConversationReference)

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

object (DataAgentContext)

(선택사항) 채팅 요청의 컨텍스트입니다. 관리형 대화 지속성 없이 상태 비저장으로 에이전트와 채팅하는 데 사용합니다.

응답 본문

성공하면 응답 본문에 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

object (Credentials)

(선택사항) Looker 데이터 소스를 호출할 때 사용할 사용자 인증 정보

현재 https://cloud.google.com/looker/docs/api-auth#authentication_with_an_sdk에 설명된 대로 oauth 토큰과 API 키 기반 사용자 인증 정보를 모두 지원합니다.
contextVersion

enum (ContextVersion)

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

ContextVersion

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

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