Method: projects.locations.chat

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

HTTP-Anfrage

POST https://geminidataanalytics.googleapis.com/v1alpha/{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),

  // 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.
}
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 Datenquelle(n) verwendet werden sollen.

In diesem Feld können Anmeldedaten für verschiedene Datenquellen angegeben werden. Wenn Sie beispielsweise eine Verbindung zu Looker herstellen, werden derzeit Anmeldedaten auf Basis von OAuth-Tokens und API-Schlüssel unterstützt, wie unter Authentifizierung mit einem SDK beschrieben.
thinkingMode

enum (ThinkingMode)

Optional. Der Thinking-Modus, der für den Agent-Loop verwendet werden soll. Wenn keine Angabe erfolgt, wird standardmäßig THINKING_MODE_UNSPECIFIED verwendet.
model

enum (Model)

Optional. Das Modell, das für die Agentschleife bei der Verarbeitung der Anfrage verwendet werden soll. Diese Einstellung hat nur Auswirkungen, wenn „context.options.model“ nicht festgelegt ist.
Union-Feld context_provider. 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“. Für context_provider ist nur einer der folgenden Werte zulässig:
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.
Union-Feld datasource_settings. Optionale Einstellungen zum Anpassen des Anfrageverhaltens, die für die Zieldatenquelle spezifisch sind. Für datasource_settings ist nur einer der folgenden Werte zulässig:
lookerSettings

object (LookerSettings)

Optional. Looker-spezifische Einstellungen.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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. Veraltet: Anmeldedaten in ChatRequest verwenden. 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 mit Looker-spezifischen benutzerdefinierten Einstellungen.

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

boolean

Optional. Gibt an, ob der Entwicklermodus von Looker verwendet werden soll. Wenn „true“ festgelegt ist, wird die API-Sitzung in den „dev“-Arbeitsbereich verschoben, 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

Denkweise des KI-Agenten.

Enums
THINKING_MODE_UNSPECIFIED Nicht angegebener Denkmodus. Der Agent verwendet standardmäßig den THINKING-Modus, mit Ausnahme von BigQuery-Nutzern, für die standardmäßig der FAST-Modus verwendet wird.
FAST Schnellmodus: Antworten werden schnell generiert.
THINKING Denkmodus, löst komplexe Probleme.

Modell

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

Enums
MODEL_UNSPECIFIED Es wurde kein Modell angegeben. Es kann entweder ein Vorschaumodell oder ein anderes Modell verwendet werden.
LATEST_GA_MODEL Verwenden Sie das aktuelle Modell, das keine Vorabversion ist. Dadurch können bestimmte Einstellungen auf Anfrageebene eingeschränkt werden.