Core Resources

Core resources are the foundation of your Kubiya automation platform. Agents are AI-powered entities that execute tasks, teams enable agent collaboration, and projects help organize resources by logical groupings.

Quick Start

# List agents
kubiya agent list

Output:

Agents (4)

ID                                    NAME                        ENVIRONMENT
039f75ea-b90b-46b5-97c8-ed5475468f3c  Kubiya                     Default Environment
17ee8c4f-d7c7-4a12-9cc6-8e6e0e2a6068  shaked-test                Default Environment
3a3fe0ed-9e8f-4cbd-96fc-f3e3e5c06bdf  test                       Default Environment
e63ec06c-f2c4-42d1-8c14-7acda75c33ac  DevOps Automation Agent    Default Environment

# Create agent from file
kubiya agent create --file agent.yaml

# Execute with agent
kubiya agent exec <agent-id> "Deploy to staging"

# List teams
kubiya team list

Output:

Teams (2)

NAME                  DESCRIPTION
DevOps Team          Main DevOps automation team
Platform Team        Platform engineering team

# List projects
kubiya project list

Output:

🔍 Fetching projects...

╔════════════════════════════╗
║   🏗️  Projects (1)         ║
╚════════════════════════════╝

 ID          NAME     DESCRIPTION                            CREATED
 2667caff... Default  Default project for agents and teams  2025-11-20 22:09

Agents

AI-powered entities that execute tasks using configured skills and models.

List Agents

# Basic listing
kubiya agent list

# Output formats
kubiya agent list --output json
kubiya agent list --output yaml
kubiya agent list --output table

Get Agent Details

# View specific agent
kubiya agent get <agent-id>

# JSON output
kubiya agent get <agent-id> --output json

Create Agent

Interactive
From File

# Guided interactive creation
kubiya agent create --interactive

# Create from YAML definition
kubiya agent create --file agent.yaml

# agent.yaml
name: deployment-agent
description: Handles production deployments
model: gpt-4
skills:
  - kubernetes
  - helm
  - monitoring
environment_id: prod-env

Update Agent

# Update agent configuration
kubiya agent update <agent-id> --file agent.yaml

Delete Agent

# Delete agent
kubiya agent delete <agent-id>

# Force delete without confirmation
kubiya agent delete <agent-id> --force

Execute with Agent

# Execute task with specific agent
kubiya agent exec <agent-id> "Deploy to staging"

# Stream execution logs
kubiya agent exec <agent-id> "Deploy to staging" --stream

Teams

Groups of agents that collaborate on complex tasks.

List Teams

# List all teams
kubiya team list

# JSON output
kubiya team list --output json

Get Team Details

# View specific team
kubiya team get <team-id>

Create Team

# Create from file
kubiya team create --file team.yaml

# team.yaml
name: devops-team
description: DevOps automation team
members:
  - agent-id-1
  - agent-id-2
  - agent-id-3

Update Team

# Update team configuration
kubiya team update <team-id> --file team.yaml

Delete Team

# Delete team
kubiya team delete <team-id>

Execute with Team

# Execute task with team
kubiya team exec <team-id> "Complete production deployment"

Projects

Organizational units for grouping resources.

List Projects

# List all projects
kubiya project list

# JSON output
kubiya project list --output json

Get Project Details

# View project details
kubiya project get <project-id>

Create Project

# Create from file
kubiya project create --file project.yaml

Best Practices

Use descriptive naming: prod-deployment-agent, staging-devops-team
Include environment prefix: prod-*, staging-*, dev-*
Use hyphens not underscores: my-agent not my_agent
Group by project for better organization
Use teams to organize agents by functional area
Store agent YAML definitions in version control
Test agents in dev/staging before production

Command Reference

# Agents
kubiya agent list [--output json|yaml|table]
kubiya agent get <id>
kubiya agent create --file agent.yaml
kubiya agent create --interactive
kubiya agent update <id> --file agent.yaml
kubiya agent delete <id> [--force]
kubiya agent exec <id> "prompt" [--stream]
kubiya agent chat <id>

# Teams
kubiya team list [--output json|yaml]
kubiya team get <id>
kubiya team create --file team.yaml
kubiya team update <id> --file team.yaml
kubiya team delete <id>
kubiya team exec <id> "prompt"

# Projects
kubiya project list [--output json|yaml]
kubiya project get <id>
kubiya project create --file project.yaml

Next Steps

Execute Tasks

Execute tasks with your agents using automatic planning

Execution Resources

Manage executions, jobs, and workers

Capabilities

Add skills, models, and policies to agents

Infrastructure

Configure environments and platform operations

Getting Started

On-Demand Execution

Control Plane

Control Plane Resources

Context Graph

Cognitive Memory

Advanced

Core Resources

Quick Start

Agents

List Agents

Get Agent Details

Create Agent

Update Agent

Delete Agent

Execute with Agent

Teams

List Teams

Get Team Details

Create Team

Update Team

Delete Team

Execute with Team

Projects

List Projects

Get Project Details

Create Project

Best Practices

Command Reference

Next Steps

Execute Tasks

Execution Resources

Capabilities

Infrastructure

​Quick Start

​Agents

​List Agents

​Get Agent Details

​Create Agent

​Update Agent

​Delete Agent

​Execute with Agent

​Teams

​List Teams

​Get Team Details

​Create Team

​Update Team

​Delete Team

​Execute with Team

​Projects

​List Projects

​Get Project Details

​Create Project

​Best Practices

​Command Reference

​Next Steps

Execute Tasks

Execution Resources

Capabilities

Infrastructure

Quick Start

Agents

List Agents

Get Agent Details

Create Agent

Update Agent

Delete Agent

Execute with Agent

Teams

List Teams

Get Team Details

Create Team

Update Team

Delete Team

Execute with Team

Projects

List Projects

Get Project Details

Create Project

Best Practices

Command Reference

Next Steps