Method: projects.locations.chat

Répond à une question sur les données en générant un flux d'objets Message.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Valeur parente pour la requête de chat. Modèle : projects/{project}/locations/{location}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
project
(deprecated)

string

Facultatif. Obsolète : utilisez plutôt le champ parent. Projet Google Cloud à utiliser pour le quota et la facturation.
messages[]

object (Message)

Obligatoire. Contenu de la conversation en cours.
credentials

object (Credentials)

Facultatif. Identifiants à utiliser lors de l'appel des sources de données spécifiées dans le contexte.

Ce champ peut être utilisé pour fournir des identifiants pour différentes sources de données. Par exemple, lors de la connexion à Looker, il est actuellement compatible avec les identifiants basés sur les jetons OAuth et les clés API, comme décrit dans Authentification avec un SDK.
thinkingMode

enum (ThinkingMode)

Facultatif. Mode de réflexion à utiliser pour la boucle de l'agent. En l'absence de spécification, la valeur par défaut est THINKING_MODE_UNSPECIFIED.
model

enum (Model)

Facultatif. Modèle à utiliser pour la boucle de l'agent lors du traitement de la requête. Ce paramètre n'a d'effet que lorsque context.options.model n'est pas défini.
Champ d'union context_provider. Fournisseur de contexte pour la requête de chat. Il peut s'agir de inline_context (un contexte intégré dans la requête), de data_agent (une référence à une ressource d'agent de données) ou de conversation_reference (une référence à une conversation et à un contexte persistants via un conversation_id et un agent_id). context_provider ne peut être qu'un des éléments suivants :
inlineContext

object (Context)

Facultatif. Contexte intégré pour la requête de chat. ll vous permet d'effectuer un chat sans état, c'est-à-dire sans persistance de la conversation gérée ni recours à un agent, en fournissant l'ensemble du contexte directement dans la requête.
conversationReference

object (ConversationReference)

Facultatif. Référence à une conversation et à un contexte d'agent persistants. Cela vous permet de discuter avec un agent à l'aide de la persistance des conversations gérée.
dataAgentContext

object (DataAgentContext)

Facultatif. Contexte de la requête de chat. Il vous permet d'effectuer un chat sans état avec un agent, sans persistance de conversation gérée.
clientManagedResourceContext

object (ClientManagedResourceContext)

Facultatif. Contexte avec des ressources gérées par le client. Certains clients peuvent ne pas utiliser les ressources gérées par GDA, y compris les conversations et les agents. Ils créent et gèrent plutôt leurs propres ressources de conversations et d'agents.
Champ d'union datasource_settings. Paramètres facultatifs permettant de personnaliser le comportement des requêtes, spécifiques à la source de données cible. datasource_settings ne peut être qu'un des éléments suivants :
lookerSettings

object (LookerSettings)

Facultatif. Paramètres spécifiques à Looker.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient un flux d'instances Message.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

ConversationReference

Référence à une conversation et à un contexte d'agent persistants.

Représentation JSON 
{
  "conversation": string,
  "dataAgentContext": {
    object (DataAgentContext)
  }
}
Champs
conversation

string

Obligatoire. Nom de la ressource de conversation. Format : projects/{project}/locations/{location}/conversations/{conversationId}
dataAgentContext

object (DataAgentContext)

Obligatoire. Contexte de la requête de chat à l'aide d'un agent de données.

DataAgentContext

Contexte de la requête de chat à l'aide d'un agent de données.

Représentation JSON 
{
  "dataAgent": string,
  "credentials": {
    object (Credentials)
  },
  "contextVersion": enum (ContextVersion)
}
Champs
dataAgent

string

Obligatoire. Nom de la ressource de l'agent de données.
credentials
(deprecated)

object (Credentials)

Facultatif. Obsolète : utilisez les identifiants dans ChatRequest. Identifiants à utiliser lors de l'appel de la source de données Looker.

Actuellement compatible avec les identifiants basés sur les jetons OAuth et les clés API, comme décrit dans Authentification avec un SDK.
contextVersion

enum (ContextVersion)

Facultatif. Version du contexte à utiliser par DCS (par exemple, PRÉPRODUCTION, PUBLIÉ)

ContextVersion

Liste des versions de contexte compatibles avec DCS. Il existe deux versions du contexte. Cela permet d'assurer la gestion des versions de l'agent de données.

Enums
CONTEXT_VERSION_UNSPECIFIED Non spécifié ou non reconnu.
STAGING Avec cette version, DCS utilise le dernier contexte de préproduction pour l'agent de données.
PUBLISHED Avec cette version, DCS utilise le dernier contexte publié pour l'agent de données.

ClientManagedResourceContext

Contexte avec des ressources gérées par le client. Certains clients peuvent ne pas utiliser les ressources gérées par GDA, y compris les conversations et les agents. Ils créent et gèrent plutôt leurs propres ressources de conversations et d'agents.

Représentation JSON 
{
  "inlineContext": {
    object (Context)
  },
  "conversationId": string,
  "agentId": string
}
Champs
inlineContext

object (Context)

Obligatoire. Contexte de la requête de chat. Il vous permet d'effectuer un chat sans persistance de la conversation ni de l'agent gérées par l'API GDA, en fournissant l'ensemble du contexte directement dans la requête.
conversationId

string

Facultatif. ID de conversation géré par le client.
agentId

string

Facultatif. ID de l'agent géré par le client.

LookerSettings

Message permettant de conserver les paramètres personnalisés spécifiques à Looker.

Représentation JSON 
{
  "enableDevMode": boolean
}
Champs
enableDevMode

boolean

Facultatif. Indique si l'opération doit être effectuée en mode Développement de Looker. Si la valeur est "true", la session API sera basculée vers l'espace de travail "dev", ce qui permettra d'interagir avec les modifications LookML dans la branche de développement de l'utilisateur. Si cette règle est définie sur "false" ou n'est pas configurée, la session reste dans l'état par défaut (mode Production). Consultez https://cloud.google.com/looker/docs/dev-mode-prod-mode.

ThinkingMode

Mode de réflexion de l'agent.

Enums
THINKING_MODE_UNSPECIFIED Mode de réflexion non spécifié. L'agent utilise le mode THINKING par défaut, sauf pour les utilisateurs de BigQuery qui utilisent le mode FAST par défaut.
FAST Mode rapide, réponses rapides.
THINKING Mode Réflexion, résout des problèmes complexes.

Modèle

Sélection de modèles pour l'agent destiné aux utilisateurs BigQuery.

Enums
MODEL_UNSPECIFIED Aucun modèle spécifié. Vous pouvez utiliser un modèle preview ou non.
LATEST_GA_MODEL Utilisez le modèle non preview le plus récent. Cela peut limiter certains paramètres au niveau de la requête.