Method: projects.locations.chat

Trả lời câu hỏi về dữ liệu bằng cách tạo một luồng đối tượng Message.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Giá trị gốc cho yêu cầu trò chuyện. Mẫu: projects/{project}/locations/{location}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Các trường
project
(deprecated)

string

Không bắt buộc. Dự án Google Cloud sẽ được dùng cho hạn mức và thanh toán.
messages[]

object (Message)

Bắt buộc. Nội dung của cuộc trò chuyện hiện tại.
Trường hợp hợp nhất context_provider. Nhà cung cấp ngữ cảnh cho yêu cầu trò chuyện. Đó có thể là – inline_context, là ngữ cảnh được cung cấp cùng dòng trong yêu cầu. data_agent, là tham chiếu đến tài nguyên của tác nhân dữ liệu. conversation_reference, là tham chiếu đến một cuộc trò chuyện và ngữ cảnh ổn định bằng cách sử dụng conversation_id và agent_id. context_provider chỉ có thể là một trong những loại sau:
inlineContext

object (Context)

Không bắt buộc. Ngữ cảnh nội tuyến cho yêu cầu trò chuyện. Sử dụng tính năng này để trò chuyện không theo trạng thái (không có cuộc trò chuyện được quản lý liên tục và không có Nhân viên hỗ trợ) bằng cách truyền tất cả ngữ cảnh cùng dòng.
conversationReference

object (ConversationReference)

Không bắt buộc. Tham chiếu đến một cuộc trò chuyện và ngữ cảnh của nhân viên hỗ trợ ổn định. Sử dụng tính năng này để trò chuyện với Nhân viên hỗ trợ bằng tính năng duy trì cuộc trò chuyện được quản lý.
dataAgentContext

object (DataAgentContext)

Không bắt buộc. Ngữ cảnh cho yêu cầu trò chuyện. Sử dụng tính năng này để trò chuyện với một Nhân viên hỗ trợ không có trạng thái, mà không cần duy trì cuộc trò chuyện được quản lý.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một luồng các thực thể Message.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Authentication Overview.

ConversationReference

Tham chiếu đến một cuộc trò chuyện và ngữ cảnh của nhân viên hỗ trợ ổn định.

Biểu diễn dưới dạng JSON 
{
  "conversation": string,
  "dataAgentContext": {
    object (DataAgentContext)
  }
}
Các trường
conversation

string

Bắt buộc. Tên của tài nguyên cuộc trò chuyện. Định dạng: projects/{project}/locations/{location}/conversations/{conversationId}
dataAgentContext

object (DataAgentContext)

Bắt buộc. Ngữ cảnh cho yêu cầu trò chuyện bằng cách sử dụng tác nhân dữ liệu.

DataAgentContext

Ngữ cảnh cho yêu cầu trò chuyện bằng cách sử dụng tác nhân dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "dataAgent": string,
  "credentials": {
    object (Credentials)
  },
  "contextVersion": enum (ContextVersion)
}
Các trường
dataAgent

string

Bắt buộc. Tên của tài nguyên tác nhân dữ liệu.
credentials

object (Credentials)

Không bắt buộc. Thông tin xác thực cần sử dụng khi gọi nguồn dữ liệu Looker

Hiện hỗ trợ cả mã thông báo oauth và thông tin xác thực dựa trên khoá API, như mô tả trong https://cloud.google.com/looker/docs/api-auth#authentication_with_an_sdk
contextVersion

enum (ContextVersion)

Không bắt buộc. Phiên bản ngữ cảnh mà DCS sẽ sử dụng (ví dụ: STAGING, PUBLISHED)

ContextVersion

Danh sách các phiên bản ngữ cảnh được DCS hỗ trợ. Có hai phiên bản ngữ cảnh. Việc này là để duy trì việc tạo phiên bản cho tác nhân dữ liệu.

Enum
CONTEXT_VERSION_UNSPECIFIED Không xác định hoặc không nhận dạng được.
STAGING Khi sử dụng phiên bản này, DCS sẽ sử dụng ngữ cảnh dàn dựng mới nhất cho tác nhân dữ liệu.
PUBLISHED Khi sử dụng phiên bản này, DCS sẽ sử dụng ngữ cảnh mới nhất được phát hành cho tác nhân dữ liệu.