Method: answerQuery

Responde a uma consulta usando a geração fundamentada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "query": string,
  "filter": string
}
Campos
query

string

Obrigatório. A consulta a ser respondida.
filter

string

Opcional. Aplica um filtro restrito aos resultados da pesquisa usados para fundamentar a resposta. A expressão é compatível com um subconjunto da sintaxe descrita em https://google.aip.dev/160.

Campos compatíveis com a filtragem:

  • content_length_bytes (INTEGER): o comprimento do campo Document.content em bytes.
  • data_source (STRING): a origem do documento, por exemplo, docs.cloud.google.com. Consulte https://developers.google.com/knowledge/reference/corpus-reference para conferir a lista completa de fontes de dados no corpus.
  • update_time (TIMESTAMP): o carimbo de data/hora da última atualização significativa do documento. Uma atualização significativa é aquela que muda o conteúdo ou os metadados do documento em Markdown.
  • uri (STRING): o URI do documento, por exemplo, https://docs.cloud.google.com/bigquery/docs/tables.

Os campos INTEGER aceitam os operadores =, <, <=, > e >=.

Os campos STRING são compatíveis com os operadores = (igual a) e != (diferente de) para correspondência exata em toda a string. Não há suporte para correspondência parcial, de prefixo e de regexp.

Os campos TIMESTAMP aceitam os operadores =, <, <=, > e >=. Os carimbos de data/hora precisam estar no formato RFC-3339, por exemplo, "2025-01-01T00:00:00Z".

É possível combinar expressões usando os operadores lógicos AND, OR e NOT (ou -). OR tem precedência maior que AND. Use parênteses para agrupar precedências explícitas.

Exemplos:

  • Filtrar por Document.content_length_bytes: content_length_bytes < 50000
  • data_source = "docs.cloud.google.com" OR data_source = "firebase.google.com"
  • data_source != "firebase.google.com"
  • update_time < "2024-01-01T00:00:00Z"
  • update_time >= "2025-01-22T00:00:00Z" AND (data_source = "developer.chrome.com" OR data_source = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

A string filter não pode exceder 500 caracteres. Valores maiores que isso resultam em um erro INVALID_ARGUMENT.

Corpo da resposta

Mensagem de resposta para DeveloperKnowledge.AnswerQuery.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "answer": {
    object (Answer)
  }
}
Campos
answer

object (Answer)

A resposta à consulta.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

Resposta

Uma resposta a uma consulta.

Representação JSON 
{
  "answerText": string,
  "citations": [
    {
      object (AnswerCitation)
    }
  ],
  "references": [
    {
      object (AnswerReference)
    }
  ]
}
Campos
answerText

string

Contém o texto da resposta.
citations[]

object (AnswerCitation)

Apenas saída. Contém citações para a resposta.
references[]

object (AnswerReference)

Apenas saída. Contém referências para a resposta.

AnswerCitation

Informações de citação para um segmento.

Representação JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
Campos
startIndex

integer

Apenas saída. Indica o início do segmento, medido em bytes (Unicode UTF-8), inclusive. Se houver caracteres multibyte, como não ASCII, a medição do índice será maior que o comprimento da string.
endIndex

integer

Apenas saída. Indica o fim do segmento, medido em bytes (Unicode UTF-8), exclusivo. Se houver caracteres multibyte, como não ASCII, a medição do índice será maior que o comprimento da string.
sources[]

object (CitationSource)

Apenas saída. Contém fontes de citação para o segmento atribuído.

CitationSource

Fonte da citação.

Representação JSON 
{
  "referenceIndex": integer
}
Campos
referenceIndex

integer

Apenas saída. Contém o índice do Answer.AnswerReference no campo repetido references.

AnswerReference

Representa uma referência a uma fonte.

Representação JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "documentReference": {
    object (DocumentReference)
  }
  // End of mutually exclusive fields.
}
Campos
Contém o conteúdo da referência. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
documentReference

object (DocumentReference)

Apenas saída. O documento de referência.
Fim dos campos mutuamente exclusivos.

DocumentReference

Representa uma referência a um documento.

Representação JSON 
{
  "documentChunk": {
    object (DocumentChunk)
  }
}
Campos
documentChunk

object (DocumentChunk)

Apenas saída. Contém o trecho do documento. O campo documentChunk.id não está definido e vai ficar vazio.