Method: answerQuery

Trả lời một truy vấn bằng cách tạo dựa trên cơ sở.

Yêu cầu HTTP

POST https://developerknowledge.googleapis.com/v1alpha:answerQuery

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

Nội dung yêu cầu

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

Biểu diễn dưới dạng JSON
{
  "query": string
}
Trường
query

string

Bắt buộc. Truy vấn cần trả lời.

Nội dung phản hồi

Thông báo phản hồi cho DeveloperKnowledge.AnswerQuery.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "answer": {
    object (Answer)
  }
}
Trường
answer

object (Answer)

Câu trả lời cho truy vấn.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

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

Trả lời

Câu trả lời cho một truy vấn.

Biểu diễn dưới dạng JSON
{
  "answerText": string,
  "citations": [
    {
      object (AnswerCitation)
    }
  ],
  "references": [
    {
      object (AnswerReference)
    }
  ]
}
Trường
answerText

string

Chứa văn bản của câu trả lời.

citations[]

object (AnswerCitation)

Chỉ có đầu ra. Chứa các trích dẫn cho câu trả lời.

references[]

object (AnswerReference)

Chỉ có đầu ra. Chứa các tài liệu tham khảo cho câu trả lời.

AnswerCitation

Thông tin trích dẫn cho một phân đoạn.

Biểu diễn dưới dạng JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
Trường
startIndex

integer

Chỉ có đầu ra. Cho biết điểm bắt đầu của phân đoạn, được đo bằng byte (Unicode UTF-8), bao gồm cả điểm bắt đầu. Nếu có các ký tự nhiều byte, chẳng hạn như ký tự không phải ASCII, thì chỉ số đo sẽ dài hơn độ dài chuỗi.

endIndex

integer

Chỉ có đầu ra. Cho biết điểm kết thúc của phân đoạn, được đo bằng byte (Unicode UTF-8), không bao gồm điểm kết thúc. Nếu có các ký tự nhiều byte, chẳng hạn như ký tự không phải ASCII, thì chỉ số đo sẽ dài hơn độ dài chuỗi.

sources[]

object (CitationSource)

Chỉ có đầu ra. Chứa các nguồn trích dẫn cho phân đoạn được phân bổ.

CitationSource

Nguồn trích dẫn.

Biểu diễn dưới dạng JSON
{
  "referenceIndex": integer
}
Trường
referenceIndex

integer

Chỉ có đầu ra. Chứa chỉ mục của Answer.AnswerReference trong trường lặp lại references.

AnswerReference

Đại diện cho một tài liệu tham khảo đến một nguồn.

Biểu diễn dưới dạng JSON
{

  // Union field content can be only one of the following:
  "documentReference": {
    object (DocumentReference)
  }
  // End of list of possible types for union field content.
}
Trường
Trường nhóm content. Chứa nội dung của tài liệu tham khảo. content chỉ có thể là một trong những nội dung sau:
documentReference

object (DocumentReference)

Chỉ có đầu ra. Tài liệu tham khảo.

DocumentReference

Đại diện cho một tài liệu tham khảo đến một tài liệu.

Biểu diễn dưới dạng JSON
{
  "documentChunk": {
    object (DocumentChunk)
  }
}
Trường
documentChunk

object (DocumentChunk)

Chỉ có đầu ra. Chứa khối tài liệu. Trường documentChunk.id không được thiết lập và sẽ trống.