Gemini API

Die Gemini Interactions API ist eine experimentelle API, mit der Entwickler generative KI-Anwendungen mit Gemini-Modellen erstellen können. Gemini ist unser leistungsstärkstes Modell, das von Grund auf multimodal konzipiert wurde. Es kann generalisieren und problemlos verschiedene Arten von Informationen wie Sprache, Bilder, Audio, Video und Code verstehen, verarbeiten und kombinieren. Sie können die Gemini API für Anwendungsfälle wie das Ableiten von Text und Bildern, die Generierung von Inhalten, Dialog-Agents, Zusammenfassungs- und Klassifizierungssysteme und vieles mehr verwenden.

Als Markdown ansehen OpenAPI-Spezifikation ansehen

CreateWebhook

post https://generativelanguage.googleapis.com/v1beta/webhooks

Erstellt einen neuen Webhook.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

name string  (optional)

Optional. Der vom Nutzer angegebene Name des Webhooks.

uri string  (erforderlich)

Erforderlich. Der URI, an den Webhook-Ereignisse gesendet werden.

subscribed_events Array (Objekt oder String)  (erforderlich)

Erforderlich. Die Ereignisse, für die der Webhook abonniert ist. Verfügbare Ereignisse: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

Antwort

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

name string  (optional)

Optional. Der vom Nutzer angegebene Name des Webhooks.

uri string  (optional)

Erforderlich. Der URI, an den Webhook-Ereignisse gesendet werden.

subscribed_events Array (Objekt oder String)  (optional)

Erforderlich. Die Ereignisse, für die der Webhook abonniert ist. Verfügbare Ereignisse: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time string  (optional)

Nur Ausgabe. Der Zeitstempel für die Erstellung des Webhooks.

update_time string  (optional)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Webhook zuletzt aktualisiert wurde.

signing_secrets SigningSecret  (optional)

Nur Ausgabe. Die mit diesem Webhook verknüpften Signatur-Secrets.

Stellt ein Signierungs-Secret dar, das zum Überprüfen von Webhook-Nutzlasten verwendet wird.

Felder

truncated_secret string  (optional)

Nur Ausgabe. Die gekürzte Version des Signatur-Secrets.

expire_time string  (optional)

Nur Ausgabe. Das Ablaufdatum des Signatur-Secrets.

state enum (string)  (optional)

Nur Ausgabe. Der Status des Webhooks.

Mögliche Werte:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret String  (optional)

Nur Ausgabe. Das neue Signierungs-Secret für den Webhook. Wird nur beim Erstellen ausgefüllt.

id String  (optional)

Nur Ausgabe. Die ID des Webhooks.

Beispiel

Beispielantwort

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

ListWebhooks

get https://generativelanguage.googleapis.com/v1beta/webhooks

Listet alle Webhooks auf.

Pfad-/Suchparameter

page_size integer  (optional)

Optional. Die maximale Anzahl der zurückzugebenden Webhooks. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Webhooks zurückgegeben. Der Höchstwert ist 1.000.

page_token string  (optional)

Optional. Ein Seitentoken, das von einem vorherigen `ListWebhooks`-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Antwort

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

webhooks array (Webhook)  (optional)

Die Webhooks.

next_page_token string  (optional)

Ein Token, das als „page_token“ gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Beispiel

Beispielantwort

{
  "webhooks": [
    {
      "name": "string",
      "uri": "string",
      "subscribed_events": [
        "string"
      ],
      "create_time": "string",
      "update_time": "string",
      "signing_secrets": [
        {
          "truncated_secret": "string",
          "expire_time": "string"
        }
      ],
      "state": "enabled",
      "new_signing_secret": "string",
      "id": "string"
    }
  ],
  "next_page_token": "string"
}

GetWebhook

get https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

Ruft einen bestimmten Webhook ab.

Pfad-/Suchparameter

id String  (erforderlich)

Erforderlich. Die ID des Webhooks, der abgerufen werden soll.

Antwort

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

name string  (optional)

Optional. Der vom Nutzer angegebene Name des Webhooks.

uri string  (optional)

Erforderlich. Der URI, an den Webhook-Ereignisse gesendet werden.

subscribed_events Array (Objekt oder String)  (optional)

Erforderlich. Die Ereignisse, für die der Webhook abonniert ist. Verfügbare Ereignisse: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time string  (optional)

Nur Ausgabe. Der Zeitstempel für die Erstellung des Webhooks.

update_time string  (optional)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Webhook zuletzt aktualisiert wurde.

signing_secrets SigningSecret  (optional)

Nur Ausgabe. Die mit diesem Webhook verknüpften Signatur-Secrets.

Stellt ein Signierungs-Secret dar, das zum Überprüfen von Webhook-Nutzlasten verwendet wird.

Felder

truncated_secret string  (optional)

Nur Ausgabe. Die gekürzte Version des Signatur-Secrets.

expire_time string  (optional)

Nur Ausgabe. Das Ablaufdatum des Signatur-Secrets.

state enum (string)  (optional)

Nur Ausgabe. Der Status des Webhooks.

Mögliche Werte:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret String  (optional)

Nur Ausgabe. Das neue Signierungs-Secret für den Webhook. Wird nur beim Erstellen ausgefüllt.

id String  (optional)

Nur Ausgabe. Die ID des Webhooks.

Beispiel

Beispielantwort

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

UpdateWebhook

patch https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

Aktualisiert einen vorhandenen Webhook.

Pfad-/Suchparameter

id String  (erforderlich)

Erforderlich. Die ID des zu aktualisierenden Webhooks.

update_mask string  (optional)

Optional. Die Liste der zu aktualisierenden Felder.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

name string  (optional)

Optional. Der vom Nutzer angegebene Name des Webhooks.

uri string  (optional)

Optional. Der URI, an den Webhook-Ereignisse gesendet werden.

subscribed_events Array (Objekt oder String)  (optional)

Optional. Die Ereignisse, für die der Webhook abonniert ist. Verfügbare Ereignisse: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

state enum (string)  (optional)

Optional. Der Status des Webhooks.

Mögliche Werte:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries

Antwort

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

name string  (optional)

Optional. Der vom Nutzer angegebene Name des Webhooks.

uri string  (optional)

Erforderlich. Der URI, an den Webhook-Ereignisse gesendet werden.

subscribed_events Array (Objekt oder String)  (optional)

Erforderlich. Die Ereignisse, für die der Webhook abonniert ist. Verfügbare Ereignisse: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time string  (optional)

Nur Ausgabe. Der Zeitstempel für die Erstellung des Webhooks.

update_time string  (optional)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Webhook zuletzt aktualisiert wurde.

signing_secrets SigningSecret  (optional)

Nur Ausgabe. Die mit diesem Webhook verknüpften Signatur-Secrets.

Stellt ein Signierungs-Secret dar, das zum Überprüfen von Webhook-Nutzlasten verwendet wird.

Felder

truncated_secret string  (optional)

Nur Ausgabe. Die gekürzte Version des Signatur-Secrets.

expire_time string  (optional)

Nur Ausgabe. Das Ablaufdatum des Signatur-Secrets.

state enum (string)  (optional)

Nur Ausgabe. Der Status des Webhooks.

Mögliche Werte:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret String  (optional)

Nur Ausgabe. Das neue Signierungs-Secret für den Webhook. Wird nur beim Erstellen ausgefüllt.

id String  (optional)

Nur Ausgabe. Die ID des Webhooks.

Beispiel

Beispielantwort

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

DeleteWebhook

delete https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

Löscht einen Webhook.

Pfad-/Suchparameter

id String  (erforderlich)

Erforderlich. Die ID des zu löschenden Webhooks. Format: `{webhook_id}`

Antwort

Bei Erfolg ist die Antwort leer.

Beispiel

RotateSigningSecret

post https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:rotateSigningSecret

Generiert ein neues Signierungs-Secret für einen Webhook.

Pfad-/Suchparameter

id String  (erforderlich)

Erforderlich. Die ID des Webhooks, für den ein Signatur-Secret generiert werden soll. Format: `{webhook_id}`

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

revocation_behavior enum (string)  (optional)

Optional. Das Widerrufsverhalten für frühere Signatur-Secrets.

Mögliche Werte:

  • revoke_previous_secrets_after_h24
  • revoke_previous_secrets_immediately

Antwort

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

secret string  (optional)

Nur Ausgabe. Das neu generierte Signatur-Secret.

Beispiel

Beispielantwort

{
  "secret": "string"
}

PingWebhook

post https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:ping

Sendet ein Ping-Ereignis an einen Webhook.

Pfad-/Suchparameter

id String  (erforderlich)

Erforderlich. Die ID des zu pingenden Webhooks. Format: `{webhook_id}`

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

Antwort

Bei Erfolg ist die Antwort leer.

Beispiel

Ressourcen

Webhook

Eine Webhook-Ressource.

Felder

name string  (optional)

Optional. Der vom Nutzer angegebene Name des Webhooks.

uri string  (optional)

Erforderlich. Der URI, an den Webhook-Ereignisse gesendet werden.

subscribed_events Array (Objekt oder String)  (optional)

Erforderlich. Die Ereignisse, für die der Webhook abonniert ist. Verfügbare Ereignisse: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time string  (optional)

Nur Ausgabe. Der Zeitstempel für die Erstellung des Webhooks.

update_time string  (optional)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Webhook zuletzt aktualisiert wurde.

signing_secrets SigningSecret  (optional)

Nur Ausgabe. Die mit diesem Webhook verknüpften Signatur-Secrets.

Stellt ein Signierungs-Secret dar, das zum Überprüfen von Webhook-Nutzlasten verwendet wird.

Felder

truncated_secret string  (optional)

Nur Ausgabe. Die gekürzte Version des Signatur-Secrets.

expire_time string  (optional)

Nur Ausgabe. Das Ablaufdatum des Signatur-Secrets.

state enum (string)  (optional)

Nur Ausgabe. Der Status des Webhooks.

Mögliche Werte:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret String  (optional)

Nur Ausgabe. Das neue Signierungs-Secret für den Webhook. Wird nur beim Erstellen ausgefüllt.

id String  (optional)

Nur Ausgabe. Die ID des Webhooks.

Datenmodelle

InteractionSseEvent

Mögliche Typen

Polymorpher Diskriminator: event_type

InteractionCreatedEvent

event_type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "interaction.created" gesetzt.

interaction Interaction  (erforderlich)

Keine Beschreibung vorhanden.

Die Interaction-Ressource.

Felder

model ModelOption  (optional)

Der Name des `Model`, das zum Generieren der Interaktion verwendet wurde.

Mögliche Werte:

  • gemini-2.5-computer-use-preview-10-2025

    Ein agentisches Funktionsmodell, das für die direkte Interaktion mit der Benutzeroberfläche entwickelt wurde und es Gemini ermöglicht, digitale Umgebungen wahrzunehmen und darin zu navigieren.

  • gemini-2.5-flash

    Unser erstes Hybrid-Reasoning-Modell, das ein Kontextfenster mit 1 Million Tokens unterstützt und über Denkbudgets verfügt.

  • gemini-2.5-flash-image

    Unser natives Modell für die Bildgenerierung, das für Geschwindigkeit, Flexibilität und kontextuelles Verständnis optimiert ist. Die Preise für Texteingabe und -ausgabe entsprechen denen für 2.5 Flash.

  • gemini-2.5-flash-lite

    Unser kleinstes und kostengünstigstes Modell, das für die Nutzung im großen Maßstab entwickelt wurde.

  • gemini-2.5-flash-lite-preview-09-2025

    Das neueste Modell basiert auf Gemini 2.5 Flash Lite und ist für Kosteneffizienz, hohen Durchsatz und hohe Qualität optimiert.

  • gemini-2.5-flash-native-audio-preview-12-2025

    Unsere nativen Audiomodelle sind für Audioausgaben mit höherer Qualität optimiert und bieten ein besseres Tempo, natürlichere Stimmen, mehr Ausführlichkeit und eine passendere Stimmungslage.

  • gemini-2.5-flash-preview-09-2025

    Das neueste Modell, das auf dem Modell 2.5 Flash basiert. 2.5 Flash Preview eignet sich am besten für die Verarbeitung großer Mengen, Aufgaben mit niedriger Latenz und hohem Volumen, die Denkprozesse erfordern, sowie für Agent-Anwendungsfälle.

  • gemini-2.5-flash-preview-tts

    Unser 2.5 Flash-Modell für die Sprachausgabe, das für leistungsstarke, latenzarme und steuerbare Sprachgenerierung optimiert ist.

  • gemini-2.5-pro

    Unser hochmodernes Mehrzweckmodell, das sich besonders gut für Programmier- und komplexe Logikaufgaben eignet.

  • gemini-2.5-pro-preview-tts

    Unser 2.5 Pro-Modell für die Sprachsynthese ist für die leistungsstarke, latenzarme Sprachgenerierung optimiert und bietet natürlichere Ausgaben und einfacher zu steuernde Prompts.

  • gemini-3-flash-preview

    Unser intelligentestes Modell, das auf Geschwindigkeit ausgelegt ist und bahnbrechende Intelligenz mit überlegener Suche und Fundierung kombiniert.

  • gemini-3-pro-image-preview

    Hochmodernes Modell für die Bildgenerierung und ‑bearbeitung.

  • gemini-3-pro-preview

    Unser bisher intelligentestes Modell mit modernsten Funktionen für logische Schlussfolgerungen und multimodales Verstehen sowie leistungsstarken Funktionen für Agent- und Vibe-Coding.

  • gemini-3.1-pro-preview

    Unser neuestes, hochmodernes Modell für logische Schlussfolgerungen mit beispielloser Tiefe und Nuance sowie leistungsstarken multimodalen und Programmierfunktionen.

  • gemini-3.1-flash-image-preview

    Visuelle Intelligenz auf Profiniveau mit der Effizienz von Flash und realitätsnahen Generierungsfunktionen.

  • gemini-3.1-flash-lite-preview

    Unser kostengünstigstes Modell, das für agentische Aufgaben mit hohem Volumen, Übersetzungen und einfache Datenverarbeitung optimiert ist.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Leistungsstarke Sprachgenerierung mit geringer Latenz. Sie können sich auf natürliche Ausgaben, steuerbare Prompts und neue ausdrucksstarke Audio-Tags für eine präzise Steuerung der Sprachausgabe freuen.

  • lyria-3-clip-preview

    Unser Modell zur Musikgenerierung mit niedriger Latenz, das für Audio-Clips in hoher Klangqualität und präzise rhythmische Steuerung optimiert ist.

  • lyria-3-pro-preview

    Unser fortschrittliches, generatives Modell für ganze Songs mit umfassendem Verständnis für Komposition, optimiert für präzise strukturelle Steuerung und komplexe Übergänge zwischen verschiedenen Musikstilen.

Das Modell, das Ihren Prompt vervollständigt.\n\nWeitere Informationen finden Sie unter [Modelle](https://ai.google.dev/gemini-api/docs/models).

agent AgentOption  (optional)

Der Name des `Agent`, der zum Generieren der Interaktion verwendet wurde.

Mögliche Werte:

  • deep-research-pro-preview-12-2025

    Gemini Deep Research-Agent

  • deep-research-preview-04-2026

    Gemini Deep Research-Agent

  • deep-research-max-preview-04-2026

    Gemini Deep Research Max-Agent

Der Agent, mit dem interagiert werden soll.

id String  (optional)

Erforderlich. Nur Ausgabe. Eine eindeutige Kennung für den Abschluss der Interaktion.

status enum (string)  (optional)

Erforderlich. Nur Ausgabe. Der Status der Interaktion.

Mögliche Werte:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (optional)

Erforderlich. Nur Ausgabe. Die Uhrzeit, zu der die Antwort erstellt wurde, im ISO 8601-Format (JJJJ-MM-TTThh:mm:ssZ).

updated string  (optional)

Erforderlich. Nur Ausgabe. Die Uhrzeit, zu der die Antwort zuletzt aktualisiert wurde, im ISO 8601-Format (JJJJ-MM-TTThh:mm:ssZ).

role string  (optional)

Nur Ausgabe. Die Rolle der Interaktion.

system_instruction String  (optional)

Systemanweisung für die Interaktion.

tools Tool  (optional)

Eine Liste der Tool-Deklarationen, die das Modell während der Interaktion aufrufen kann.

Ein Tool, das vom Modell verwendet werden kann.

Mögliche Typen

Polymorpher Diskriminator: type

Funktion

Ein Tool, das vom Modell verwendet werden kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function" gesetzt.

name string  (optional)

Der Name der Funktion.

description string  (optional)

Eine Beschreibung der Funktion.

Parameter object  (optional)

Das JSON-Schema für die Parameter der Funktion.

CodeExecution

Ein Tool, das vom Modell zum Ausführen von Code verwendet werden kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution" gesetzt.

UrlContext

Ein Tool, mit dem das Modell URL-Kontext abrufen kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context" gesetzt.

ComputerUse

Ein Tool, das vom Modell verwendet werden kann, um mit dem Computer zu interagieren.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "computer_use" gesetzt.

environment enum (string)  (optional)

Die Umgebung, in der der Vorgang ausgeführt wird.

Mögliche Werte:

  • browser
excluded_predefined_functions array (string)  (optional)

Die Liste der vordefinierten Funktionen, die vom Modellaufruf ausgeschlossen sind.

McpServer

Ein MCPServer ist ein Server, der vom Modell aufgerufen werden kann, um Aktionen auszuführen.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server" gesetzt.

name string  (optional)

Der Name des MCPServers.

url string  (optional)

Die vollständige URL für den MCPServer-Endpunkt. Beispiel: „https://api.beispiel.de/mcp“

headers object  (optional)

Optional: Felder für Authentifizierungsheader, Zeitüberschreitungen usw., falls erforderlich.

allowed_tools AllowedTools  (optional)

Die zulässigen Tools.

Die Konfiguration für zulässige Tools.

Felder

mode ToolChoiceType  (optional)

Der Modus der Tool-Auswahl.

Mögliche Werte:

  • auto
  • any
  • none
  • validated

tools array (string)  (optional)

Die Namen der zulässigen Tools.

GoogleSearch

Ein Tool, das vom Modell verwendet werden kann, um in Google zu suchen.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search" gesetzt.

search_types array (enum (string))  (optional)

Die Arten von Suchgrundlagen, die aktiviert werden sollen.

Mögliche Werte:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

Ein Tool, das vom Modell zum Suchen von Dateien verwendet werden kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search" gesetzt.

file_search_store_names Array (String)  (optional)

Die Namen der Dateisuchspeicher, die durchsucht werden sollen.

top_k integer  (optional)

Die Anzahl der semantischen Abruf-Chunks, die abgerufen werden sollen.

metadata_filter String  (optional)

Metadatenfilter, der auf die Dokumente und Chunks für den semantischen Abruf angewendet werden soll.

GoogleMaps

Ein Tool, das vom Modell verwendet werden kann, um Google Maps aufzurufen.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps" gesetzt.

enable_widget boolean  (optional)

Gibt an, ob im Ergebnis des Toolaufrufs der Antwort ein Widget-Kontext-Token zurückgegeben werden soll.

latitude number  (optional)

Der Breitengrad des Standorts des Nutzers.

longitude number  (optional)

Der Längengrad des Standorts des Nutzers.

Abruf

Ein Tool, mit dem das Modell Dateien abrufen kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "retrieval" gesetzt.

retrieval_types array (enum (string))  (optional)

Die Arten des Dateiwiederherstellungsvorgangs, die aktiviert werden sollen.

Mögliche Werte:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (optional)

Wird verwendet, um die Konfiguration für VertexAISearch anzugeben.

Wird verwendet, um die Konfiguration für VertexAISearch anzugeben.

Felder

engine string  (optional)

Optional. Wird verwendet, um die Vertex AI Search-Engine anzugeben.

datastores array (string)  (optional)

Optional. Wird verwendet, um Vertex AI Search-Datenspeicher anzugeben.

usage Usage  (optional)

Nur Ausgabe. Statistiken zur Tokennutzung der Interaktionsanfrage.

Statistiken zur Tokennutzung der Interaktionsanfrage.

Felder

total_input_tokens integer  (optional)

Anzahl der Tokens im Prompt (Kontext).

input_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Nutzung von Eingabetokens nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_cached_tokens integer  (optional)

Anzahl der Tokens im im Cache gespeicherten Teil des Prompts (dem im Cache gespeicherten Inhalt).

cached_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Nutzung von zwischengespeicherten Tokens nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_output_tokens integer  (optional)

Die Gesamtzahl der Tokens in allen generierten Antworten.

output_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Nutzung von Ausgabetokens nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_tool_use_tokens integer  (optional)

Anzahl der Tokens in den Tool-Nutzungs-Prompts.

tool_use_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Tokennutzung für die Tool-Verwendung nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_thought_tokens integer  (optional)

Anzahl der Tokens für Gedanken für Thinking-Modelle.

total_tokens integer  (optional)

Gesamtzahl der Tokens für die Interaktionsanfrage (Prompt + Antworten + andere interne Tokens).

grounding_tool_count GroundingToolCount  (optional)

Anzahl der Fundierungs-Tools.

Die Anzahl der Grounding-Tools.

Felder

type enum (string)  (optional)

Der Typ des Grounding-Tools, das der Anzahl zugeordnet ist.

Mögliche Werte:

  • google_search
  • google_maps
  • retrieval
count integer  (optional)

Die Anzahl der Grounding-Tools.

response_modalities ResponseModality  (optional)

Die angeforderten Modalitäten der Antwort (TEXT, IMAGE, AUDIO).

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

response_mime_type string  (optional)

Der MIME-Typ der Antwort. Erforderlich, wenn „response_format“ festgelegt ist.

previous_interaction_id String  (optional)

Die ID der vorherigen Interaktion, falls vorhanden.

service_tier ServiceTier  (optional)

Die Serviceebene für die Interaktion.

Mögliche Werte:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (optional)

Optional. Webhook-Konfiguration für den Empfang von Benachrichtigungen, wenn die Interaktion abgeschlossen ist.

Nachricht zum Konfigurieren von Webhook-Ereignissen für eine Anfrage.

Felder

uris Array (String)  (optional)

Optional. Wenn diese Webhook-URIs festgelegt sind, werden sie anstelle der registrierten Webhooks für Webhook-Ereignisse verwendet.

user_metadata object  (optional)

Optional. Die Nutzermetadaten, die bei jeder Ereignisausgabe an die Webhooks zurückgegeben werden.

steps Step  (optional)

Nur Ausgabe. Die Schritte, aus denen die Interaktion besteht.

Ein Schritt in der Interaktion.

Mögliche Typen

Polymorpher Diskriminator: type

UserInputStep

Vom Nutzer bereitgestellte Eingaben.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "user_input" gesetzt.

content Content  (optional)

Keine Beschreibung vorhanden.

Der Inhalt der Antwort.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Ein Audioinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "audio" gesetzt.

data string  (optional)

Die Audioinhalte.

uri string  (optional)

Der URI des Audios.

mime_type enum (string)  (optional)

Der MIME-Typ des Audios.

Mögliche Werte:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
channels integer  (optional)

Die Anzahl der Audiokanäle.

sample_rate integer  (optional)

Die Abtastrate des Audiosignals.

DocumentContent

Ein Inhaltsblock für Dokumente.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "document" gesetzt.

data string  (optional)

Der Inhalt des Dokuments.

uri string  (optional)

Der URI des Dokuments.

mime_type enum (string)  (optional)

Der MIME-Typ des Dokuments.

Mögliche Werte:

  • application/pdf
VideoContent

Ein Videocontent-Block.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "video" gesetzt.

data string  (optional)

Die Videoinhalte.

uri string  (optional)

Der URI des Videos.

mime_type enum (string)  (optional)

Der MIME-Typ des Videos.

Mögliche Werte:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ModelOutputStep

Die vom Modell generierte Ausgabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "model_output" gesetzt.

content Content  (optional)

Keine Beschreibung vorhanden.

Der Inhalt der Antwort.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Ein Audioinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "audio" gesetzt.

data string  (optional)

Die Audioinhalte.

uri string  (optional)

Der URI des Audios.

mime_type enum (string)  (optional)

Der MIME-Typ des Audios.

Mögliche Werte:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
channels integer  (optional)

Die Anzahl der Audiokanäle.

sample_rate integer  (optional)

Die Abtastrate des Audiosignals.

DocumentContent

Ein Inhaltsblock für Dokumente.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "document" gesetzt.

data string  (optional)

Der Inhalt des Dokuments.

uri string  (optional)

Der URI des Dokuments.

mime_type enum (string)  (optional)

Der MIME-Typ des Dokuments.

Mögliche Werte:

  • application/pdf
VideoContent

Ein Videocontent-Block.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "video" gesetzt.

data string  (optional)

Die Videoinhalte.

uri string  (optional)

Der URI des Videos.

mime_type enum (string)  (optional)

Der MIME-Typ des Videos.

Mögliche Werte:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ThoughtStep

Ein Gedankenschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "thought" gesetzt.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

summary ThoughtSummaryContent  (optional)

Eine Zusammenfassung des Gedankens.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

FunctionCallStep

Ein Funktions-Tool-Aufrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function_call" gesetzt.

name string  (erforderlich)

Erforderlich. Der Name des aufzurufenden Tools.

arguments object  (erforderlich)

Erforderlich. Die Argumente, die an die Funktion übergeben werden sollen.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

CodeExecutionCallStep

Aufrufschritt für die Codeausführung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution_call" gesetzt.

arguments CodeExecutionCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an die Codeausführung übergeben werden sollen.

Die Argumente, die an die Codeausführung übergeben werden sollen.

Felder

language enum (string)  (optional)

Programmiersprache des „code“.

Mögliche Werte:

  • python
code string  (optional)

Der auszuführende Code.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

UrlContextCallStep

Schritt für den URL-Kontextaufruf.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context_call" gesetzt.

arguments UrlContextCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an den URL-Kontext übergeben werden sollen.

Die Argumente, die an den URL-Kontext übergeben werden sollen.

Felder

urls array (string)  (optional)

Die abzurufenden URLs.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

McpServerToolCallStep

MCPServer-Toolaufrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server_tool_call" gesetzt.

name string  (erforderlich)

Erforderlich. Der Name des aufgerufenen Tools.

server_name string  (erforderlich)

Erforderlich. Der Name des verwendeten MCP-Servers.

arguments object  (erforderlich)

Erforderlich. Das JSON-Objekt der Argumente für die Funktion.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleSearchCallStep

Google Suche-Anrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search_call" gesetzt.

arguments GoogleSearchCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an die Google Suche übergeben werden sollen.

Die Argumente, die an die Google Suche übergeben werden sollen.

Felder

queries array (string)  (optional)

Websuchanfragen für die anschließende Websuche.

search_type enum (string)  (optional)

Der Typ der aktivierten Fundierung der Suche.

Mögliche Werte:

  • web_search
  • image_search
  • enterprise_web_search
id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

FileSearchCallStep

Anrufschritt für die Dateisuche.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search_call" gesetzt.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleMapsCallStep

Anrufschritt in Google Maps

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps_call" gesetzt.

arguments GoogleMapsCallStepArguments  (optional)

Die Argumente, die an das Google Maps-Tool übergeben werden sollen.

Die Argumente, die an das Google Maps-Tool übergeben werden sollen.

Felder

queries array (string)  (optional)

Die auszuführenden Abfragen.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

FunctionResultStep

Ergebnis eines Funktions-Tool-Aufrufs.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function_result" gesetzt.

name string  (optional)

Der Name des aufgerufenen Tools.

is_error boolean  (optional)

Gibt an, ob beim Toolaufruf ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

result array (FunctionResultSubcontent) or string  (erforderlich)

Das Ergebnis des Tool-Aufrufs.

CodeExecutionResultStep

Schritt für das Ergebnis der Codeausführung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution_result" gesetzt.

result string  (erforderlich)

Erforderlich. Die Ausgabe der Codeausführung.

is_error boolean  (optional)

Gibt an, ob bei der Codeausführung ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

UrlContextResultStep

Ergebnisschritt für den URL-Kontext.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context_result" gesetzt.

result UrlContextResultItem  (erforderlich)

Erforderlich. Die Ergebnisse des URL-Kontexts.

Das Ergebnis des URL-Kontexts.

Felder

url string  (optional)

Die abgerufene URL.

status enum (string)  (optional)

Der Status des URL-Abrufs.

Mögliche Werte:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

Gibt an, ob der URL-Kontext zu einem Fehler geführt hat.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleSearchResultStep

Schritt für Google-Suchergebnisse.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search_result" gesetzt.

result GoogleSearchResultItem  (erforderlich)

Erforderlich. Die Ergebnisse der Google Suche.

Das Ergebnis der Google-Suche.

Felder

search_suggestions String  (optional)

Webinhalts-Snippet, das in eine Webseite oder eine App-Webview eingebettet werden kann.

is_error boolean  (optional)

Gibt an, ob bei der Google-Suche ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

McpServerToolResultStep

Schritt für das Ergebnis des MCPServer-Tools.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server_tool_result" gesetzt.

name string  (optional)

Name des Tools, das für diesen bestimmten Tool-Aufruf aufgerufen wird.

server_name string  (optional)

Der Name des verwendeten MCP-Servers.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

result array (FunctionResultSubcontent) or string  (erforderlich)

Die Ausgabe des MCP-Serveraufrufs. Kann einfacher Text oder Rich Content sein.

FileSearchResultStep

Schritt für Dateisuchergebnis.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search_result" gesetzt.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleMapsResultStep

Google Maps-Ergebnisschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps_result" gesetzt.

result GoogleMapsResultItem  (erforderlich)

Keine Beschreibung vorhanden.

Das Ergebnis von Google Maps.

Felder

places GoogleMapsResultPlaces  (optional)

Keine Beschreibung vorhanden.

Felder

place_id string  (optional)

Keine Beschreibung vorhanden.

name string  (optional)

Keine Beschreibung vorhanden.

url string  (optional)

Keine Beschreibung vorhanden.

review_snippets ReviewSnippet  (optional)

Keine Beschreibung vorhanden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

widget_context_token string  (optional)

Keine Beschreibung vorhanden.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

input Content oder Array (Content) oder Array (Step) oder String  (optional)

Die Eingabe für die Interaktion.

response_format ResponseFormat oder ResponseFormatList  (optional)

Erzwingt, dass die generierte Antwort ein JSON-Objekt ist, das dem in diesem Feld angegebenen JSON-Schema entspricht.

agent_config object  (optional)

Konfigurationsparameter für die Interaktion mit dem Agent.

Mögliche Typen

Polymorpher Diskriminator: type

DynamicAgentConfig

Konfiguration für dynamische Agenten.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "dynamic" gesetzt.

DeepResearchAgentConfig

Konfiguration für den Deep Research-Agenten.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "deep-research" gesetzt.

thinking_summaries ThinkingSummaries  (optional)

Gibt an, ob Zusammenfassungen der Überlegungen in die Antwort aufgenommen werden sollen.

Mögliche Werte:

  • auto
  • none

visualization enum (string)  (optional)

Gibt an, ob Visualisierungen in die Antwort aufgenommen werden sollen.

Mögliche Werte:

  • off
  • auto
collaborative_planning boolean  (optional)

Ermöglicht die Human-in-the-Loop-Planung für den Deep Research-Agenten. Wenn diese Option auf „true“ gesetzt ist, enthält die Antwort des Deep Research-Agents einen Rechercheplan. Der Agent fährt dann nur fort, wenn der Nutzer den Plan im nächsten Zug bestätigt.

event_id string  (optional)

Das event_id-Token, das zum Fortsetzen des Interaktionsstreams ab diesem Ereignis verwendet werden soll.

InteractionCompletedEvent

event_type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "interaction.completed" gesetzt.

interaction Interaction  (erforderlich)

Erforderlich. Die abgeschlossene Interaktion mit leeren Ausgaben, um die Nutzlastgröße zu reduzieren. Verwenden Sie die vorherigen ContentDelta-Ereignisse für die tatsächliche Ausgabe.

Die Interaction-Ressource.

Felder

model ModelOption  (optional)

Der Name des `Model`, das zum Generieren der Interaktion verwendet wurde.

Mögliche Werte:

  • gemini-2.5-computer-use-preview-10-2025

    Ein agentisches Funktionsmodell, das für die direkte Interaktion mit der Benutzeroberfläche entwickelt wurde und es Gemini ermöglicht, digitale Umgebungen wahrzunehmen und darin zu navigieren.

  • gemini-2.5-flash

    Unser erstes Hybrid-Reasoning-Modell, das ein Kontextfenster mit 1 Million Tokens unterstützt und über Denkbudgets verfügt.

  • gemini-2.5-flash-image

    Unser natives Modell für die Bildgenerierung, das für Geschwindigkeit, Flexibilität und kontextuelles Verständnis optimiert ist. Die Preise für Texteingabe und -ausgabe entsprechen denen für 2.5 Flash.

  • gemini-2.5-flash-lite

    Unser kleinstes und kostengünstigstes Modell, das für die Nutzung im großen Maßstab entwickelt wurde.

  • gemini-2.5-flash-lite-preview-09-2025

    Das neueste Modell basiert auf Gemini 2.5 Flash Lite und ist für Kosteneffizienz, hohen Durchsatz und hohe Qualität optimiert.

  • gemini-2.5-flash-native-audio-preview-12-2025

    Unsere nativen Audiomodelle sind für Audioausgaben mit höherer Qualität optimiert und bieten ein besseres Tempo, natürlichere Stimmen, mehr Ausführlichkeit und eine passendere Stimmungslage.

  • gemini-2.5-flash-preview-09-2025

    Das neueste Modell, das auf dem Modell 2.5 Flash basiert. 2.5 Flash Preview eignet sich am besten für die Verarbeitung großer Mengen, Aufgaben mit niedriger Latenz und hohem Volumen, die Denkprozesse erfordern, sowie für Agent-Anwendungsfälle.

  • gemini-2.5-flash-preview-tts

    Unser 2.5 Flash-Modell für die Sprachausgabe, das für leistungsstarke, latenzarme und steuerbare Sprachgenerierung optimiert ist.

  • gemini-2.5-pro

    Unser hochmodernes Mehrzweckmodell, das sich besonders gut für Programmier- und komplexe Logikaufgaben eignet.

  • gemini-2.5-pro-preview-tts

    Unser 2.5 Pro-Modell für die Sprachsynthese ist für die leistungsstarke, latenzarme Sprachgenerierung optimiert und bietet natürlichere Ausgaben und einfacher zu steuernde Prompts.

  • gemini-3-flash-preview

    Unser intelligentestes Modell, das auf Geschwindigkeit ausgelegt ist und bahnbrechende Intelligenz mit überlegener Suche und Fundierung kombiniert.

  • gemini-3-pro-image-preview

    Hochmodernes Modell für die Bildgenerierung und ‑bearbeitung.

  • gemini-3-pro-preview

    Unser bisher intelligentestes Modell mit modernsten Funktionen für logische Schlussfolgerungen und multimodales Verstehen sowie leistungsstarken Funktionen für Agent- und Vibe-Coding.

  • gemini-3.1-pro-preview

    Unser neuestes, hochmodernes Modell für logische Schlussfolgerungen mit beispielloser Tiefe und Nuance sowie leistungsstarken multimodalen und Programmierfunktionen.

  • gemini-3.1-flash-image-preview

    Visuelle Intelligenz auf Profiniveau mit der Effizienz von Flash und realitätsnahen Generierungsfunktionen.

  • gemini-3.1-flash-lite-preview

    Unser kostengünstigstes Modell, das für agentische Aufgaben mit hohem Volumen, Übersetzungen und einfache Datenverarbeitung optimiert ist.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Leistungsstarke Sprachgenerierung mit geringer Latenz. Sie können sich auf natürliche Ausgaben, steuerbare Prompts und neue ausdrucksstarke Audio-Tags für eine präzise Steuerung der Sprachausgabe freuen.

  • lyria-3-clip-preview

    Unser Modell zur Musikgenerierung mit niedriger Latenz, das für Audio-Clips in hoher Klangqualität und präzise rhythmische Steuerung optimiert ist.

  • lyria-3-pro-preview

    Unser fortschrittliches, generatives Modell für ganze Songs mit umfassendem Verständnis für Komposition, optimiert für präzise strukturelle Steuerung und komplexe Übergänge zwischen verschiedenen Musikstilen.

Das Modell, das Ihren Prompt vervollständigt.\n\nWeitere Informationen finden Sie unter [Modelle](https://ai.google.dev/gemini-api/docs/models).

agent AgentOption  (optional)

Der Name des `Agent`, der zum Generieren der Interaktion verwendet wurde.

Mögliche Werte:

  • deep-research-pro-preview-12-2025

    Gemini Deep Research-Agent

  • deep-research-preview-04-2026

    Gemini Deep Research-Agent

  • deep-research-max-preview-04-2026

    Gemini Deep Research Max-Agent

Der Agent, mit dem interagiert werden soll.

id String  (optional)

Erforderlich. Nur Ausgabe. Eine eindeutige Kennung für den Abschluss der Interaktion.

status enum (string)  (optional)

Erforderlich. Nur Ausgabe. Der Status der Interaktion.

Mögliche Werte:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (optional)

Erforderlich. Nur Ausgabe. Die Uhrzeit, zu der die Antwort erstellt wurde, im ISO 8601-Format (JJJJ-MM-TTThh:mm:ssZ).

updated string  (optional)

Erforderlich. Nur Ausgabe. Die Uhrzeit, zu der die Antwort zuletzt aktualisiert wurde, im ISO 8601-Format (JJJJ-MM-TTThh:mm:ssZ).

role string  (optional)

Nur Ausgabe. Die Rolle der Interaktion.

system_instruction String  (optional)

Systemanweisung für die Interaktion.

tools Tool  (optional)

Eine Liste der Tool-Deklarationen, die das Modell während der Interaktion aufrufen kann.

Ein Tool, das vom Modell verwendet werden kann.

Mögliche Typen

Polymorpher Diskriminator: type

Funktion

Ein Tool, das vom Modell verwendet werden kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function" gesetzt.

name string  (optional)

Der Name der Funktion.

description string  (optional)

Eine Beschreibung der Funktion.

Parameter object  (optional)

Das JSON-Schema für die Parameter der Funktion.

CodeExecution

Ein Tool, das vom Modell zum Ausführen von Code verwendet werden kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution" gesetzt.

UrlContext

Ein Tool, mit dem das Modell URL-Kontext abrufen kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context" gesetzt.

ComputerUse

Ein Tool, das vom Modell verwendet werden kann, um mit dem Computer zu interagieren.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "computer_use" gesetzt.

environment enum (string)  (optional)

Die Umgebung, in der der Vorgang ausgeführt wird.

Mögliche Werte:

  • browser
excluded_predefined_functions array (string)  (optional)

Die Liste der vordefinierten Funktionen, die vom Modellaufruf ausgeschlossen sind.

McpServer

Ein MCPServer ist ein Server, der vom Modell aufgerufen werden kann, um Aktionen auszuführen.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server" gesetzt.

name string  (optional)

Der Name des MCPServers.

url string  (optional)

Die vollständige URL für den MCPServer-Endpunkt. Beispiel: „https://api.beispiel.de/mcp“

headers object  (optional)

Optional: Felder für Authentifizierungsheader, Zeitüberschreitungen usw., falls erforderlich.

allowed_tools AllowedTools  (optional)

Die zulässigen Tools.

Die Konfiguration für zulässige Tools.

Felder

mode ToolChoiceType  (optional)

Der Modus der Tool-Auswahl.

Mögliche Werte:

  • auto
  • any
  • none
  • validated

tools array (string)  (optional)

Die Namen der zulässigen Tools.

GoogleSearch

Ein Tool, das vom Modell verwendet werden kann, um in Google zu suchen.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search" gesetzt.

search_types array (enum (string))  (optional)

Die Arten von Suchgrundlagen, die aktiviert werden sollen.

Mögliche Werte:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

Ein Tool, das vom Modell zum Suchen von Dateien verwendet werden kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search" gesetzt.

file_search_store_names Array (String)  (optional)

Die Namen der Dateisuchspeicher, die durchsucht werden sollen.

top_k integer  (optional)

Die Anzahl der semantischen Abruf-Chunks, die abgerufen werden sollen.

metadata_filter String  (optional)

Metadatenfilter, der auf die Dokumente und Chunks für den semantischen Abruf angewendet werden soll.

GoogleMaps

Ein Tool, das vom Modell verwendet werden kann, um Google Maps aufzurufen.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps" gesetzt.

enable_widget boolean  (optional)

Gibt an, ob im Ergebnis des Toolaufrufs der Antwort ein Widget-Kontext-Token zurückgegeben werden soll.

latitude number  (optional)

Der Breitengrad des Standorts des Nutzers.

longitude number  (optional)

Der Längengrad des Standorts des Nutzers.

Abruf

Ein Tool, mit dem das Modell Dateien abrufen kann.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "retrieval" gesetzt.

retrieval_types array (enum (string))  (optional)

Die Arten des Dateiwiederherstellungsvorgangs, die aktiviert werden sollen.

Mögliche Werte:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (optional)

Wird verwendet, um die Konfiguration für VertexAISearch anzugeben.

Wird verwendet, um die Konfiguration für VertexAISearch anzugeben.

Felder

engine string  (optional)

Optional. Wird verwendet, um die Vertex AI Search-Engine anzugeben.

datastores array (string)  (optional)

Optional. Wird verwendet, um Vertex AI Search-Datenspeicher anzugeben.

usage Usage  (optional)

Nur Ausgabe. Statistiken zur Tokennutzung der Interaktionsanfrage.

Statistiken zur Tokennutzung der Interaktionsanfrage.

Felder

total_input_tokens integer  (optional)

Anzahl der Tokens im Prompt (Kontext).

input_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Nutzung von Eingabetokens nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_cached_tokens integer  (optional)

Anzahl der Tokens im im Cache gespeicherten Teil des Prompts (dem im Cache gespeicherten Inhalt).

cached_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Nutzung von zwischengespeicherten Tokens nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_output_tokens integer  (optional)

Die Gesamtzahl der Tokens in allen generierten Antworten.

output_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Nutzung von Ausgabetokens nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_tool_use_tokens integer  (optional)

Anzahl der Tokens in den Tool-Nutzungs-Prompts.

tool_use_tokens_by_modality ModalityTokens  (optional)

Eine Aufschlüsselung der Tokennutzung für die Tool-Verwendung nach Modalität.

Die Anzahl der Tokens für eine einzelne Antwortmodalität.

Felder

modality ResponseModality  (optional)

Die mit der Anzahl der Tokens verknüpfte Modalität.

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

Tokens Ganzzahl  (optional)

Anzahl der Tokens für die Modalität.

total_thought_tokens integer  (optional)

Anzahl der Tokens für Gedanken für Thinking-Modelle.

total_tokens integer  (optional)

Gesamtzahl der Tokens für die Interaktionsanfrage (Prompt + Antworten + andere interne Tokens).

grounding_tool_count GroundingToolCount  (optional)

Anzahl der Fundierungs-Tools.

Die Anzahl der Grounding-Tools.

Felder

type enum (string)  (optional)

Der Typ des Grounding-Tools, das der Anzahl zugeordnet ist.

Mögliche Werte:

  • google_search
  • google_maps
  • retrieval
count integer  (optional)

Die Anzahl der Grounding-Tools.

response_modalities ResponseModality  (optional)

Die angeforderten Modalitäten der Antwort (TEXT, IMAGE, AUDIO).

Mögliche Werte:

  • text
  • image
  • audio
  • video
  • document

response_mime_type string  (optional)

Der MIME-Typ der Antwort. Erforderlich, wenn „response_format“ festgelegt ist.

previous_interaction_id String  (optional)

Die ID der vorherigen Interaktion, falls vorhanden.

service_tier ServiceTier  (optional)

Die Serviceebene für die Interaktion.

Mögliche Werte:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (optional)

Optional. Webhook-Konfiguration für den Empfang von Benachrichtigungen, wenn die Interaktion abgeschlossen ist.

Nachricht zum Konfigurieren von Webhook-Ereignissen für eine Anfrage.

Felder

uris Array (String)  (optional)

Optional. Wenn diese Webhook-URIs festgelegt sind, werden sie anstelle der registrierten Webhooks für Webhook-Ereignisse verwendet.

user_metadata object  (optional)

Optional. Die Nutzermetadaten, die bei jeder Ereignisausgabe an die Webhooks zurückgegeben werden.

steps Step  (optional)

Nur Ausgabe. Die Schritte, aus denen die Interaktion besteht.

Ein Schritt in der Interaktion.

Mögliche Typen

Polymorpher Diskriminator: type

UserInputStep

Vom Nutzer bereitgestellte Eingaben.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "user_input" gesetzt.

content Content  (optional)

Keine Beschreibung vorhanden.

Der Inhalt der Antwort.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Ein Audioinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "audio" gesetzt.

data string  (optional)

Die Audioinhalte.

uri string  (optional)

Der URI des Audios.

mime_type enum (string)  (optional)

Der MIME-Typ des Audios.

Mögliche Werte:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
channels integer  (optional)

Die Anzahl der Audiokanäle.

sample_rate integer  (optional)

Die Abtastrate des Audiosignals.

DocumentContent

Ein Inhaltsblock für Dokumente.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "document" gesetzt.

data string  (optional)

Der Inhalt des Dokuments.

uri string  (optional)

Der URI des Dokuments.

mime_type enum (string)  (optional)

Der MIME-Typ des Dokuments.

Mögliche Werte:

  • application/pdf
VideoContent

Ein Videocontent-Block.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "video" gesetzt.

data string  (optional)

Die Videoinhalte.

uri string  (optional)

Der URI des Videos.

mime_type enum (string)  (optional)

Der MIME-Typ des Videos.

Mögliche Werte:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ModelOutputStep

Die vom Modell generierte Ausgabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "model_output" gesetzt.

content Content  (optional)

Keine Beschreibung vorhanden.

Der Inhalt der Antwort.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Ein Audioinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "audio" gesetzt.

data string  (optional)

Die Audioinhalte.

uri string  (optional)

Der URI des Audios.

mime_type enum (string)  (optional)

Der MIME-Typ des Audios.

Mögliche Werte:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
channels integer  (optional)

Die Anzahl der Audiokanäle.

sample_rate integer  (optional)

Die Abtastrate des Audiosignals.

DocumentContent

Ein Inhaltsblock für Dokumente.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "document" gesetzt.

data string  (optional)

Der Inhalt des Dokuments.

uri string  (optional)

Der URI des Dokuments.

mime_type enum (string)  (optional)

Der MIME-Typ des Dokuments.

Mögliche Werte:

  • application/pdf
VideoContent

Ein Videocontent-Block.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "video" gesetzt.

data string  (optional)

Die Videoinhalte.

uri string  (optional)

Der URI des Videos.

mime_type enum (string)  (optional)

Der MIME-Typ des Videos.

Mögliche Werte:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ThoughtStep

Ein Gedankenschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "thought" gesetzt.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

summary ThoughtSummaryContent  (optional)

Eine Zusammenfassung des Gedankens.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

FunctionCallStep

Ein Funktions-Tool-Aufrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function_call" gesetzt.

name string  (erforderlich)

Erforderlich. Der Name des aufzurufenden Tools.

arguments object  (erforderlich)

Erforderlich. Die Argumente, die an die Funktion übergeben werden sollen.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

CodeExecutionCallStep

Aufrufschritt für die Codeausführung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution_call" gesetzt.

arguments CodeExecutionCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an die Codeausführung übergeben werden sollen.

Die Argumente, die an die Codeausführung übergeben werden sollen.

Felder

language enum (string)  (optional)

Programmiersprache des „code“.

Mögliche Werte:

  • python
code string  (optional)

Der auszuführende Code.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

UrlContextCallStep

Schritt für den URL-Kontextaufruf.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context_call" gesetzt.

arguments UrlContextCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an den URL-Kontext übergeben werden sollen.

Die Argumente, die an den URL-Kontext übergeben werden sollen.

Felder

urls array (string)  (optional)

Die abzurufenden URLs.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

McpServerToolCallStep

MCPServer-Toolaufrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server_tool_call" gesetzt.

name string  (erforderlich)

Erforderlich. Der Name des aufgerufenen Tools.

server_name string  (erforderlich)

Erforderlich. Der Name des verwendeten MCP-Servers.

arguments object  (erforderlich)

Erforderlich. Das JSON-Objekt der Argumente für die Funktion.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleSearchCallStep

Google Suche-Anrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search_call" gesetzt.

arguments GoogleSearchCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an die Google Suche übergeben werden sollen.

Die Argumente, die an die Google Suche übergeben werden sollen.

Felder

queries array (string)  (optional)

Websuchanfragen für die anschließende Websuche.

search_type enum (string)  (optional)

Der Typ der aktivierten Fundierung der Suche.

Mögliche Werte:

  • web_search
  • image_search
  • enterprise_web_search
id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

FileSearchCallStep

Anrufschritt für die Dateisuche.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search_call" gesetzt.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleMapsCallStep

Anrufschritt in Google Maps

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps_call" gesetzt.

arguments GoogleMapsCallStepArguments  (optional)

Die Argumente, die an das Google Maps-Tool übergeben werden sollen.

Die Argumente, die an das Google Maps-Tool übergeben werden sollen.

Felder

queries array (string)  (optional)

Die auszuführenden Abfragen.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

FunctionResultStep

Ergebnis eines Funktions-Tool-Aufrufs.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function_result" gesetzt.

name string  (optional)

Der Name des aufgerufenen Tools.

is_error boolean  (optional)

Gibt an, ob beim Toolaufruf ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

result array (FunctionResultSubcontent) or string  (erforderlich)

Das Ergebnis des Tool-Aufrufs.

CodeExecutionResultStep

Schritt für das Ergebnis der Codeausführung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution_result" gesetzt.

result string  (erforderlich)

Erforderlich. Die Ausgabe der Codeausführung.

is_error boolean  (optional)

Gibt an, ob bei der Codeausführung ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

UrlContextResultStep

Ergebnisschritt für den URL-Kontext.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context_result" gesetzt.

result UrlContextResultItem  (erforderlich)

Erforderlich. Die Ergebnisse des URL-Kontexts.

Das Ergebnis des URL-Kontexts.

Felder

url string  (optional)

Die abgerufene URL.

status enum (string)  (optional)

Der Status des URL-Abrufs.

Mögliche Werte:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

Gibt an, ob der URL-Kontext zu einem Fehler geführt hat.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleSearchResultStep

Schritt für Google-Suchergebnisse.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search_result" gesetzt.

result GoogleSearchResultItem  (erforderlich)

Erforderlich. Die Ergebnisse der Google Suche.

Das Ergebnis der Google-Suche.

Felder

search_suggestions String  (optional)

Webinhalts-Snippet, das in eine Webseite oder eine App-Webview eingebettet werden kann.

is_error boolean  (optional)

Gibt an, ob bei der Google-Suche ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

McpServerToolResultStep

Schritt für das Ergebnis des MCPServer-Tools.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server_tool_result" gesetzt.

name string  (optional)

Name des Tools, das für diesen bestimmten Tool-Aufruf aufgerufen wird.

server_name string  (optional)

Der Name des verwendeten MCP-Servers.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

result array (FunctionResultSubcontent) or string  (erforderlich)

Die Ausgabe des MCP-Serveraufrufs. Kann einfacher Text oder Rich Content sein.

FileSearchResultStep

Schritt für Dateisuchergebnis.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search_result" gesetzt.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleMapsResultStep

Google Maps-Ergebnisschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps_result" gesetzt.

result GoogleMapsResultItem  (erforderlich)

Keine Beschreibung vorhanden.

Das Ergebnis von Google Maps.

Felder

places GoogleMapsResultPlaces  (optional)

Keine Beschreibung vorhanden.

Felder

place_id string  (optional)

Keine Beschreibung vorhanden.

name string  (optional)

Keine Beschreibung vorhanden.

url string  (optional)

Keine Beschreibung vorhanden.

review_snippets ReviewSnippet  (optional)

Keine Beschreibung vorhanden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

widget_context_token string  (optional)

Keine Beschreibung vorhanden.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

input Content oder Array (Content) oder Array (Step) oder String  (optional)

Die Eingabe für die Interaktion.

response_format ResponseFormat oder ResponseFormatList  (optional)

Erzwingt, dass die generierte Antwort ein JSON-Objekt ist, das dem in diesem Feld angegebenen JSON-Schema entspricht.

agent_config object  (optional)

Konfigurationsparameter für die Interaktion mit dem Agent.

Mögliche Typen

Polymorpher Diskriminator: type

DynamicAgentConfig

Konfiguration für dynamische Agenten.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "dynamic" gesetzt.

DeepResearchAgentConfig

Konfiguration für den Deep Research-Agenten.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "deep-research" gesetzt.

thinking_summaries ThinkingSummaries  (optional)

Gibt an, ob Zusammenfassungen der Überlegungen in die Antwort aufgenommen werden sollen.

Mögliche Werte:

  • auto
  • none

visualization enum (string)  (optional)

Gibt an, ob Visualisierungen in die Antwort aufgenommen werden sollen.

Mögliche Werte:

  • off
  • auto
collaborative_planning boolean  (optional)

Ermöglicht die Human-in-the-Loop-Planung für den Deep Research-Agenten. Wenn diese Option auf „true“ gesetzt ist, enthält die Antwort des Deep Research-Agents einen Rechercheplan. Der Agent fährt dann nur fort, wenn der Nutzer den Plan im nächsten Zug bestätigt.

event_id string  (optional)

Das event_id-Token, das zum Fortsetzen des Interaktionsstreams ab diesem Ereignis verwendet werden soll.

InteractionStatusUpdate

event_type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "interaction.status_update" gesetzt.

interaction_id string  (erforderlich)

Keine Beschreibung vorhanden.

status enum (string)  (erforderlich)

Keine Beschreibung vorhanden.

Mögliche Werte:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_id string  (optional)

Das event_id-Token, das zum Fortsetzen des Interaktionsstreams ab diesem Ereignis verwendet werden soll.

ErrorEvent

event_type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "error" gesetzt.

Fehler Fehler  (optional)

Keine Beschreibung vorhanden.

Fehlermeldung aus einer Interaktion.

Felder

code string  (optional)

Ein URI, der den Fehlertyp identifiziert.

message string  (optional)

Eine für Menschen lesbare Fehlermeldung.

event_id string  (optional)

Das event_id-Token, das zum Fortsetzen des Interaktionsstreams ab diesem Ereignis verwendet werden soll.

StepStart

event_type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "step.start" gesetzt.

index integer  (erforderlich)

Keine Beschreibung vorhanden.

step Step  (erforderlich)

Keine Beschreibung vorhanden.

Ein Schritt in der Interaktion.

Mögliche Typen

Polymorpher Diskriminator: type

UserInputStep

Vom Nutzer bereitgestellte Eingaben.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "user_input" gesetzt.

content Content  (optional)

Keine Beschreibung vorhanden.

Der Inhalt der Antwort.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Ein Audioinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "audio" gesetzt.

data string  (optional)

Die Audioinhalte.

uri string  (optional)

Der URI des Audios.

mime_type enum (string)  (optional)

Der MIME-Typ des Audios.

Mögliche Werte:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
channels integer  (optional)

Die Anzahl der Audiokanäle.

sample_rate integer  (optional)

Die Abtastrate des Audiosignals.

DocumentContent

Ein Inhaltsblock für Dokumente.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "document" gesetzt.

data string  (optional)

Der Inhalt des Dokuments.

uri string  (optional)

Der URI des Dokuments.

mime_type enum (string)  (optional)

Der MIME-Typ des Dokuments.

Mögliche Werte:

  • application/pdf
VideoContent

Ein Videocontent-Block.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "video" gesetzt.

data string  (optional)

Die Videoinhalte.

uri string  (optional)

Der URI des Videos.

mime_type enum (string)  (optional)

Der MIME-Typ des Videos.

Mögliche Werte:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ModelOutputStep

Die vom Modell generierte Ausgabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "model_output" gesetzt.

content Content  (optional)

Keine Beschreibung vorhanden.

Der Inhalt der Antwort.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Ein Audioinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "audio" gesetzt.

data string  (optional)

Die Audioinhalte.

uri string  (optional)

Der URI des Audios.

mime_type enum (string)  (optional)

Der MIME-Typ des Audios.

Mögliche Werte:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
channels integer  (optional)

Die Anzahl der Audiokanäle.

sample_rate integer  (optional)

Die Abtastrate des Audiosignals.

DocumentContent

Ein Inhaltsblock für Dokumente.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "document" gesetzt.

data string  (optional)

Der Inhalt des Dokuments.

uri string  (optional)

Der URI des Dokuments.

mime_type enum (string)  (optional)

Der MIME-Typ des Dokuments.

Mögliche Werte:

  • application/pdf
VideoContent

Ein Videocontent-Block.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "video" gesetzt.

data string  (optional)

Die Videoinhalte.

uri string  (optional)

Der URI des Videos.

mime_type enum (string)  (optional)

Der MIME-Typ des Videos.

Mögliche Werte:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ThoughtStep

Ein Gedankenschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "thought" gesetzt.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

summary ThoughtSummaryContent  (optional)

Eine Zusammenfassung des Gedankens.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

FunctionCallStep

Ein Funktions-Tool-Aufrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function_call" gesetzt.

name string  (erforderlich)

Erforderlich. Der Name des aufzurufenden Tools.

arguments object  (erforderlich)

Erforderlich. Die Argumente, die an die Funktion übergeben werden sollen.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

CodeExecutionCallStep

Aufrufschritt für die Codeausführung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution_call" gesetzt.

arguments CodeExecutionCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an die Codeausführung übergeben werden sollen.

Die Argumente, die an die Codeausführung übergeben werden sollen.

Felder

language enum (string)  (optional)

Programmiersprache des „code“.

Mögliche Werte:

  • python
code string  (optional)

Der auszuführende Code.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

UrlContextCallStep

Schritt für den URL-Kontextaufruf.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context_call" gesetzt.

arguments UrlContextCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an den URL-Kontext übergeben werden sollen.

Die Argumente, die an den URL-Kontext übergeben werden sollen.

Felder

urls array (string)  (optional)

Die abzurufenden URLs.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

McpServerToolCallStep

MCPServer-Toolaufrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server_tool_call" gesetzt.

name string  (erforderlich)

Erforderlich. Der Name des aufgerufenen Tools.

server_name string  (erforderlich)

Erforderlich. Der Name des verwendeten MCP-Servers.

arguments object  (erforderlich)

Erforderlich. Das JSON-Objekt der Argumente für die Funktion.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleSearchCallStep

Google Suche-Anrufschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search_call" gesetzt.

arguments GoogleSearchCallStepArguments  (erforderlich)

Erforderlich. Die Argumente, die an die Google Suche übergeben werden sollen.

Die Argumente, die an die Google Suche übergeben werden sollen.

Felder

queries array (string)  (optional)

Websuchanfragen für die anschließende Websuche.

search_type enum (string)  (optional)

Der Typ der aktivierten Fundierung der Suche.

Mögliche Werte:

  • web_search
  • image_search
  • enterprise_web_search
id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

FileSearchCallStep

Anrufschritt für die Dateisuche.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search_call" gesetzt.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleMapsCallStep

Anrufschritt in Google Maps

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps_call" gesetzt.

arguments GoogleMapsCallStepArguments  (optional)

Die Argumente, die an das Google Maps-Tool übergeben werden sollen.

Die Argumente, die an das Google Maps-Tool übergeben werden sollen.

Felder

queries array (string)  (optional)

Die auszuführenden Abfragen.

id String  (erforderlich)

Erforderlich. Eine eindeutige ID für diesen bestimmten Tool-Aufruf.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

FunctionResultStep

Ergebnis eines Funktions-Tool-Aufrufs.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "function_result" gesetzt.

name string  (optional)

Der Name des aufgerufenen Tools.

is_error boolean  (optional)

Gibt an, ob beim Toolaufruf ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

result array (FunctionResultSubcontent) or string  (erforderlich)

Das Ergebnis des Tool-Aufrufs.

CodeExecutionResultStep

Schritt für das Ergebnis der Codeausführung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "code_execution_result" gesetzt.

result string  (erforderlich)

Erforderlich. Die Ausgabe der Codeausführung.

is_error boolean  (optional)

Gibt an, ob bei der Codeausführung ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

UrlContextResultStep

Ergebnisschritt für den URL-Kontext.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_context_result" gesetzt.

result UrlContextResultItem  (erforderlich)

Erforderlich. Die Ergebnisse des URL-Kontexts.

Das Ergebnis des URL-Kontexts.

Felder

url string  (optional)

Die abgerufene URL.

status enum (string)  (optional)

Der Status des URL-Abrufs.

Mögliche Werte:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

Gibt an, ob der URL-Kontext zu einem Fehler geführt hat.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleSearchResultStep

Schritt für Google-Suchergebnisse.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_search_result" gesetzt.

result GoogleSearchResultItem  (erforderlich)

Erforderlich. Die Ergebnisse der Google Suche.

Das Ergebnis der Google-Suche.

Felder

search_suggestions String  (optional)

Webinhalts-Snippet, das in eine Webseite oder eine App-Webview eingebettet werden kann.

is_error boolean  (optional)

Gibt an, ob bei der Google-Suche ein Fehler aufgetreten ist.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

McpServerToolResultStep

Schritt für das Ergebnis des MCPServer-Tools.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "mcp_server_tool_result" gesetzt.

name string  (optional)

Name des Tools, das für diesen bestimmten Tool-Aufruf aufgerufen wird.

server_name string  (optional)

Der Name des verwendeten MCP-Servers.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

result array (FunctionResultSubcontent) or string  (erforderlich)

Die Ausgabe des MCP-Serveraufrufs. Kann einfacher Text oder Rich Content sein.

FileSearchResultStep

Schritt für Dateisuchergebnis.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_search_result" gesetzt.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

GoogleMapsResultStep

Google Maps-Ergebnisschritt.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "google_maps_result" gesetzt.

result GoogleMapsResultItem  (erforderlich)

Keine Beschreibung vorhanden.

Das Ergebnis von Google Maps.

Felder

places GoogleMapsResultPlaces  (optional)

Keine Beschreibung vorhanden.

Felder

place_id string  (optional)

Keine Beschreibung vorhanden.

name string  (optional)

Keine Beschreibung vorhanden.

url string  (optional)

Keine Beschreibung vorhanden.

review_snippets ReviewSnippet  (optional)

Keine Beschreibung vorhanden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

widget_context_token string  (optional)

Keine Beschreibung vorhanden.

call_id string  (erforderlich)

Erforderlich. ID, die mit der ID aus dem Funktionsaufrufblock übereinstimmen muss.

signature string  (optional)

Ein Signatur-Hash für die Backend-Validierung.

event_id string  (optional)

Das event_id-Token, das zum Fortsetzen des Interaktionsstreams ab diesem Ereignis verwendet werden soll.

StepDelta

event_type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "step.delta" gesetzt.

index integer  (erforderlich)

Keine Beschreibung vorhanden.

delta StepDeltaData  (erforderlich)

Keine Beschreibung vorhanden.

Mögliche Typen

Polymorpher Diskriminator: type

TextDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Keine Beschreibung vorhanden.

ImageDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Keine Beschreibung vorhanden.

uri string  (optional)

Keine Beschreibung vorhanden.

mime_type enum (string)  (optional)

Keine Beschreibung vorhanden.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "audio" gesetzt.

data string  (optional)

Keine Beschreibung vorhanden.

uri string  (optional)

Keine Beschreibung vorhanden.

mime_type enum (string)  (optional)

Keine Beschreibung vorhanden.

Mögliche Werte:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate integer  (optional)

Verworfen. Verwenden Sie stattdessen „sample_rate“. Der Wert wird ignoriert.

sample_rate integer  (optional)

Die Abtastrate des Audiosignals.

channels integer  (optional)

Die Anzahl der Audiokanäle.

DocumentDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "document" gesetzt.

data string  (optional)

Keine Beschreibung vorhanden.

uri string  (optional)

Keine Beschreibung vorhanden.

mime_type enum (string)  (optional)

Keine Beschreibung vorhanden.

Mögliche Werte:

  • application/pdf
VideoDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "video" gesetzt.

data string  (optional)

Keine Beschreibung vorhanden.

uri string  (optional)

Keine Beschreibung vorhanden.

mime_type enum (string)  (optional)

Keine Beschreibung vorhanden.

Mögliche Werte:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ThoughtSummaryDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "thought_summary" gesetzt.

content ThoughtSummaryContent  (optional)

Ein neues Zusammenfassungselement, das dem Gedanken hinzugefügt werden soll.

Mögliche Typen

Polymorpher Diskriminator: type

TextContent

Ein Textinhaltsblock.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text" gesetzt.

text string  (erforderlich)

Erforderlich. Der Textinhalt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ImageContent

Ein Inhaltsblock mit einem Bild.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "image" gesetzt.

data string  (optional)

Der Bildinhalt.

uri string  (optional)

Der URI des Bildes.

mime_type enum (string)  (optional)

Der MIME-Typ des Bildes.

Mögliche Werte:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (optional)

Die Auflösung der Media.

Mögliche Werte:

  • low
  • medium
  • high
  • ultra_high

ThoughtSignatureDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "thought_signature" gesetzt.

signature string  (optional)

Signatur, die mit der Backend-Quelle übereinstimmen muss, damit sie Teil der Generierung ist.

TextAnnotationDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "text_annotation_delta" gesetzt.

annotations Annotation  (optional)

Quellenangaben für modellgenerierte Inhalte.

Quellenangaben für modellgenerierte Inhalte.

Mögliche Typen

Polymorpher Diskriminator: type

UrlCitation

Eine URL-Zitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "url_citation" gesetzt.

url string  (optional)

Die URL.

title string  (optional)

Der Titel der URL.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

FileCitation

Eine Dateizitationsanmerkung.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "file_citation" gesetzt.

document_uri String  (optional)

Der URI der Datei.

file_name String  (optional)

Der Name der Datei.

source string  (optional)

Die Quelle, die einem Teil des Texts zugeordnet ist.

custom_metadata object  (optional)

Vom Nutzer bereitgestellte Metadaten zum abgerufenen Kontext.

page_number integer  (optional)

Seitenzahl des zitierten Dokuments, falls zutreffend.

media_id string  (optional)

Media-ID bei Bildquellenangaben, falls zutreffend.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

PlaceCitation

Eine Anmerkung mit einer Ortsangabe.

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "place_citation" gesetzt.

place_id string  (optional)

Die ID des Orts im Format „places/{place_id}“.

name string  (optional)

Titel des Orts.

url string  (optional)

URI-Referenz des Orts.

review_snippets ReviewSnippet  (optional)

Ausschnitte aus Rezensionen, die zum Generieren von Antworten zu den Funktionen eines bestimmten Orts in Google Maps verwendet werden.

Fasst einen Ausschnitt einer Nutzerrezension zusammen, in dem eine Frage zu den Funktionen eines bestimmten Orts in Google Maps beantwortet wird.

Felder

title string  (optional)

Titel der Rezension.

url string  (optional)

Ein Link, der der Nutzerrezension auf Google Maps entspricht.

review_id string  (optional)

Die ID des Rezensions-Snippets.

start_index Ganzzahl  (optional)

Beginn des Antwortsegments, das dieser Quelle zugeordnet wird. Der Index gibt den Beginn des Segments an, gemessen in Byte.

end_index integer  (optional)

Ende des zugeordneten Segments (ausschließlich).

ArgumentsDelta

type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "arguments_delta" gesetzt.

partial_arguments String  (optional)

Keine Beschreibung vorhanden.

event_id string  (optional)

Das event_id-Token, das zum Fortsetzen des Interaktionsstreams ab diesem Ereignis verwendet werden soll.

StepStop

event_type object  (erforderlich)

Keine Beschreibung vorhanden.

Immer auf "step.stop" gesetzt.

index integer  (erforderlich)

Keine Beschreibung vorhanden.

event_id string  (optional)

Das event_id-Token, das zum Fortsetzen des Interaktionsstreams ab diesem Ereignis verwendet werden soll.

Beispiele

Interaktion erstellt

{
  "event_type": "interaction.created",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "in_progress",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

Interaktion abgeschlossen

{
  "event_type": "interaction.completed",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "completed",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

Aktualisierung des Interaktionsstatus

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

Ereignis vom Typ „Fehler“

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}

Schrittstart

{
  "event_type": "step.start",
  "index": 0,
  "step": {
    "type": "model_output"
  }
}

Schritt-Delta

{
  "event_type": "step.delta",
  "index": 0,
  "delta": {
    "type": "text",
    "text": "Hello"
  }
}

Schrittweise Beendigung

{
  "event_type": "step.stop",
  "index": 0
}