Package com.google.genai.types

Class LiveClientContextUpdate

java.lang.Object

com.google.genai.JsonSerializable

com.google.genai.types.LiveClientContextUpdate

public abstract class LiveClientContextUpdate
extends JsonSerializable

Updates to the context of the current session.

Only fields that are set will be updated. Updates are guaranteed to be processed *in order* with the rest of the inputs.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LiveClientContextUpdate.Builder	Builder for LiveClientContextUpdate.

Field Summary

Fields inherited from class com.google.genai.JsonSerializable

MAX_READ_LENGTH_PROPERTY

Constructor Summary

Constructors

Constructor	Description
LiveClientContextUpdate()

Method Summary

Modifier and Type	Method	Description
static LiveClientContextUpdate.Builder	builder()	Instantiates a builder for LiveClientContextUpdate.
static LiveClientContextUpdate	fromJson(String jsonString)	Deserializes a JSON string to a LiveClientContextUpdate object.
abstract Optional<Content>	systemInstruction()	Updated system instruction for the model.
abstract LiveClientContextUpdate.Builder	toBuilder()	Creates a builder with the same values as this instance.
abstract Optional<LiveClientContextUpdateTools>	tools()	An updated list of tools the model may use to generate the subsequent responses.

Methods inherited from class com.google.genai.JsonSerializable

fromJsonNode, fromJsonString, objectMapper, setMaxReadLength, stringToJsonNode, toJson, toJsonNode, toJsonString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

LiveClientContextUpdate

public LiveClientContextUpdate()

Method Details

systemInstruction

public abstract Optional<Content> systemInstruction()

Updated system instruction for the model. If set, overrides `BidiGenerateContentSetup.system_instruction`. The system instructions are part of the model preamble, so updating them invalidates the prefix cache. Clients should only update this field when strictly necessary as it might have a performance impact on the model generation.

tools

public abstract Optional<LiveClientContextUpdateTools> tools()

An updated list of tools the model may use to generate the subsequent responses. If set, this list replaces the previously provided tools. The tools are part of the model preamble, so updating them invalidates the prefix cache. Clients should only update this field when strictly necessary as it might have a performance impact on the model generation.

builder

public static LiveClientContextUpdate.Builder builder()

Instantiates a builder for LiveClientContextUpdate.

toBuilder

public abstract LiveClientContextUpdate.Builder toBuilder()

Creates a builder with the same values as this instance.

fromJson

public static LiveClientContextUpdate fromJson(String jsonString)

Deserializes a JSON string to a LiveClientContextUpdate object.