Configure the Agent Runtime Operator

This guide walks you through customising operator-wide defaults using the AgentRuntimeConfiguration resource.

Prerequisites

When to use AgentRuntimeConfiguration

Create an AgentRuntimeConfiguration when you want to:

  • Change the default agent framework used when an Agent resource does not specify one.

  • Pin specific container images for template-based agents instead of the operator’s built-in defaults.

AgentRuntimeConfiguration is namespace-scoped and must be created in the operator’s namespace (agent-runtime-operator-system). Only one instance is allowed per operator namespace. If no configuration is provided, the operator uses its built-in defaults.

Create an AgentRuntimeConfiguration

cat <<EOF | kubectl apply -f -
apiVersion: runtime.agentic-layer.ai/v1alpha1
kind: AgentRuntimeConfiguration
metadata:
  name: default
  namespace: agent-runtime-operator-system
spec:
  defaultFramework: "google-adk"
  agentTemplateImages:
    googleAdk: "ghcr.io/agentic-layer/agent-template-adk:0.8.0"
    msaf: "ghcr.io/agentic-layer/agent-template-msaf:0.1.0"
EOF

For the full list of fields and their types, see AgentRuntimeConfiguration Reference.

Verify the configuration

kubectl get agentruntimeconfiguration default -n agent-runtime-operator-system

The resource should be listed with no error conditions. When defaultFramework is changed, the operator automatically re-reconciles all agents that do not specify a framework explicitly.

Related