Method: projects.locations.chat

Risponde a una domanda sui dati generando un flusso di oggetti Message.

Richiesta HTTP

POST https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}:chat

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il valore della risorsa padre per la richiesta di chat. Pattern: projects/{project}/locations/{location}

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "project": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "credentials": {
    object (Credentials)
  },
  "thinkingMode": enum (ThinkingMode),
  "model": enum (Model),

  // Union field context_provider can be only one of the following:
  "inlineContext": {
    object (Context)
  },
  "conversationReference": {
    object (ConversationReference)
  },
  "dataAgentContext": {
    object (DataAgentContext)
  },
  "clientManagedResourceContext": {
    object (ClientManagedResourceContext)
  }
  // End of list of possible types for union field context_provider.

  // Union field datasource_settings can be only one of the following:
  "lookerSettings": {
    object (LookerSettings)
  }
  // End of list of possible types for union field datasource_settings.
}
Campi
project
(deprecated)

string

Facoltativo. Deprecato: utilizza invece il campo parent. Il progetto Google Cloud da utilizzare per la quota e la fatturazione.
messages[]

object (Message)

Obbligatorio. Contenuti della conversazione corrente.
credentials

object (Credentials)

Facoltativo. Le credenziali da utilizzare quando chiami le origini dati specificate nel contesto.

Questo campo può essere utilizzato per fornire le credenziali per varie origini dati. Ad esempio, quando si connette a Looker, attualmente supporta sia le credenziali basate su token OAuth sia quelle basate su chiave API, come descritto in Autenticazione con un SDK.
thinkingMode

enum (ThinkingMode)

Facoltativo. La modalità di pensiero da utilizzare per il ciclo dell'agente. Se non specificato, il valore predefinito è THINKING_MODE_UNSPECIFIED.
model

enum (Model)

Facoltativo. Il modello da utilizzare per il ciclo dell'agente durante l'elaborazione della richiesta. Questa impostazione ha effetto solo quando context.options.model non è impostato.
Campo unione context_provider. Fornitore di contesto per la richiesta di chat. Può essere inline_context, ovvero un contesto fornito inline nella richiesta, data_agent, ovvero un riferimento a una risorsa data_agent, o conversation_reference, ovvero un riferimento a una conversazione e a un contesto persistenti utilizzando conversation_id e agent_id. context_provider può essere solo uno dei seguenti tipi:
inlineContext

object (Context)

Facoltativo. Contesto in linea per la richiesta di chat. Utilizza questo strumento per chattare senza stato (senza persistenza della conversazione gestita e senza un agente) passando tutto il contesto in linea.
conversationReference

object (ConversationReference)

Facoltativo. Riferimento a una conversazione persistente e al contesto dell'agente. Utilizzalo per chattare con un agente utilizzando la persistenza delle conversazioni gestita.
dataAgentContext

object (DataAgentContext)

Facoltativo. Contesto della richiesta di chat. Utilizza questo strumento per chattare con un agente senza stato, senza persistenza della conversazione gestita.
clientManagedResourceContext

object (ClientManagedResourceContext)

Facoltativo. Contesto con risorse gestite dal cliente. Alcuni clienti potrebbero non utilizzare le risorse gestite da GDA, tra cui conversazioni e agenti, ma creare e gestire le proprie risorse di conversazioni e agenti.
Campo unione datasource_settings. Impostazioni facoltative per personalizzare il comportamento delle richieste, specifiche per l'origine dati di destinazione. datasource_settings può essere solo uno dei seguenti tipi:
lookerSettings

object (LookerSettings)

Facoltativo. Impostazioni specifiche di Looker.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un flusso di istanze Message.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.

ConversationReference

Riferimento a una conversazione persistente e al contesto dell'agente.

Rappresentazione JSON 
{
  "conversation": string,
  "dataAgentContext": {
    object (DataAgentContext)
  }
}
Campi
conversation

string

Obbligatorio. Nome della risorsa conversazione. Formato: projects/{project}/locations/{location}/conversations/{conversationId}
dataAgentContext

object (DataAgentContext)

Obbligatorio. Contesto della richiesta di chat utilizzando un agente dati.

DataAgentContext

Contesto della richiesta di chat utilizzando un agente dati.

Rappresentazione JSON 
{
  "dataAgent": string,
  "credentials": {
    object (Credentials)
  },
  "contextVersion": enum (ContextVersion)
}
Campi
dataAgent

string

Obbligatorio. Il nome della risorsa dell'agente di dati.
credentials
(deprecated)

object (Credentials)

Facoltativo. Ritirato: utilizza le credenziali in ChatRequest. Le credenziali da utilizzare quando viene chiamata l'origine dati Looker.

Attualmente supporta le credenziali basate su token OAuth e chiave API, come descritto in Autenticazione con un SDK.
contextVersion

enum (ContextVersion)

Facoltativo. Versione del contesto da utilizzare da DCS (ad es. STAGING, PUBLISHED)

ContextVersion

Elenco delle versioni del contesto supportate da DCS. Esistono due versioni del contesto. per mantenere il controllo delle versioni dell'agente dati.

Enum
CONTEXT_VERSION_UNSPECIFIED Non specificato o non riconosciuto.
STAGING Utilizzando questa versione, DCS utilizzerà il contesto di staging più recente per l'agente dati.
PUBLISHED Utilizzando questa versione, DCS utilizzerà l'ultimo contesto pubblicato per l'agente dati.

ClientManagedResourceContext

Contesto con risorse gestite dal cliente. Alcuni clienti potrebbero non utilizzare le risorse gestite da GDA, tra cui conversazioni e agenti, ma creare e gestire le proprie risorse di conversazioni e agenti.

Rappresentazione JSON 
{
  "inlineContext": {
    object (Context)
  },
  "conversationId": string,
  "agentId": string
}
Campi
inlineContext

object (Context)

Obbligatorio. Contesto della richiesta di chat. Utilizza questo metodo per chattare senza la conversazione gestita dall'API GDA e la persistenza dell'agente passando tutto il contesto inline.
conversationId

string

Facoltativo. L'ID conversazione gestita dal cliente.
agentId

string

Facoltativo. L'ID agente gestito dal cliente.

LookerSettings

Messaggio per contenere le impostazioni personalizzate specifiche di Looker.

Rappresentazione JSON 
{
  "enableDevMode": boolean
}
Campi
enableDevMode

boolean

Facoltativo. Se operare in modalità di sviluppo di Looker. Se è true, la sessione API verrà spostata nell'area di lavoro "dev", consentendo l'interazione con le modifiche LookML nel ramo di sviluppo dell'utente. Se il valore è false o non viene impostato, la sessione rimane nello stato predefinito (modalità di produzione). Consulta la pagina https://cloud.google.com/looker/docs/dev-mode-prod-mode.

ThinkingMode

Modalità di pensiero dell'agente.

Enum
THINKING_MODE_UNSPECIFIED Modalità di pensiero non specificata. L'agente utilizzerà la modalità THINKING per impostazione predefinita, ad eccezione degli utenti BigQuery che utilizzano la modalità FAST per impostazione predefinita.
FAST Modalità veloce, risposte rapide.
THINKING Modalità di pensiero, risolve problemi complessi.

Modello

Selezione del modello per l'agente per gli utenti BigQuery.

Enum
MODEL_UNSPECIFIED Nessun modello specificato. È possibile utilizzare il modello di anteprima o non di anteprima.
LATEST_GA_MODEL Utilizza il modello non di anteprima più aggiornato. Ciò potrebbe limitare alcune impostazioni a livello di richiesta.