Why Meta Agent?
Kubiya provides powerful primitives: agents, teams, environments, skills, policies, and cognitive memory. But navigating these resources typically requires understanding the platform deeply. The Meta Agent eliminates this barrier:| User Type | Without Meta Agent | With Meta Agent |
|---|---|---|
| Business Users | Need to learn platform UI, create agents, configure environments | Ask questions in natural language, get results |
| Developers | Write API calls, configure MCP servers, manage agent lifecycles | Describe what they need, Meta Agent orchestrates |
| Data Engineers | Navigate context graph queries, manage datasets manually | Query infrastructure relationships conversationally |
| Platform Engineers | Manually coordinate agents, teams, and executions | Let Meta Agent route tasks to the right resources |
Architecture: MCP-Powered Orchestration
The Meta Agent connects to the Kubiya Control Plane through MCP, giving it access to all platform capabilities:
MCP Tools Available
The Meta Agent has access to all Kubiya MCP tools:| Category | Capabilities |
|---|---|
| Agents | List, create, update, delete, execute agents |
| Teams | Manage teams, assign agents, execute team workflows |
| Environments | Create and configure execution environments |
| Projects | Organize work by objective or domain |
| Executions | Monitor, stream, and control running tasks |
| Context Graph | Query infrastructure relationships and dependencies |
| Cognitive Memory | Store and recall organizational knowledge |
| Background Jobs | Schedule and manage recurring automation |
| Policies | View and understand OPA guardrails |
| Worker Queues | Monitor execution capacity |
Key Capabilities
1. Intelligent Task Routing
The Meta Agent understands your intent and routes requests to the appropriate resources:- Identifies the DevOps team/agent best suited for deployments
- Checks environment availability and worker capacity
- Creates and executes the task with proper context
- Streams results back to you
2. Context Graph Exploration
Query your infrastructure without writing Cypher:
- Scans graph nodes for relevant entities
- Traces relationships and dependencies
- Returns structured, actionable results
3. Cognitive Memory Access
Tap into organizational knowledge across all agents and teams:
4. Cross-Resource Coordination
Orchestrate complex operations spanning multiple platform resources:- Project creation with defined goals
- Team assignment with proper permissions
- Background job scheduling with recurring execution
Getting Started
Opening Meta Agent
Access the Meta Agent through:- Keyboard shortcut: Press
Cmd+J(Mac) orCtrl+J(Windows/Linux) - FAB button: Click the floating action button in the bottom-right corner
Personalizing Your Experience
On first use, select the categories most relevant to your role:- Security - CVEs, vulnerabilities, compliance monitoring
- Infrastructure - Kubernetes, databases, service health
- Cost Optimization - Cloud spend analysis, unused resources
- CI/CD - Pipelines, deployments, releases
- Memory & Insights - Historical patterns, organizational knowledge
- Tasks & Jobs - Execution planning, scheduled automation
Usage Patterns by Role
For Business Users
Ask questions without technical knowledge:For Developers
Interact with platform resources naturally:For Data Engineers
Explore infrastructure relationships:For Platform Engineers
Coordinate and manage platform resources:Real Examples
Listing Platform Agents
Ask the Meta Agent to show all available agents and their capabilities:
Checking Worker Queue Capacity
Query environment status and worker availability:
Understanding Responses
- Reasoning Process - Transparent display of how the request was interpreted
- Tool Calls - Visual indicators showing which MCP tools were invoked
- Visual/JSON Toggle - Switch between formatted and raw data views
- Structured Results - Organized output with clear sections
- Recommendations - Actionable next steps based on findings
- Follow-up Options - Suggested queries to explore further
AI-Powered Suggestions
- Security Alerts - Detected vulnerabilities requiring attention
- Health Issues - Unhealthy resources or degraded services
- Optimization Opportunities - Cost savings or performance improvements
- Stale Data Warnings - Datasets needing refresh
- Pattern Insights - Trends from cognitive memory analysis
- Context Graph for resource state and relationships
- Cognitive Memory for historical patterns and learnings
- Dataset status for data freshness
Session Controls
- Stop Button - Halt streaming responses or cancel long-running operations
- Clear Chat - Reset the conversation for a fresh start
- Expand/Collapse - Toggle panel size for focused work
- History - Access previous conversations and continue from where you left off
Best Practices
- Be Specific - Include context about what you’re looking for
- Leverage Natural Language - Write as you would explain to a colleague
- Follow Up - Ask clarifying questions based on responses
- Use Suggestions - Act on AI-powered insights for proactive management
- Review Tool Calls - Check which platform resources were accessed
- Trust the Orchestration - Let Meta Agent route to the right agents and teams
Relationship to Other Concepts
| Concept | Relationship to Meta Agent |
|---|---|
| Agents | Meta Agent can list, create, execute, and manage individual agents |
| Teams | Meta Agent coordinates team-based workflows and assignments |
| Context Graph | Meta Agent queries graph relationships through natural language |
| Cognitive Memory | Meta Agent stores/recalls organizational knowledge |
| Task Kanban | Meta Agent can create tasks that appear on the Kanban |
| Background Jobs | Meta Agent can schedule and manage recurring automation |
| MCP Server | Meta Agent is powered by the same MCP protocol and tools |
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Cmd/Ctrl + J | Open/close Meta Agent |
Enter | Send message |
Shift + Enter | New line in message |
Escape | Close Meta Agent panel |
Next Steps
- Agents - Learn about individual AI agents the Meta Agent orchestrates
- Teams - Understand team coordination and shared context
- Context Graph - Explore the knowledge layer Meta Agent queries
- Cognitive Memory - Understand organizational knowledge storage
- MCP Server - Learn about the protocol powering Meta Agent