Team API

Bind named Agents into a Team that can be targeted by a Run.

Kubernetes resource

The Team v1alpha1 chart schema accepts spec.agents, each with a required binding name and agentRef. A binding can also set systemPromptOverride or contextPrompt. Referenced Agents must live in the same namespace.

apiVersion: core.kaigents.io/v1alpha1
kind: Team
metadata:
  name: research-team
  namespace: kaigents
spec:
  agents:
    - name: researcher
      agentRef: documentation-agent
      contextPrompt: "Focus on the user request."

Run the Team

A Team groups Agents; workflow-specific sequencing should be defined separately in Tasks and Processes.

apiVersion: core.kaigents.io/v1alpha1
kind: Run
metadata:
  name: research-run
  namespace: kaigents
spec:
  target:
    kind: Team
    name: research-team
  input: "Summarize the available material."

Inspect and troubleshoot

Check for a missing agentRef and inspect Run conditions if execution fails. A schema-valid Team is not proof that its referenced Agents or external services are ready.

kubectl get team research-team -n kaigents -o yaml
kubectl explain team.spec.agents --api-version=core.kaigents.io/v1alpha1

All documentation Getting started