Kubiya LogoKubiya Developer Docs

Quick Start Guide

Create your first automated task in 5 minutes

🚀 Quick Start Guide

⏱️ 5 Minutes to Your First Automation

Let's create your first automated task. No coding required—just describe what you want to do.

🎯 Before You Start

Make sure you have:

  • Access to the Kubiya platform
  • A task in mind to automate (we'll provide examples if needed)

🏃 Create Your First Task

Open Agent Composer

Navigate to Agent Composer in your Kubiya dashboard

Describe Your Task

Type what you want to accomplish in plain English

Try one of these examples:

  • • "Check disk usage on all servers and alert if above 80%"
  • • "Generate a security report for our AWS infrastructure"
  • • "List all pods in the production namespace"

Hit Enter to Execute

Watch as the agent plans and executes your task

Agent analyzes your request
Creates execution plan
Executes with live updates

🎨 Understanding the Interface

Task Input Area

💬
Basic Mode

Type your request naturally

📝
Detailed Mode

Add title and detailed instructions

Execution Options

▶️
Run Now

Execute immediately (default)

📅
Schedule

Set for later or recurring

🔗
Webhook

Trigger via external events

🛠️ Enhance Your Tasks

Add Context and Tools

Click the toolbar buttons to enhance your task:

@
Context
Secrets, docs, variables
🖥️
Runner
Execution environment
🔧
MCP Tools
Enhanced capabilities
⚙️
Settings
Execution preferences

Execution Modes

📋 Plan Mode

Review the execution plan before running. Great for learning or critical tasks.

Act Mode

Execute immediately with auto-approval. Perfect for routine tasks.

👁️ Watch It Work

Once you submit a task, you'll see:

1

Planning Phase

Agent analyzes and creates execution strategy

2

Execution Phase

Step-by-step execution with live output

3

Results

Summary of what was accomplished

Interactive Approvals: Some actions require your confirmation. Click "Approve" when prompted to continue execution.

💡 Example Tasks to Try

🚀 DevOps Tasks

"Check the status of all deployments in the staging namespace"
"Scale the web-app deployment to 3 replicas"
"Show me pod resource usage sorted by memory"

🔒 Security Tasks

"List all service accounts with admin privileges"
"Check for pods running as root user"
"Scan images for critical vulnerabilities"

📊 Monitoring Tasks

"Generate a report of error logs from the last hour"
"Check certificate expiration dates for all ingresses"
"Show me failed jobs from today"

🎯 Pro Tips for Success

💡

Be Specific

Instead of "check servers", say "check CPU usage on production web servers"

🔐

Use Secrets

Reference stored credentials with @ instead of hardcoding

📋

Start with Plan Mode

Review what will happen before execution for new tasks

🔄

Iterate and Improve

Refine your prompts based on results for better outcomes

🚨 Troubleshooting

Task Failed?

  • Check the error message for specific issues
  • Try rephrasing your request more clearly
  • Ensure you have the necessary permissions
  • Switch to a different runner if needed

🎬 What's Next?


🎉 Congratulations!

You're ready to automate with Agent Composer. Start simple, then gradually explore advanced features as you get comfortable.