Reference on AgentOps

CRD Reference

Mon, 01 Jan 0001 00:00:00 +0000

All CRDs belong to the API group agents.agentops.io/v1alpha1. The operator installs them automatically via the Helm chart.

kubectl get crds | grep agentops

agents.agents.agentops.io
agentruns.agents.agentops.io
agenttools.agents.agentops.io
agentresources.agents.agentops.io
channels.agents.agentops.io
providers.agents.agentops.io

Agent

Defines an AI agent workload. The mode field determines the lifecycle: daemon creates a Deployment + PVC + Service (always running), task creates a Job template (one prompt, exits).

apiVersion: agents.agentops.io/v1alpha1
kind: Agent
metadata:
 name: my-agent
 namespace: agents

Short name: ag

Memory API

Mon, 01 Jan 0001 00:00:00 +0000

The agentops-memory service provides a REST API for managing sessions, observations, search, and context injection. It runs as a standalone Go binary backed by SQLite with FTS5 for BM25 relevance-ranked full-text search.

Image: ghcr.io/samyn92/agentops-memory Default port: 7437 In-cluster DNS: agentops-memory.agents.svc.cluster.local:7437

Input validation

All endpoints enforce the following limits:

Constraint	Limit
Request body size	1 MiB
Title length	500 characters
Content length	50,000 characters
Topic key length	200 characters
Scope length	50 characters
Type length	50 characters
Tag length	100 characters per tag
Tag count	20 tags per observation
Project length	200 characters
Query result limit	1,000 rows maximum

Health

GET /health

Health check endpoint.

Tool Catalog

Mon, 01 Jan 0001 00:00:00 +0000

AgentOps ships seven MCP tool servers as OCI artifacts. Each server is a compiled Go binary implementing MCP stdio transport, built on the shared mcputil SDK that provides automatic OpenTelemetry tracing for every tool invocation. Agents reference them via AgentTool CRs, and the operator pulls the binary at pod startup via a crane init container.

All tool servers are published to ghcr.io/samyn92/agent-tools/. Binaries follow the mcp-{server} naming convention.

kube-explore

Intent-based Kubernetes exploration. Higher-level than raw kubectl – the agent describes what it wants to understand, and the tool returns structured, relevant information.

Helm Values Reference

Mon, 01 Jan 0001 00:00:00 +0000

The agentops-platform chart is an umbrella chart that deploys all AgentOps platform components. This page documents every configurable value.

Global

Key	Type	Default	Description
`global.imagePullSecrets`	list	`[]`	Image pull secrets applied to all sub-charts. Each entry is an object with a `name` field.
`agentNamespace`	string	`agents`	Namespace where agent workloads are deployed.
`createNamespace`	bool	`true`	Whether to create the agent namespace if it does not exist.

global:
 imagePullSecrets:
 - name: ghcr-secret
agentNamespace: agents
createNamespace: true

agentops-operator

The Kubernetes operator that reconciles Agent, AgentTool, and related CRDs.