Query

定义用户输入的查询。

JSON 表示法 
{
  "queryId": string,
  "createTime": string,
  "parts": [
    {
      object (QueryPart)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string
  // End of mutually exclusive fields.
}
字段
queryId

string

仅限输出。查询的唯一 ID。
createTime

string (Timestamp format)

仅限输出。服务器接受此查询的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
parts[]

object (QueryPart)

查询内容部分。
查询内容。以下是互斥字段的列表。在响应中，最多只能设置一个字段：
text

string

纯文本。
互斥字段结束。

QueryPart

表示内容的一部分或全部，用于表示查询。查询可以由多个部分组成。

JSON 表示法 
{
  "mimeType": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "uiJsonPayload": string,
  "personReference": {
    object (PersonReference)
  },
  "driveDocumentReference": {
    object (DriveDocumentReference)
  },
  "documentReference": {
    object (DocumentReference)
  }
  // End of mutually exclusive fields.
}
字段
mimeType

string

可选。数据的 IANA 标准 MIME 类型。请参阅 https://www.iana.org/assignments/media-types/media-types.xhtml。此字段是可选字段。如果未设置，则“data”字段的默认假定 MIME 类型为“text/plain”。
查询部分的载荷。以下是互斥字段的列表。在响应中，最多只能设置一个字段：
text

string

文本内容。
uiJsonPayload

string

此字段应为 JSON 格式的界面消息。截至 2026 年第 1 季度，uiJsonPayload 仅支持 A2UI 消息。
personReference

object (PersonReference)

对人员的引用。
driveDocumentReference

object (DriveDocumentReference)

对 Google 云端硬盘文档的引用。
documentReference

object (DocumentReference)

其他 VAIS Document 引用。
互斥字段结束。

PersonReference

表示人员引用。

JSON 表示法 
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
字段
documentName

string

人员的完整资源名称。格式：projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*。
personId

string

人员的人员 ID。
email

string

人员的电子邮件地址。
displayName

string

人员的显示名称。
displayPhotoUri

string

人员的显示照片网址。
destinationUri

string

人员的目标网址。
fileId

string

仅限输出。存储在会话上下文文件中的人员数据的文件 ID。

DriveDocumentReference

表示 Google 云端硬盘文档引用。

JSON 表示法 
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
字段
driveId

string

文档的云端硬盘 ID。
documentName

string

文档的完整资源名称。格式：projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*。
displayTitle

string

引用的显示标题。
destinationUri

string

引用的目标网址。
iconUri

string

云端硬盘文档引用的图标网址。
fileId

string

仅限输出。存储在会话上下文文件中的云端硬盘文档数据的文件 ID。

DocumentReference

表示文档引用。

JSON 表示法 
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
字段
documentName

string

文档的完整资源名称。格式：projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}。
displayTitle

string

引用的显示标题。
destinationUri

string

引用的目标网址。
iconUri

string

引用的图标网址。
fileId

string

仅限输出。存储在会话上下文文件中的文档数据的文件 ID。
urlForConnector

string

仅限输入。联合搜索返回的文档的 urlForConnector。