One of the following:
class PersistedAgentToolResourceFunction: …

A function defined by the application.

defer_loading: bool

Whether the function is deferred and discovered through tool search.

description: str

A description of what the function does.

minLength0
name: str

The name of the function.

minLength0
parameters: Dict[str, object]

A JSON Schema object describing the function’s arguments.

type: Literal["function"]

The type of the object. Always function.

async_: Optional[bool]

Whether the agent continues without waiting for the function result.

class PersistedAgentToolResourceToolSearch: …

Discovers deferred function tools and loads them into the model context.

type: Literal["tool_search"]

The type of the object. Always tool_search.

class PersistedAgentToolResourceProgrammaticToolCalling: …

Enables calling tools from model-generated code.

enabled: bool

Whether tools can be called from model-generated code.

type: Literal["programmatic_tool_calling"]

The type of the object. Always programmatic_tool_calling.

class PersistedAgentToolResourceMcp: …

Tools provided by a remote MCP server without stored credentials.

allowed_tools: Optional[List[str]]

The MCP tools the agent may call, or null when all server tools are allowed.

minItems0
maxItems2000
connection_origin: Literal["service", "environment"]

Where outbound MCP HTTP connections originate.

One of the following:
"service"
"environment"
credential_id: Optional[str]

The vault credential selected for this MCP server, if any.

minLength0
request_metadata: Dict[str, object]

Metadata included with requests to this MCP server.

required: bool

Whether this MCP server must initialize before the first turn.

server_label: str

A label used to identify the MCP server in tool calls.

minLength0

The credential-free transport used to connect to the MCP server.

One of the following:
class PersistedMcpTransportResourceHTTP: …

Connects to an MCP server over HTTP.

headers: Dict[str, str]

Non-secret HTTP headers sent to the MCP server.

server_url: str

The URL of the MCP server.

minLength0
type: Literal["http"]

The type of the object. Always http.

class PersistedMcpTransportResourceStdio: …

Starts an MCP server as a local process.

args: List[str]

Arguments passed to the MCP server command.

minItems0
maxItems2000
command: str

The command used to start the MCP server.

minLength0
cwd: str

The working directory used to start the MCP server.

minLength0
env_vars: List[str]

Environment variable names inherited from the execution environment.

minItems0
maxItems2000
type: Literal["stdio"]

The type of the object. Always stdio.

type: Literal["mcp"]

The type of the object. Always mcp.

class PersistedAgentToolResourceWebSearch: …

Web search.

allowed_domains: Optional[List[str]]

Allowed search domains, or null when the search is unrestricted.

minItems0
maxItems2000
context_size: Literal["low", "medium", "high"]

The amount of search context made available to the model. Defaults to medium.

One of the following:
"low"
"medium"
"high"
location: Optional[PersistedAgentToolResourceWebSearchLocation]

Approximate location used to localize search results, if provided.

city: Optional[str]

The city name.

minLength0
country: Optional[str]

The two-letter ISO country code, such as US.

minLength0
region: Optional[str]

The region or state name.

minLength0
timezone: Optional[str]

The IANA timezone, such as America/Los_Angeles.

minLength0
mode: Literal["disabled", "cached", "live"]

The source used for web search results.

One of the following:
"disabled"
"cached"
"live"
type: Literal["web_search"]

The type of the object. Always web_search.

class PersistedAgentToolResourceComputerUse: …

Browser use in an OpenAI-hosted session.

include_screenshots: bool

Whether computer tool outputs include screenshots.

type: Literal["computer_use"]

The type of the object. Always computer_use.

class PersistedAgentToolResourceAutomations: …

Lets the agent manage its own scheduled wakeups.

type: Literal["automations"]

The type of the object. Always automations.