String id

The ID of the agent.

minLength0
Optional<String> instructions

Custom instructions appended to the agent’s default base instructions.

minLength0
String model

The model used by the agent.

minLength0
MultiAgentConfig multiAgent

Configuration for creating and coordinating subagents.

boolean enabled

Whether subagent tools are enabled. Defaults to false.

Optional<Long> maxConcurrentSubagents

Maximum number of subagents that may run concurrently, or null when disabled. Defaults to 6 when enabled.

formatint64
minimum1
maximum4294967295
Optional<String> name

The reusable agent’s name when the session was created, or null if no name was saved. Later changes to the agent’s name do not affect this value.

minLength0
AgentReasoning reasoning

The agent’s reasoning configuration.

Optional<Effort> effort

The requested reasoning effort, or null when the model selects its own default.

One of the following:
NONE("none")
MINIMAL("minimal")
LOW("low")
MEDIUM("medium")
HIGH("high")
XHIGH("xhigh")
MAX("max")
Optional<Summary> summary

The requested reasoning summary format, or null when summaries are disabled.

One of the following:
CONCISE("concise")

Returns a concise reasoning summary when supported.

DETAILED("detailed")

Returns a detailed reasoning summary when supported.

AUTO("auto")

Automatically selects the most detailed summary supported by the model.

ServiceTier serviceTier

The effective service-tier policy for model requests. Defaults to auto.

One of the following:
AUTO("auto")
DEFAULT("default")
FLEX("flex")
PRIORITY("priority")
FAST("fast")
ULTRAFAST("ultrafast")

Configuration for text generated by the agent.

TextFormat format

The effective output format. Defaults to ordinary text.

One of the following:
JsonValue;
JsonValue; type
constant
constant

The type of the object. Always text.

JsonSchema
This type repeats the enclosing schema.
Verbosity verbosity

The amount of text produced by the agent. Defaults to medium.

One of the following:
LOW("low")
MEDIUM("medium")
HIGH("high")
List<AgentTool> tools

Tools available to the agent.

minItems0
maxItems2000
One of the following:
Function
This type repeats the enclosing schema.
ProgrammaticToolCalling
This type repeats the enclosing schema.
Mcp
This type repeats the enclosing schema.
WebSearch
This type repeats the enclosing schema.
ComputerUse
This type repeats the enclosing schema.
JsonValue;
JsonValue; type
constant
constant

The type of the object. Always automations.

Optional<Compaction> compaction

The effective context compaction settings.

boolean async

Whether context is compacted in the background. Defaults to false.

Optional<Experimental> experimental

The effective experimental settings for the agent.

boolean timeAwareness

Whether the model receives periodic current-time reminders.