Method: projects.locations.chat

Beantwortet eine Datenfrage, indem ein Stream von Message-Objekten generiert wird.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Pflichtangabe. Der übergeordnete Wert für die Chatanfrage. Muster: projects/{project}/locations/{location}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "inlineContext": {
    object (Context)
  },
  "conversationReference": {
    object (ConversationReference)
  },
  "dataAgentContext": {
    object (DataAgentContext)
  },
  "clientManagedResourceContext": {
    object (ClientManagedResourceContext)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lookerSettings": {
    object (LookerSettings)
  }
  // End of mutually exclusive fields.
}
Felder
project
(deprecated)

string

Optional. Nicht mehr unterstützt: Verwenden Sie stattdessen das Feld parent. Das Google Cloud-Projekt, das für Kontingente und Abrechnung verwendet werden soll.
messages[]

object (Message)

Pflichtangabe. Inhalt der aktuellen Unterhaltung.
credentials

object (Credentials)

Optional. Die Anmeldedaten, die beim Aufrufen der im Kontext angegebenen Datenquellen verwendet werden sollen.

Mit diesem Feld können Anmeldedaten für verschiedene Datenquellen angegeben werden. Wenn Sie beispielsweise eine Verbindung zu Looker herstellen, werden derzeit sowohl OAuth-Token als auch Anmeldedaten auf API-Schlüsselbasis unterstützt, wie unter Authentifizierung mit einem SDK beschrieben.
thinkingMode

enum (ThinkingMode)

Optional. Der Thinking-Modus, der für die Agentenschleife verwendet werden soll. Wenn keine Angabe gemacht wird, ist der Standardwert THINKING_MODE_UNSPECIFIED.
model

enum (Model)

Optional. Das Modell, das für die Agentenschleife bei der Verarbeitung der Anfrage verwendet werden soll. Diese Einstellung hat nur Auswirkungen, wenn „context.options.model“ nicht festgelegt ist.
Kontextanbieter für die Chatanfrage. Es kann entweder „inline_context“ sein, ein Kontext, der inline in der Anfrage bereitgestellt wird, „data_agent“, ein Verweis auf eine KI-Datenagenten-Ressource, oder „conversation_reference“, ein Verweis auf eine persistente Unterhaltung und einen Kontext mit „conversation_id“ und „agent_id“. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
inlineContext

object (Context)

Optional. Inline-Kontext für die Chatanfrage. Damit können Sie zustandslos chatten (ohne verwaltete Unterhaltungspersistenz und ohne Agenten), indem Sie den gesamten Kontext inline übergeben.
conversationReference

object (ConversationReference)

Optional. Verweis auf eine persistente Unterhaltung und einen persistenten KI-Agentenkontext. Verwenden Sie diesen Wert, um mit einem KI-Agenten zu chatten und dabei die verwaltete Unterhaltungspersistenz zu nutzen.
dataAgentContext

object (DataAgentContext)

Optional. Kontext für die Chatanfrage. Damit können Sie zustandslos mit einem KI-Agenten ohne verwaltete Unterhaltungspersistenz chatten.
clientManagedResourceContext

object (ClientManagedResourceContext)

Optional. Kontext mit kundenverwalteten Ressourcen. Einige Kunden verwenden möglicherweise keine von GDA verwalteten Ressourcen wie Unterhaltungen und KI-Agenten, sondern erstellen und verwalten eigene Unterhaltungs- und KI-Agentenressourcen.
Ende der sich gegenseitig ausschließenden Felder.
Optionale Einstellungen zum Anpassen des Anfrageverhaltens, die für die Zieldatenquelle spezifisch sind. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
lookerSettings

object (LookerSettings)

Optional. Looker-spezifische Einstellungen.
Ende der sich gegenseitig ausschließenden Felder.

Antworttext

Bei Erfolg enthält der Antworttext einen Stream von Message-Instanzen.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

ConversationReference

Verweis auf eine persistente Unterhaltung und einen persistenten KI-Agentenkontext.

JSON-Darstellung 
{
  "conversation": string,
  "dataAgentContext": {
    object (DataAgentContext)
  }
}
Felder
conversation

string

Pflichtangabe. Name der Unterhaltungsressource. Format: projects/{project}/locations/{location}/conversations/{conversationId}
dataAgentContext

object (DataAgentContext)

Pflichtangabe. Kontext für die Chatanfrage mit einem KI-Datenagenten.

DataAgentContext

Kontext für die Chatanfrage mit einem KI-Datenagenten.

JSON-Darstellung 
{
  "dataAgent": string,
  "credentials": {
    object (Credentials)
  },
  "contextVersion": enum (ContextVersion)
}
Felder
dataAgent

string

Pflichtangabe. Der Name der KI-Datenagenten-Ressource.
credentials
(deprecated)

object (Credentials)

Optional. Verworfen: Verwenden Sie Anmeldedaten in ChatRequest. Die Anmeldedaten, die beim Aufrufen der Looker-Datenquelle verwendet werden sollen.

Derzeit werden sowohl OAuth-Token als auch Anmeldedaten auf API-Schlüsselbasis unterstützt, wie unter Authentifizierung mit einem SDK beschrieben.
contextVersion

enum (ContextVersion)

Optional. Version des Kontexts, der von DCS verwendet werden soll (z. B. STAGING, PUBLISHED)

ContextVersion

Liste der von DCS unterstützten Kontextversionen. Es gibt zwei Versionen von Kontext. So wird die Versionsverwaltung für den KI-Datenagenten beibehalten.

Enums
CONTEXT_VERSION_UNSPECIFIED Nicht angegeben oder nicht erkannt.
STAGING Bei Verwendung dieser Version wird für den KI-Datenagenten der aktuelle Staging-Kontext verwendet.
PUBLISHED Bei Verwendung dieser Version wird für den KI-Datenagenten der zuletzt veröffentlichte Kontext verwendet.

ClientManagedResourceContext

Kontext mit kundenverwalteten Ressourcen. Einige Kunden verwenden möglicherweise keine von GDA verwalteten Ressourcen wie Unterhaltungen und KI-Agenten, sondern erstellen und verwalten eigene Unterhaltungs- und KI-Agentenressourcen.

JSON-Darstellung 
{
  "inlineContext": {
    object (Context)
  },
  "conversationId": string,
  "agentId": string
}
Felder
inlineContext

object (Context)

Pflichtangabe. Kontext für die Chatanfrage. Damit können Sie chatten, ohne dass die GDA API die Unterhaltungs- und KI-Agentenpersistenz verwaltet, indem Sie den gesamten Kontext inline übergeben.
conversationId

string

Optional. Die kundenverwaltete Unterhaltungs-ID.
agentId

string

Optional. Die kundenverwaltete KI-Agenten-ID.

LookerSettings

Nachricht für Looker-spezifische benutzerdefinierte Einstellungen.

JSON-Darstellung 
{
  "enableDevMode": boolean
}
Felder
enableDevMode

boolean

Optional. Gibt an, ob der Entwicklungsmodus von Looker verwendet werden soll. Wenn „true“ festgelegt ist, wird die API-Sitzung in den „dev“-Arbeitsbereich gewechselt, sodass Interaktionen mit LookML-Änderungen im Entwicklungszweig des Nutzers möglich sind. Wenn „false“ aktiviert ist oder die Richtlinie nicht konfiguriert ist, bleibt die Sitzung im Standardstatus (Produktionsmodus). Weitere Informationen finden Sie unter https://cloud.google.com/looker/docs/dev-mode-prod-mode.

ThinkingMode

Denkmodus für den KI-Agenten.

Enums
THINKING_MODE_UNSPECIFIED Der Standardwert. Für BigQuery- und Looker-Datenquellen verwendet der KI-Agent FAST. Für alle anderen Datenquellen verwendet der Agent THINKING.
FAST Schnellmodus: Antworten werden schnell generiert.
THINKING Thinking Mode, löst komplexe Probleme.

Modell

Modellauswahl für den Agenten für BigQuery-Nutzer.

Enums
MODEL_UNSPECIFIED Kein Modell angegeben. Es kann entweder ein Vorschaumodell oder ein Nicht-Vorschaumodell verwendet werden.
LATEST_GA_MODEL Verwenden Sie das aktuelle Modell, das keine Vorabversion ist. Dies kann bestimmte Einstellungen auf Anfrageebene einschränken.