About this reference#
Generated from the CustomResourceDefinition schemas included with the release. These are the same schemas the Kubernetes API server uses to validate AgentFleet resources.
AgentPolicy#
AgentPolicy governs whether an agent may execute a request.
| Field | Type | Description |
|---|---|---|
| spec.targetRef | object | — |
| spec.targetRef.kind | string | required Minimum length 1. |
| spec.targetRef.name | string | required Minimum length 1. |
| spec.selector | object | — |
| spec.selector.matchLabels | object | — |
| spec.tenant | string | — |
| spec.allowedModels | object[] | — |
| spec.allowedModels[].provider | string | required Minimum length 1. |
| spec.allowedModels[].model | string | — |
| spec.deniedModels | object[] | — |
| spec.deniedModels[].provider | string | required Minimum length 1. |
| spec.deniedModels[].model | string | — |
| spec.allowedTools | object[] | — |
| spec.allowedTools[].name | string | required Minimum length 1. |
| spec.allowedTools[].type | enum | One of http, mcp, database, queue, custom. |
| spec.allowedTools[].serverRef | object | — |
| spec.allowedTools[].serverRef.name | string | required Minimum length 1. |
| spec.allowedTools[].serverRef.namespace | string | — |
| spec.deniedTools | object[] | — |
| spec.deniedTools[].name | string | required Minimum length 1. |
| spec.deniedTools[].type | enum | One of http, mcp, database, queue, custom. |
| spec.deniedTools[].serverRef | object | — |
| spec.deniedTools[].serverRef.name | string | required Minimum length 1. |
| spec.deniedTools[].serverRef.namespace | string | — |
| spec.allowedProviders | string[] | — |
| spec.regions | object | — |
| spec.regions.allowed | string[] | — |
| spec.regions.denied | string[] | — |
| spec.costLimits | object | — |
| spec.costLimits.perRequestUSD | number | Minimum 0. |
| spec.costLimits.dailyUSD | number | Minimum 0. |
| spec.costLimits.monthlyUSD | number | Minimum 0. |
| spec.costLimits.tokenLimit | integer | Minimum 0. Format int64. |
| spec.approval | object | — |
| spec.approval.required | boolean | — |
| spec.approval.approvers | string[] | — |
| spec.approval.reason | string | — |
| spec.approval.ttlSeconds | integer | Minimum 1. Format int32. |
| spec.audit | object | — |
| spec.audit.level | enum | One of metadata, request, full. |
| spec.audit.retentionDays | integer | Minimum 1. Format int32. |
| spec.audit.exportSinks | object[] | — |
| spec.audit.exportSinks[].name | string | required Minimum length 1. |
| spec.audit.exportSinks[].namespace | string | — |
| spec.enforcementMode | enum | One of enforce, dryRun, disabled. |
AgentRoute#
AgentRoute maps explicit routes, intents, or capabilities to eligible agents.
| Field | Type | Description |
|---|---|---|
| spec.routeType | enum | required One of explicit, intent, capability, fallback. |
| spec.agentRef | object | — |
| spec.agentRef.name | string | required Minimum length 1. |
| spec.agentRef.namespace | string | — |
| spec.selector | object | — |
| spec.selector.matchLabels | object | — |
| spec.selector.capabilities | string[] | — |
| spec.intent | object | — |
| spec.intent.name | string | — |
| spec.intent.phrases | string[] | — |
| spec.capabilities | string[] | — |
| spec.priority | integer | Format int32. |
| spec.weight | integer | Minimum 0. Format int32. |
| spec.enabled | boolean | — |
| spec.tenant | string | — |
| spec.policyRefs | object[] | — |
| spec.policyRefs[].name | string | required Minimum length 1. |
| spec.policyRefs[].namespace | string | — |
| spec.timeouts | object | — |
| spec.timeouts.requestSeconds | integer | Minimum 1. Format int32. |
| spec.retries | object | — |
| spec.retries.attempts | integer | Minimum 0. Format int32. |
Agent#
Agent is a deployable or externally registered AI agent.
| Field | Type | Description |
|---|---|---|
| spec.suspended | boolean | Suspended is the operator-controlled kill switch. Suspended agents are scaled to zero and remain unavailable to Gateway and Model Router calls. |
| spec.runtime | enum | required One of langgraph, crewai, openai-agents-sdk, omnigent, google-adk, databricks-agent, external-a2a, external-http, custom. |
| spec.hostingMode | enum | required One of kubernetes, external, managed. |
| spec.version | string | required Minimum length 1. |
| spec.owner | string | required Minimum length 1. |
| spec.tenant | string | — |
| spec.description | string | — |
| spec.image | object | — |
| spec.image.repository | string | required Minimum length 1. |
| spec.image.tag | string | required Minimum length 1. |
| spec.image.pullPolicy | string | — |
| spec.image.pullSecrets | object[] | — |
| spec.image.pullSecrets[].name | string | required Minimum length 1. |
| spec.image.pullSecrets[].namespace | string | — |
| spec.replicas | integer | Minimum 0. Format int32. |
| spec.service | object | required — |
| spec.service.port | integer | required Minimum 1. Format int32. |
| spec.service.protocol | enum | required One of HTTP, HTTPS, GRPC. |
| spec.service.invokePath | string | required — |
| spec.service.healthPath | string | — |
| spec.service.readyPath | string | — |
| spec.service.metadataPath | string | — |
| spec.service.metricsPath | string | — |
| spec.service.timeoutSeconds | integer | Minimum 1. Format int32. |
| spec.externalEndpoint | object | — |
| spec.externalEndpoint.url | string | required Minimum length 1. |
| spec.externalEndpoint.authRef | object | — |
| spec.externalEndpoint.authRef.name | string | required Minimum length 1. |
| spec.externalEndpoint.authRef.key | string | — |
| spec.externalEndpoint.tls | object | — |
| spec.externalEndpoint.tls.insecureSkipVerify | boolean | — |
| spec.externalEndpoint.tls.caSecretRef | object | — |
| spec.externalEndpoint.tls.caSecretRef.name | string | required Minimum length 1. |
| spec.externalEndpoint.tls.caSecretRef.key | string | — |
| spec.externalEndpoint.providerEndpointID | string | — |
| spec.capabilities | object[] | required — |
| spec.capabilities[].name | string | required Minimum length 1. |
| spec.capabilities[].description | string | — |
| spec.capabilities[].confidence | number | Minimum 0. |
| spec.capabilities[].tags | string[] | — |
| spec.models | object[] | — |
| spec.models[].provider | string | required Minimum length 1. |
| spec.models[].model | string | — |
| spec.models[].priority | integer | Format int32. |
| spec.models[].maxCostUSD | number | Minimum 0. |
| spec.tools | object[] | — |
| spec.tools[].name | string | required Minimum length 1. |
| spec.tools[].type | enum | required One of http, mcp, database, queue, custom. |
| spec.tools[].serverRef | object | — |
| spec.tools[].serverRef.name | string | required Minimum length 1. |
| spec.tools[].serverRef.namespace | string | — |
| spec.tools[].description | string | — |
| spec.contractRef | object | — |
| spec.contractRef.name | string | required Minimum length 1. |
| spec.contractRef.namespace | string | — |
| spec.policyRefs | object[] | — |
| spec.policyRefs[].name | string | required Minimum length 1. |
| spec.policyRefs[].namespace | string | — |
| spec.clusterSelector | object | — |
| spec.provider | object | — |
| spec.provider.name | string | — |
| spec.provider.project | string | — |
| spec.provider.region | string | — |
| spec.provider.resourceID | string | — |
| spec.mesh | object | — |
| spec.mesh.enabled | boolean | — |
| spec.mesh.provider | enum | One of istio, linkerd, none, other. |
| spec.mesh.mode | enum | One of sidecar, ambient, none. |
| spec.mesh.mTLS | enum | One of strict, permissive, disabled. |
| spec.mesh.trafficPolicy | string | — |
| spec.resources | object | — |
| spec.resources.requests | object | — |
| spec.resources.limits | object | — |
| spec.env | object[] | — |
| spec.env[].name | string | required Minimum length 1. |
| spec.env[].value | string | — |
| spec.env[].valueFromSecret | object | — |
| spec.env[].valueFromSecret.name | string | required Minimum length 1. |
| spec.env[].valueFromSecret.key | string | — |
| spec.secrets | object[] | — |
| spec.secrets[].name | string | required Minimum length 1. |
| spec.secrets[].namespace | string | — |
| spec.observability | object | — |
| spec.observability.metricsPath | string | — |
| spec.observability.tracingEnabled | boolean | — |
| spec.observability.logLevel | string | — |