Agent configuration and usage

Configure agent runtimes and run agent tasks.

Prerequisites

A repository connected in Plural Console (agents can only select from configured repos).
SCM connection configured outside the agent UI (for example, via SCM integration settings).

Configure an AgentRuntime

Use AgentRuntime to define the provider, credentials, and runtime options. For field-level details, see the AgentRuntime API reference and AgentRuntimeSpec API reference.

yaml

apiVersion: deployments.plural.sh/v1alpha1
kind: AgentRuntime
metadata:
  name: claude-default
  namespace: plrl-agents
spec:
  targetNamespace: plrl-agents
  type: CLAUDE
  default: true
  aiProxy: true
  config:
    claude:
      apiKeySecretRef:
        name: ai-config
        key: anthropic
      model: claude-3-5-sonnet-latest

Supported runtime types are CLAUDE, OPENCODE, and GEMINI.

Tune runtime resources

AgentRuntime accepts a pod template so you can set CPU/memory requests and limits for the agent container. Use the default container name to target the main agent container.

yaml

apiVersion: deployments.plural.sh/v1alpha1
kind: AgentRuntime
metadata:
  name: claude-default
  namespace: plrl-agents
spec:
  targetNamespace: plrl-agents
  type: CLAUDE
  template:
    spec:
      containers:
        - name: default
          resources:
            requests:
              cpu: "1"
              memory: 2Gi
            limits:
              cpu: "4"
              memory: 8Gi

If you enable a browser sidecar, use spec.browser.container.resources to tune the browser container resources.