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.

yaml

apiVersion: deployments.plural.sh/v1alpha1
kind: AgentRuntime
metadata:
  name: claude-default
  namespace: plrl-deploy-operator
spec:
  targetNamespace: plrl-deploy-operator
  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.

Run an agent from the Console UI

Agent runs are created from the Console UI. Use the flow below to start a run and review results.

Step 1: Open Agent runs

Navigate to Plural AI -> Agent runs.