Message

Un messaggio proveniente da un'interazione tra l'utente e il sistema.

Rappresentazione JSON 
{
  "timestamp": string,
  "messageId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userMessage": {
    object (UserMessage)
  },
  "systemMessage": {
    object (SystemMessage)
  }
  // End of mutually exclusive fields.
}
Campi
timestamp

string (Timestamp format)

Solo output. Per i messaggi degli utenti, questo è il momento in cui il sistema ha ricevuto il messaggio. Per i messaggi di sistema, questo è il momento in cui il sistema ha generato il messaggio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
messageId

string

(Facoltativo) ID univoco del messaggio nella conversazione per la persistenza.
Il tipo di messaggio. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
userMessage

object (UserMessage)

Un messaggio dell'utente che interagisce con il sistema.
systemMessage

object (SystemMessage)

Un messaggio del sistema in risposta all'utente.
Fine dei campi che si escludono a vicenda.

UserMessage

Un messaggio dell'utente che interagisce con il sistema.

Rappresentazione JSON 
{

  // 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.
}
Campi
Il tipo di contenuti nel messaggio dell'utente. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
text

string

Il testo deve utilizzare questo campo anziché il blob.
Fine dei campi che si escludono a vicenda.

SystemMessage

Un messaggio del sistema in risposta all'utente. Questo messaggio può anche essere un messaggio dell'utente come contesto storico per le conversazioni multi-turn con il sistema.

Rappresentazione JSON 
{
  "citation": {
    object (Citation)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": {
    object (TextMessage)
  },
  "schema": {
    object (SchemaMessage)
  },
  "data": {
    object (DataMessage)
  },
  "analysis": {
    object (AnalysisMessage)
  },
  "chart": {
    object (ChartMessage)
  },
  "error": {
    object (ErrorMessage)
  },
  "exampleQueries": {
    object (ExampleQueries)
  }
  // End of mutually exclusive fields.
  "groupId": integer
}
Campi
citation

object (Citation)

Solo output. Informazioni sulla citazione per il messaggio di sistema.
Il tipo di contenuti nel messaggio di sistema. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
text

object (TextMessage)

Una risposta diretta in linguaggio naturale al messaggio dell'utente.
schema

object (SchemaMessage)

Un messaggio prodotto durante la risoluzione dello schema.
data

object (DataMessage)

Un messaggio prodotto durante il recupero dei dati.
analysis

object (AnalysisMessage)

Un messaggio prodotto durante l'analisi.
chart

object (ChartMessage)

Un messaggio prodotto durante la generazione del grafico.
error

object (ErrorMessage)

Un messaggio di errore.
exampleQueries

object (ExampleQueries)

Facoltativo. Un messaggio contenente query di esempio.
Fine dei campi che si escludono a vicenda.
groupId

integer

Identifica il gruppo a cui appartiene l'evento. Gli eventi simili sono considerati logicamente pertinenti tra loro e devono essere mostrati insieme nell'interfaccia utente.

TextMessage

Un messaggio di testo in più parti.

Rappresentazione JSON 
{
  "parts": [
    string
  ],
  "textType": enum (TextType),
  "thoughtSignature": string
}
Campi
parts[]

string

Facoltativo. Le parti del messaggio.
textType

enum (TextType)

Facoltativo. Il tipo di messaggio.
thoughtSignature

string (bytes format)

Facoltativo. Una firma opaca per un pensiero, in modo che possa essere riutilizzata nelle richieste successive.

Una stringa con codifica in base64.

TextType

Il tipo di messaggio.

Enum
TEXT_TYPE_UNSPECIFIED Il tipo di testo predefinito.
FINAL_RESPONSE Il testo è una risposta definitiva alla domanda dell'utente.
THOUGHT Il testo è un pensiero del modello.
PROGRESS Il testo è un messaggio informativo sullo stato di avanzamento dell'agente, ad esempio uno strumento richiamato. Questi messaggi sono diversi dal processo di pensiero interno dell'agente (THOUGHT) e dalla risposta finale all'utente (FINAL_RESPONSE). Forniscono informazioni sulle azioni dell'agente.
FOLLOWUP_QUESTIONS Il testo è un elenco di domande aggiuntive suggerite. Ogni elemento in parti è una domanda di follow-up.

SchemaMessage

Un messaggio prodotto durante la risoluzione dello schema.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "query": {
    object (SchemaQuery)
  },
  "result": {
    object (SchemaResult)
  }
  // End of mutually exclusive fields.
}
Campi
Indica se questo messaggio contiene la query o il risultato della risoluzione dello schema. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
query

object (SchemaQuery)

Una query di risoluzione dello schema.
result

object (SchemaResult)

Il risultato di una query di risoluzione dello schema.
Fine dei campi che si escludono a vicenda.

SchemaQuery

Una query per risolvere lo schema pertinente alla domanda posta.

Rappresentazione JSON 
{
  "question": string
}
Campi
question

string

Facoltativo. La domanda da inviare al sistema per la risoluzione dello schema.

SchemaResult

Il risultato della risoluzione dello schema.

Rappresentazione JSON 
{
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
Campi
datasources[]

object (Datasource)

Facoltativo. Le origini dati utilizzate per risolvere la query dello schema.

Origine dati

Un'origine dati che può essere utilizzata per rispondere alle domande.

Rappresentazione JSON 
{
  "schema": {
    object (Schema)
  },
  "structSchema": {
    object
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bigqueryTableReference": {
    object (BigQueryTableReference)
  },
  "studioDatasourceId": string,
  "lookerExploreReference": {
    object (LookerExploreReference)
  },
  "bigqueryPropertyGraphReference": {
    object (BigQueryPropertyGraphReference)
  }
  // End of mutually exclusive fields.
}
Campi
schema

object (Schema)

Facoltativo. Lo schema dell'origine dati.
structSchema

object (Struct format)

Facoltativo. Una rappresentazione struct dello schema. Questo campo viene compilato per le origini dati con schemi che non possono essere rappresentati completamente dal campo schema con tipo di dati definito.

Per le origini dati Looker, questo corrisponde al tipo LookmlModelExplore: https://cloud.google.com/looker/docs/reference/looker-api/latest/types/LookmlModelExplore
Il riferimento all'origine dati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
bigqueryTableReference

object (BigQueryTableReference)

Un riferimento a una tabella BigQuery.
studioDatasourceId

string

Un riferimento a un'origine dati di Looker Studio.
lookerExploreReference

object (LookerExploreReference)

Un riferimento a un'esplorazione di Looker.
bigqueryPropertyGraphReference

object (BigQueryPropertyGraphReference)

Un riferimento a un grafico delle proprietà BigQuery.
Fine dei campi che si escludono a vicenda.

DataMessage

Un messaggio prodotto durante il recupero dei dati.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "query": {
    object (DataQuery)
  },
  "generatedSql": string,
  "result": {
    object (DataResult)
  },
  "bigQueryJob": {
    object (BigQueryJob)
  },
  "matchedQuery": {
    object (MatchedQuery)
  }
  // End of mutually exclusive fields.
}
Campi
Indica se questo messaggio contiene la query, il risultato o l'SQL generato per il recupero dei dati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
query

object (DataQuery)

Una query di recupero dei dati.
generatedSql

string

SQL generato dal sistema per recuperare i dati.
result

object (DataResult)

Dati recuperati.
bigQueryJob

object (BigQueryJob)

Un job BigQuery eseguito dal sistema per recuperare i dati.
matchedQuery

object (MatchedQuery)

Una query preesistente a cui è stata trovata una corrispondenza per recuperare i dati.
Fine dei campi che si escludono a vicenda.

DataQuery

Una query per recuperare i dati.

Rappresentazione JSON 
{
  "question": string,
  "name": string,
  "datasources": [
    {
      object (Datasource)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "looker": {
    object (LookerQuery)
  }
  // End of mutually exclusive fields.
}
Campi
question

string

Facoltativo. Una domanda in linguaggio naturale a cui rispondere.
name

string

Facoltativo. Un nome in snake case per la query che riflette il suo intent. Viene utilizzato per denominare il risultato dei dati corrispondente, in modo che possa essere referenziato nei passaggi successivi.

  • Esempio: "total_sales_by_product"
  • Esempio: "sales_for_product_12345"
datasources[]

object (Datasource)

Facoltativo. Le origini dati disponibili per rispondere alla domanda.
Il tipo di query da eseguire. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
looker

object (LookerQuery)

Facoltativo. Una query per recuperare i dati da un'esplorazione di Looker.
Fine dei campi che si escludono a vicenda.

DataResult

Dati recuperati.

Rappresentazione JSON 
{
  "name": string,
  "schema": {
    object (Schema)
  },
  "data": [
    {
      object
    }
  ],
  "formattedData": [
    {
      object
    }
  ]
}
Campi
name

string

Facoltativo. Un nome in snake case per il risultato dei dati che riflette i suoi contenuti. Il nome viene utilizzato per passare il risultato per riferimento e funge da indicatore del suo significato.

  • Esempio: "total_sales_by_product"
  • Esempio: "sales_for_product_12345"
schema

object (Schema)

Facoltativo. Lo schema dei dati.
data[]

object (Struct format)

Facoltativo. Il contenuto dei dati. Ogni riga è una struttura che corrisponde allo schema. I valori semplici sono rappresentati come stringhe, mentre le strutture nidificate sono rappresentate come elenchi o struct.
formattedData[]

object (Struct format)

Facoltativo. Rappresentazione formattata dei dati, se applicabile. Ogni riga è una struttura che corrisponde direttamente alla riga con lo stesso indice all'interno del campo data. I suoi valori sono rappresentazioni stringa dei dati originali, formattati in base alle specifiche dell'origine dati (ad es. "1.234,56 $" per la valuta). Le colonne senza formattazione verranno impostate per impostazione predefinita sulla rappresentazione del valore non elaborato. Se nessuna colonna ha regole di formattazione, questo campo sarà vuoto.

BigQueryJob

Un job BigQuery eseguito dal sistema.

Rappresentazione JSON 
{
  "projectId": string,
  "jobId": string,
  "location": string,
  "destinationTable": {
    object (BigQueryTableReference)
  },
  "schema": {
    object (Schema)
  }
}
Campi
projectId

string

Obbligatorio. Il progetto a cui appartiene il job.

Vedi JobReference.
jobId

string

Obbligatorio. L'ID del job.

Vedi JobReference.
location

string

Facoltativo. La sede di lavoro.

Vedi JobReference.
destinationTable

object (BigQueryTableReference)

Facoltativo. Un riferimento alla tabella di destinazione dei risultati della query del job.

Consulta JobConfigurationQuery.
schema

object (Schema)

Facoltativo. Lo schema dei risultati della query del job.

Vedi JobStatistics2.

MatchedQuery

Un messaggio di query corrispondente indica che l'agente ha trovato una delle query di esempio fornite nel contesto come applicabile alla domanda corrente. Conterrà anche informazioni aggiuntive durante la procedura di corrispondenza.

Rappresentazione JSON 
{
  "exampleQuery": {
    object (ExampleQuery)
  },
  "queryParameterValues": [
    {
      object (QueryParameterValues)
    }
  ]
}
Campi
exampleQuery

object (ExampleQuery)

La query che è stata abbinata in base a una query di esempio.
queryParameterValues[]

object (QueryParameterValues)

I valori estratti per i parametri di ricerca.

QueryParameterValues

Un messaggio con i valori dei parametri di query rappresenta i valori dei parametri di ricerca estratti dalla domanda dell'utente dal LLM, in base alla query di esempio.

Rappresentazione JSON 
{
  "name": string,
  "value": string
}
Campi
name

string

Obbligatorio. Il nome del parametro.
value

string

Obbligatorio. Il valore del parametro.

AnalysisMessage

Un messaggio prodotto durante l'analisi.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "query": {
    object (AnalysisQuery)
  },
  "progressEvent": {
    object (AnalysisEvent)
  }
  // End of mutually exclusive fields.
}
Campi
Indica se questo messaggio contiene la query o uno degli eventi dell'analisi. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
query

object (AnalysisQuery)

Una query di analisi.
progressEvent

object (AnalysisEvent)

Un evento che indica l'avanzamento dell'analisi.
Fine dei campi che si escludono a vicenda.

AnalysisQuery

Una query per eseguire un'analisi.

Rappresentazione JSON 
{
  "question": string,
  "dataResultNames": [
    string
  ]
}
Campi
question

string

Facoltativo. Una domanda di analisi per rispondere alla domanda originale dell'utente.
dataResultNames[]

string

Facoltativo. I nomi dei risultati dei dati recuperati in precedenza da analizzare.

AnalysisEvent

Un evento che indica l'avanzamento di un'analisi.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "plannerReasoning": string,
  "coderInstruction": string,
  "code": string,
  "executionOutput": string,
  "executionError": string,
  "resultVegaChartJson": string,
  "resultNaturalLanguage": string,
  "resultCsvData": string,
  "resultReferenceData": string,
  "error": string
  // End of mutually exclusive fields.
}
Campi
Il tipo di evento che si è verificato durante l'analisi. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
plannerReasoning

string

Motivazione del pianificatore di generazione del codice Python.
coderInstruction

string

Istruzioni emesse per la generazione del codice.
code

string

Codice generato.
executionOutput

string

Output dell'esecuzione del codice.
executionError

string

Un errore di esecuzione del codice.
resultVegaChartJson

string

Risultato come stringa JSON del grafico Vega.
resultNaturalLanguage

string

Risultato come stringa NL.
resultCsvData

string

Risultato come stringa CSV.
resultReferenceData

string

Risultato come riferimento a un'origine dati.
error

string

Un messaggio di errore generico.
Fine dei campi che si escludono a vicenda.

ChartMessage

Un messaggio prodotto durante la generazione del grafico.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "query": {
    object (ChartQuery)
  },
  "result": {
    object (ChartResult)
  }
  // End of mutually exclusive fields.
}
Campi
Indica se questo messaggio contiene la query o il risultato della generazione del grafico. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
query

object (ChartQuery)

Una query per generare un grafico.
result

object (ChartResult)

Il risultato di una query di generazione del grafico.
Fine dei campi che si escludono a vicenda.

ChartQuery

Una query per generare un grafico.

Rappresentazione JSON 
{
  "instructions": string,
  "dataResultName": string
}
Campi
instructions

string

Facoltativo. Istruzioni in linguaggio naturale per generare il grafico.
dataResultName

string

Facoltativo. Il nome di un risultato di dati recuperato in precedenza da utilizzare nel grafico.

ChartResult

Il risultato di una query di generazione del grafico.

Rappresentazione JSON 
{
  "vegaConfig": {
    object
  },
  "image": {
    object (Blob)
  }
}
Campi
vegaConfig

object (Struct format)

Facoltativo. Una configurazione del grafico Vega generata. Consulta https://vega.github.io/vega/docs/config/
image

object (Blob)

Facoltativo. Un rendering del grafico, se richiesto nel contesto.

Blob

Un blob di dati con un tipo MIME.

Rappresentazione JSON 
{
  "mimeType": string,
  "data": string
}
Campi
mimeType

string

Obbligatorio. Il tipo MIME standard IANA dei dati del messaggio.
data

string (bytes format)

Obbligatorio. I dati rappresentati come byte.

Una stringa con codifica in base64.

ErrorMessage

Un messaggio di errore da una chiamata allo strumento. Questo messaggio viene utilizzato per rappresentare un errore che si è verificato mentre un agente tentava di utilizzare uno strumento. È importante notare che non tutti gli errori sono irreversibili. Molti sono recuperabili e l'agente può utilizzare le informazioni di questo messaggio di errore per correggersi e riprovare la chiamata allo strumento o provare un approccio diverso.

Ad esempio, se una query sui dati non va a buon fine, l'agente potrebbe ricevere un ErrorMessage, analizzarlo e poi generare una query corretta.

I client devono fare attenzione a non interpretare questo messaggio come un errore definitivo. Può far parte del normale processo iterativo dell'agente di completamento di un'attività. Mostrare questi errori direttamente agli utenti finali senza contesto (ad es. come "errore irreversibile") potrebbe essere fuorviante.

Rappresentazione JSON 
{
  "text": string
}
Campi
text

string

Solo output. Il testo dell'errore.

ExampleQueries

Un messaggio contenente query di esempio derivate e create.

Rappresentazione JSON 
{
  "exampleQueries": [
    {
      object (ExampleQuery)
    }
  ]
}
Campi
exampleQueries[]

object (ExampleQuery)

Facoltativo. Un elenco di query di esempio derivate e create, che forniscono esempi di query SQL pertinenti e di uso comune e, facoltativamente, le query in linguaggio naturale corrispondenti. Attualmente utilizzato solo per le origini dati BigQuery.

Citazione

Attribuzioni delle fonti per i contenuti.

Rappresentazione JSON 
{
  "sources": [
    {
      object (CitationSource)
    }
  ],
  "anchors": [
    {
      object (CitationAnchor)
    }
  ]
}
Campi
sources[]

object (CitationSource)

Solo output. Elenco delle fonti citate.
anchors[]

object (CitationAnchor)

Solo output. Elenco degli ancoraggi delle citazioni.

CitationSource

La fonte della citazione.

Rappresentazione JSON 
{
  "id": string,
  "title": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "uri": string,
  "exampleQuery": {
    object (ExampleQuery)
  },
  "glossaryTerm": {
    object (GlossaryTerm)
  }
  // End of mutually exclusive fields.
}
Campi
id

string

Solo output. Identificatore univoco dell'origine. Questo ID viene generato dal servizio ed è univoco nell'ambito di un singolo messaggio Citation.
title

string

Solo output. Il titolo della fonte.
La fonte della citazione, che può essere uno dei tipi supportati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
uri

string

Solo output. L'URI utilizzato come origine, ad esempio un URL di base web.
exampleQuery

object (ExampleQuery)

Solo output. La query di esempio utilizzata come origine.
glossaryTerm

object (GlossaryTerm)

Solo output. Il termine del glossario utilizzato come origine.
Fine dei campi che si escludono a vicenda.

CitationAnchor

L'ancora della citazione.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textMessageAnchor": {
    object (TextMessageCitationAnchor)
  }
  // End of mutually exclusive fields.
}
Campi
L'ancora della citazione, che può essere uno dei tipi supportati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textMessageAnchor

object (TextMessageCitationAnchor)

Solo output. Impostato solo se la citazione riguarda un TextMessage.
Fine dei campi che si escludono a vicenda.

TextMessageCitationAnchor

Ancora di citazione all'interno di un TextMessage.

Rappresentazione JSON 
{
  "partIndex": integer,
  "startOffsetBytes": integer,
  "endOffsetBytes": integer,
  "sourceIds": [
    string
  ]
}
Campi
partIndex

integer

Solo output. L'indice in base 0 della parte all'interno del campo TextMessage.parts.
startOffsetBytes

integer

Solo output. L'offset, misurato in byte UTF-8, all'interno della stringa della parte in cui inizia la citazione (inclusa). Esempio: per il testo "Hello, world" in cui è citata la parola "world", i byte di offset iniziale (inclusi) sono 7 e i byte di offset finale (esclusi) sono 12.
endOffsetBytes

integer

Solo output. L'offset, misurato in byte UTF-8, all'interno della stringa della parte in cui termina la citazione (esclusiva). Esempio: per il testo "Hello, world" in cui è citata la parola "world", i byte di offset iniziale (inclusi) sono 7 e i byte di offset finale (esclusi) sono 12.
sourceIds[]

string

Solo output. Gli ID delle fonti citate.