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)
  },
  "clientManagedResourceContext": {
    object (ClientManagedResourceContext)
  }
  // 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)

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

object (ConversationReference)

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

object (DataAgentContext)

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

object (ClientManagedResourceContext)

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

응답 본문

성공하면 응답 본문에 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 데이터 소스를 호출할 때 사용할 사용자 인증 정보입니다.

현재 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입니다.