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/v1beta/{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)
    }
  ],

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

string

Facultatif. Le projet Google Cloud à utiliser pour le quota et la facturation.
messages[]

object (Message)

Obligatoire. Contenu de la conversation en cours.
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.

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

object (Credentials)

Facultatif. 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.