Query

Define uma consulta inserida pelo usuário.

Representação 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.
}
Campos
queryId

string

Apenas saída. ID exclusivo da consulta.
createTime

string (Timestamp format)

Apenas saída. O momento em que o servidor aceitou esta consulta.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
parts[]

object (QueryPart)

Consultar partes do conteúdo.
Consultar conteúdo. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
text

string

Texto simples.
Fim dos campos mutuamente exclusivos.

QueryPart

Representa uma parte ou a totalidade de um conteúdo, usado para representar uma consulta. Uma consulta pode ser composta de várias partes.

Representação 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)
  },
  "userSuppliedSobiArtifactReference": {
    object (UserSuppliedSobiArtifactReference)
  }
  // End of mutually exclusive fields.
}
Campos
mimeType

string

Opcional. O tipo MIME padrão da IANA dos dados. Consulte https://www.iana.org/assignments/media-types/media-types.xhtml. Este campo é opcional. Se não for definido, o tipo MIME padrão será "text/plain" para o campo "data".
O payload da parte da consulta. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
text

string

Conteúdo de texto.
uiJsonPayload

string

Esse campo precisa ser uma mensagem da interface no formato JSON. A partir do primeiro trimestre de 2026, o uiJsonPayload será compatível apenas com mensagens A2UI.
personReference

object (PersonReference)

Referência a uma pessoa.
driveDocumentReference

object (DriveDocumentReference)

Referência a um documento do Google Drive.
documentReference

object (DocumentReference)

Outras referências do VAIS Document.
userSuppliedSobiArtifactReference

object (UserSuppliedSobiArtifactReference)

Referência a um arquivo fornecido pelo usuário anexado a uma tarefa de agente de longa duração (Sobi). Consulte UserSuppliedSobiArtifactReference acima.
Fim dos campos mutuamente exclusivos.

PersonReference

Representa uma referência a uma pessoa.

Representação JSON 
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
Campos
documentName

string

O nome completo do recurso da pessoa. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.
personId

string

O ID da pessoa.
email

string

O e-mail da pessoa.
displayName

string

O nome de exibição da pessoa.
displayPhotoUri

string

O URL da foto de exibição da pessoa.
destinationUri

string

O URI de destino da pessoa.
fileId

string

Apenas saída. O ID do arquivo dos dados da pessoa armazenados nos arquivos de contexto da sessão.

DriveDocumentReference

Representa uma referência a um documento do Google Drive.

Representação JSON 
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
Campos
driveId

string

O ID do documento no Drive.
documentName

string

O nome completo do recurso do documento. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.
displayTitle

string

O título de exibição da referência.
destinationUri

string

O URI de destino da referência.
iconUri

string

O URI do ícone da referência do documento do Drive.
fileId

string

Apenas saída. O ID do arquivo dos dados do documento do Drive armazenados nos arquivos de contexto da sessão.

DocumentReference

Representa uma referência de documento.

Representação JSON 
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
Campos
documentName

string

O nome completo do recurso do documento. Formato: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}.
displayTitle

string

O título de exibição da referência.
destinationUri

string

O URI de destino da referência.
iconUri

string

O URI do ícone da referência.
fileId

string

Apenas saída. O ID do arquivo dos dados do documento armazenados nos arquivos de contexto da sessão.
urlForConnector

string

Somente entrada. O urlForConnector do documento retornado pela pesquisa federada.

UserSuppliedSobiArtifactReference

Referência a um arquivo fornecido pelo usuário anexado a uma tarefa de agente de longa duração (Sobi). Renderizado pelo cliente como um ícone de anexo na bolha da vez do usuário. O arquivo em si é armazenado na lista AgentArtifact da tarefa. O cliente resolve os metadados completos (URI de origem, tamanho etc.) para download ou visualização chamando tasks.get na API Tasks Sobi e correspondendo AgentArtifact.name a fileName.

Apenas fileName e mimeType aparecem propositalmente nesse fio: o gs:// de apoio ou o URI do Drive não são expostos aos leitores do histórico de conversas. A mesma variante é usada para arquivos enviados por bytes e selecionados no Drive. "O usuário anexou um arquivo" é um conceito, seja qual for a origem.

Representação JSON 
{
  "fileName": string,
  "mimeType": string
}
Campos
fileName

string

Obrigatório. Nome de arquivo fornecido pelo cliente. Exclusivo por tarefa no conjunto de artefatos fornecido pelo usuário (UI remove duplicidades antes do upload). Também funciona como o identificador do artefato usado para pesquisar o artefato em Task.artifacts.

O sufixo _name é proposital, e a lint AIP-122 é suprimida: esse campo não é um nome de recurso (que é para o que a AIP-122 reserva o name simples). É o nome de arquivo literal e serve como chave de junção em relação a AgentArtifact.name na tarefa de suporte do Sobi, uma função estrutural que title ou displayName não comunicaria a um cliente que escolhe o que enviar. O espelho interno (cloud/ml/discoveryengine/schema/assistant.proto) usa o mesmo nome de campo para que o conversor de ida e volta permaneça com o mesmo nome.
mimeType

string

Opcional. Tipo MIME IANA. Usado para renderização de ícones/prévia.