Skip to main content

Agent Deployment Config

AgentDeploymentConfig​

Per-environment runtime configuration for an AI agent.

It overrides version, scaling, CPU, memory, environment variables and Agent Gateway routing of a shared Agent on Agent Engine (Vertex AI Reasoning Engine). It is the agent equivalent of DeploymentConfig.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be AgentDeploymentConfig.
metadatamapThe engine reads the reserved keys project and environment to resolve the identity of the manifest, its parent Project and the Agent that it deploys.
specSpecAgent deployment configuration. See Spec.

Spec​

Per-environment deployment overrides.

The engine matches the linked Agent by name within the parent Project.

PropertyTypeDescription
descriptionstringOptional description. The engine copies it to the description of the Agent Engine ReasoningEngine.
versionstringVersion tag that CI pushed, for example 0.1.0 or 1.2.3-rc1. It selects the built package to deploy from the source registry. Required.
scalingScalingConfigAutoscaling bounds. See ScalingConfig.
cpustringNumber of vCPUs, as a string, for example 1, 2 or 4. If empty, the platform default applies.
memorystringMemory, as a quantity string, for example 4Gi or 8Gi. If empty, the platform default applies.
envlist of EnvVariableDefinitionName/value environment variables for the agent runtime. The engine adds its own variables. They include the OpenTelemetry logging settings for prompts and responses, and the bucket names and secret references from access-control grants.
clientToAgentGatewaystringAgent Gateway for client-to-agent (ingress) traffic: projects/{project}/locations/{location}/agentGateways/{gateway_id}. Applies only when not empty.
agentToAnywhereGatewaystringAgent Gateway for agent-to-anywhere (egress) traffic: projects/{project}/locations/{location}/agentGateways/{gateway_id}. Applies only when not empty.

ScalingConfig​

Instance autoscaling bounds.

Lower and upper limits on the number of agent instances.

PropertyTypeDescription
minint64Minimum number of instances. Applies only when greater than 0.
maxint64Maximum number of instances. Applies only when greater than 0.

EnvVariableDefinition​

Static environment variable.

The engine adds it to the environment of the container.

PropertyTypeDescription
namestringVariable name.
valuestringLiteral value.