×

How to Use ClickUp AI Agents

/ ClickUp / By

How to Use ClickUp AI Agents on Kubernetes

This guide explains how to run AI Agents from ClickUp on your own Kubernetes cluster using the official Helm chart and configuration options.

You will learn how to:

  • Prepare a Kubernetes cluster and registry
  • Deploy the AI Agent Hub with Helm
  • Configure models, providers, and environment variables
  • Manage secrets and connections securely
  • Control logging, scaling, and agent behavior

Prerequisites for ClickUp AI Agents

Before deploying the AI Agent Hub, make sure your environment meets these requirements:

  • A running Kubernetes cluster (any CNCF conformant distribution)
  • kubectl configured to talk to your cluster
  • Helm installed locally
  • Container registry access (optional if you use the public images)
  • At least one supported model provider account (for example, OpenAI)

The AI Agent Hub is a containerized service that exposes APIs consumed by the ClickUp AI Agents hub page and tasks. It manages agent definitions, execution, and communication with model providers.

Install the ClickUp AI Agent Hub with Helm

The recommended way to deploy the AI Agent Hub is with Helm. The chart installs all required components and lets you configure them through a single values file.

Step 1: Add the Helm repository

First, add the official Helm repository that contains the AI Agent Hub chart. In your terminal, run:

helm repo add clickup-ai-agents https://clickup.com/p/ai-agents/k8s
helm repo update

This command registers the chart source so you can install or upgrade the deployment later.

Step 2: Create a values file

Create a file named values.yaml to define how the AI Agent Hub runs in your cluster. A simple example configuration might include:

  • Image repository and tag
  • Service type (ClusterIP, NodePort, or LoadBalancer)
  • Ingress configuration
  • Database connection (if required)
  • Environment variables for model providers

An example skeleton:

image:
  repository: your-registry/ai-agent-hub
  tag: latest

service:
  type: ClusterIP

env:
  - name: OPENAI_API_KEY
    valueFrom:
      secretKeyRef:
        name: ai-agents-secrets
        key: openai-api-key

Adjust these values to match your cluster and registry settings.

Step 3: Install the chart

With the repository added and the values file created, install the AI Agent Hub:

helm install ai-agent-hub clickup-ai-agents/agent-hub -f values.yaml

This deploys the AI Agent Hub resources into your cluster. To upgrade later, modify values.yaml and run:

helm upgrade ai-agent-hub clickup-ai-agents/agent-hub -f values.yaml

Configure ClickUp Agent Connections

Once the AI Agent Hub is running, you must configure how it connects to model providers, tools, and the ClickUp workspace.

Set environment variables for providers

Provider credentials and configuration are passed as environment variables to the AI Agent Hub containers. Use Kubernetes Secrets to keep these values secure.

Example secret:

apiVersion: v1
kind: Secret
metadata:
  name: ai-agents-secrets
type: Opaque
data:
  openai-api-key: <base64-encoded-key>

Then reference this secret in your values.yaml environment section as shown earlier.

Connect the hub to ClickUp

The AI Agent Hub must be reachable from the ClickUp backend. Typically this is done using:

  • An HTTPS ingress with a public hostname
  • Valid TLS certificates (via cert-manager or another solution)
  • Firewall rules that allow ClickUp services to access your endpoint

Your values.yaml may include an ingress block such as:

ingress:
  enabled: true
  className: nginx
  hosts:
    - host: ai-agents.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - hosts:
        - ai-agents.example.com
      secretName: ai-agents-tls

Use the hostname you configure here when registering the external AI Agent Hub with your ClickUp workspace, following the instructions on the official Kubernetes deployment page.

Manage ClickUp AI Agent Settings

With the backend running, you can control how agents behave and how they appear in the ClickUp interface.

Define agent capabilities

Agents are configured with capabilities like:

  • Which models they can call
  • Allowed tools and functions
  • Context windows and memory policies
  • Rate limits per user or per workspace

These settings are usually stored as configuration objects the AI Agent Hub reads at startup, often via ConfigMaps or mounted configuration files.

Enable agents for ClickUp users

After configuration, agents can be exposed to end users inside ClickUp. Typical options include:

  • Enabling specific agents for chosen spaces or folders
  • Restricting powerful tools to admins or specific teams
  • Setting default agents for certain task types

Control these behaviors through the workspace settings panel tied to your external AI Agent Hub.

Monitor and Scale ClickUp AI Agents

Production deployments of the AI Agent Hub should be monitored, logged, and scaled to handle variable workloads.

Logging and observability

Use Kubernetes logging and observability tools to track:

  • Agent request volume
  • Latency to model providers
  • Error rates from tools and APIs
  • Token usage by workspace or agent

Configure log output in the Helm values and forward it to your central logging solution.

Horizontal scaling

To handle more traffic, scale the AI Agent Hub deployment:

kubectl scale deployment ai-agent-hub --replicas=3

Or use a Horizontal Pod Autoscaler driven by CPU, memory, or custom metrics. Be sure your agents are stateless or use shared storage or databases where required.

Troubleshooting ClickUp AI Agent Deployments

If agents are not responding correctly in ClickUp, work through these checks:

  • Confirm pods are running: kubectl get pods
  • Check logs for errors in provider connections
  • Verify DNS and TLS for the ingress hostname
  • Ensure the AI Agent Hub endpoint is registered correctly with your workspace
  • Check that required secrets and environment variables are present

Many connection or authentication issues stem from incorrect secrets or misconfigured ingress rules.

More Resources for ClickUp AI Agents

To explore the full configuration reference, best practices, and advanced options for AI Agents, review the official Kubernetes deployment documentation provided by ClickUp at this page.

For additional implementation help, strategy, or integration support alongside your ClickUp deployment, you can also consult a specialist team such as Consultevo.

By following the steps in this guide and tailoring the Helm configuration to your infrastructure, you can run robust, enterprise-grade AI Agents on Kubernetes while keeping tight control over data, security, and performance.

Need Help With ClickUp?

If you want expert help building, automating, or scaling your ClickUp workspace, work with ConsultEvo — trusted ClickUp Solution Partners.

Get Help

“`

Verified by MonsterInsights