Agent Deployment Config
AgentDeploymentConfig
Per-environment runtime configuration for an AI agent.
Provides environment-specific overrides — version, scaling, CPU/memory, environment variables, and Agent Gateway routing — layered on top of a shared Agent manifest so one agent can be tuned per environment (e.g. staging vs production) when deployed to Agent Engine (Vertex AI Reasoning Engine). This is the agent equivalent of DeploymentConfig: the same parent relationship to Project and the same per-environment versioning pattern, with fields specific to Agent Engine.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Pins the manifest to a specific schema contract for backward-compatibility. Must be the constant lowops.manifests.v1. |
| kind | string | Resource kind discriminator. Identifies this document as an AgentDeploymentConfig so the engine routes it to the correct defaulter, validator, computer, and executor. Must be the constant AgentDeploymentConfig. |
| metadata | map | Classification labels and graph linkage. Free-form key/value pairs used to classify the manifest. Certain reserved keys (e.g. project, environment) are read by the engine to resolve this manifest's identity, its parent Project, and the Agent it deploys. |
| spec | Spec | Desired agent deployment configuration. The authoritative, user-authored specification for this agent deployment. See Spec. |
Spec
Per-environment deployment overrides.
Environment-specific configuration for the agent deployment: the artifact version to roll out, autoscaling bounds, CPU/memory allocation, runtime environment variables, and Agent Gateway routing. The linked Agent is matched by name within the parent Project.
| Property | Type | Description |
|---|---|---|
| description | string | Human-readable description of this deployment configuration. Optional free text describing the role of this config. Propagated onto the provisioned Agent Engine ReasoningEngine's description field, and used as context by AI assistants when reasoning about the manifest. |
| version | string | Agent artifact version tag. Required. The version tag pushed during CI (e.g. 0.1.0, 1.2.3-rc1) that identifies which built package to deploy from the source registry. Combined with the resolved registry URI and image name to form the container image URI rolled out to Agent Engine. |
| scaling | ScalingConfig | Autoscaling bounds for this deployment. See ScalingConfig. Sets the min/max instance count applied to the Agent Engine runtime. |
| cpu | string | CPU allocation for the agent runtime. Number of vCPUs for the Agent Engine runtime, expressed as a string (e.g. 1, 2, 4). Only applied when non-empty; otherwise the platform default applies. |
| memory | string | Memory allocation for the agent runtime. Memory for the Agent Engine runtime, expressed as a quantity string (e.g. 4Gi, 8Gi). Only applied when non-empty; otherwise the platform default applies. |
| env | list of EnvVariableDefinition | Environment variables for the agent runtime. Plain name/value variables injected into the Agent Engine runtime. Merged with platform-injected variables such as the OpenTelemetry prompt/response logging settings and any variables derived from the agent's access-control grants (bucket names, secret references). |
| clientToAgentGateway | string | Ingress Agent Gateway resource name. Agent Gateway used for client-to-agent (ingress) traffic, in the form projects/{project}/locations/{location}/agentGateways/{gateway_id}. Only applied when non-empty; wired to the deployment's client-to-agent gateway. |
| agentToAnywhereGateway | string | Egress Agent Gateway resource name. Agent Gateway used for agent-to-anywhere (egress) traffic, in the form projects/{project}/locations/{location}/agentGateways/{gateway_id}. Only applied when non-empty; wired to the deployment's agent-to-anywhere gateway. |
ScalingConfig
Instance autoscaling bounds.
Lower and upper limits on the number of running agent instances, balancing latency against cost. Applied to the Agent Engine runtime's min/max instance settings.
| Property | Type | Description |
|---|---|---|
| min | int64 | Minimum number of instances to keep running. Floor for the autoscaler. Only applied when greater than 0. |
| max | int64 | Maximum number of instances to scale out to. Ceiling for the autoscaler. Only applied when greater than 0. |
EnvVariableDefinition
Defines a static environment variable to be injected.
Appended to the environment variable array of the corresponding compute resource container definition.
| Property | Type | Description |
|---|---|---|
| name | string | The environment variable name. |
| value | string | The literal value assigned to the environment variable. |