Create an Agentic Workforce

This guide shows you how to create an AgenticWorkforce resource that groups entry-point agents and lets the operator discover all transitive agents and tools automatically.

Prerequisites

Create the AgenticWorkforce

cat <<EOF | kubectl apply -f -
apiVersion: runtime.agentic-layer.ai/v1alpha1
kind: AgenticWorkforce
metadata:
  name: customer-service-workforce
spec:
  name: "Customer Service Team"
  description: "A workforce handling customer inquiries, support tickets, and product recommendations"
  owner: "platform-team@example.com"
  tags:
    - customer-service
    - support
    - production
  entryPointAgents:
    - name: customer-support-agent
    # Agent in a different namespace:
    # - name: specialist-agent
    #   namespace: ai-agents
EOF

The operator crawls each entry-point agent’s sub-agent graph and populates status.transitiveAgents and status.transitiveTools.

Verify

# Check the workforce resource
kubectl get agenticworkforce customer-service-workforce

# View detailed status
kubectl describe agenticworkforce customer-service-workforce

# List discovered transitive agents
kubectl get agenticworkforce customer-service-workforce \
  -o jsonpath='{.status.transitiveAgents[*].name}'

# List discovered transitive tools
kubectl get agenticworkforce customer-service-workforce \
  -o jsonpath='{.status.transitiveTools[*]}'

Related