Method: answerQuery

Risponde a una query utilizzando la generazione basata su dati di base.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "query": string
}
Campi
query

string

Obbligatorio. La query a cui rispondere.

Corpo della risposta

Messaggio di risposta per DeveloperKnowledge.AnswerQuery.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "answer": {
    object (Answer)
  }
}
Campi
answer

object (Answer)

La risposta alla query.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

Risposta

Una risposta a una query.

Rappresentazione JSON
{
  "answerText": string,
  "citations": [
    {
      object (AnswerCitation)
    }
  ],
  "references": [
    {
      object (AnswerReference)
    }
  ]
}
Campi
answerText

string

Contiene il testo della risposta.

citations[]

object (AnswerCitation)

Solo output. Contiene le citazioni per la risposta.

references[]

object (AnswerReference)

Solo output. Contiene i riferimenti per la risposta.

AnswerCitation

Informazioni sulla citazione per un segmento.

Rappresentazione JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
Campi
startIndex

integer

Solo output. Indica l'inizio del segmento, misurato in byte (Unicode UTF-8), inclusivo. Se sono presenti caratteri multibyte, ad esempio caratteri non ASCII, la misurazione dell'indice è più lunga della lunghezza della stringa.

endIndex

integer

Solo output. Indica la fine del segmento, misurato in byte (Unicode UTF-8), esclusivo. Se sono presenti caratteri multibyte, ad esempio caratteri non ASCII, la misurazione dell'indice è più lunga della lunghezza della stringa.

sources[]

object (CitationSource)

Solo output. Contiene le origini delle citazioni per il segmento attribuito.

CitationSource

Origine della citazione.

Rappresentazione JSON
{
  "referenceIndex": integer
}
Campi
referenceIndex

integer

Solo output. Contiene l'indice di Answer.AnswerReference nel campo ripetuto references.

AnswerReference

Rappresenta un riferimento a un'origine.

Rappresentazione JSON
{

  // Union field content can be only one of the following:
  "documentReference": {
    object (DocumentReference)
  }
  // End of list of possible types for union field content.
}
Campi
Campo unione content. Contiene il contenuto del riferimento. content può essere solo uno dei seguenti tipi:
documentReference

object (DocumentReference)

Solo output. Il documento di riferimento.

DocumentReference

Rappresenta un riferimento a un documento.

Rappresentazione JSON
{
  "documentChunk": {
    object (DocumentChunk)
  }
}
Campi
documentChunk

object (DocumentChunk)

Solo output. Contiene il blocco di documenti. Il campo documentChunk.id non è impostato e sarà vuoto.