Method: projects.locations.chat

Risponde a una domanda sui dati generando uno stream di oggetti Message.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il valore principale 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),

  // 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.
}
Campi
project
(deprecated)

string

Facoltativo. Il progetto Google Cloud da utilizzare per la quota e la fatturazione.
messages[]

object (Message)

Obbligatorio. Contenuto della conversazione corrente.
credentials

object (Credentials)

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

Questo campo può essere utilizzato per fornire le credenziali per varie origini dati. Ad esempio, quando si esegue la connessione a Looker, al momento 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 ragionamento da utilizzare per il loop dell'agente. Se non specificato, il valore predefinito è THINKING_MODE_UNSPECIFIED.
Campo unione context_provider. Fornitore di contesto per la richiesta di chat. Può essere - inline_context, ovvero un contesto fornito in linea nella richiesta. data_agent, ovvero un riferimento a una risorsa agente dati. 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 questa opzione 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 e a un contesto dell'agente persistenti. Utilizza questa opzione per chattare con un agente utilizzando la persistenza della conversazione gestita.
dataAgentContext

object (DataAgentContext)

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

object (ClientManagedResourceContext)

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

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene uno stream di istanze di 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 e a un contesto dell'agente persistenti.

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

string

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

object (DataAgentContext)

Obbligatorio. Contesto per la richiesta di chat utilizzando un agente dati.

DataAgentContext

Contesto per la 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 agente dati.
credentials

object (Credentials)

Facoltativo. Le credenziali da utilizzare quando si chiama l'origine dati Looker.

Al momento supporta sia le credenziali basate su token OAuth sia quelle basate su 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. Questo per mantenere il controllo delle versioni per l'agente dati.

Enum
CONTEXT_VERSION_UNSPECIFIED Non specificato o non riconosciuto.
STAGING Utilizzando questa versione, DCS utilizzerà l'ultimo contesto di staging 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 client 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 per la richiesta di chat. Utilizza questa opzione per chattare senza la persistenza della conversazione e dell'agente gestita dall'API GDA passando tutto il contesto in linea.
conversationId

string

Facoltativo. L'ID conversazione gestito dal cliente.
agentId

string

Facoltativo. L'ID agente gestito dal cliente.

ThinkingMode

Modalità di ragionamento per l'agente.

Enum
THINKING_MODE_UNSPECIFIED Modalità di ragionamento non specificata, l'agente utilizzerà la modalità THINKING per impostazione predefinita.
FAST Modalità veloce, risponde rapidamente.
THINKING Modalità di ragionamento, risolve problemi complessi.