Knowledge Command

This guide documents the knowledge command in the Kubiya CLI, which allows you to create, read, update, and delete knowledge items in your Kubiya knowledge base.

Overview

The knowledge command enables you to manage information that your AI teammates can access. With this command, you can create, view, update, and delete knowledge items, helping your AI teammates provide more accurate and context-aware assistance.

Available Commands

List Knowledge Items

View all knowledge items in your environment:

# List all knowledge items
kubiya knowledge list

# Use JSON output format
kubiya knowledge list --output json

Example output:

📚 KNOWLEDGE BASE
UUID                                  NAME                  DESCRIPTION           LABELS
abc123-456def-789ghi                  AWS Setup             AWS configuration     aws, cloud
jkl012-345mno-678pqr                  Git Workflow          Our Git process       git, workflow

Get Knowledge Content

Retrieve the content of a specific knowledge item:

# Get content by knowledge UUID
kubiya knowledge get abc123-456def-789ghi

# Use JSON output format
kubiya knowledge get abc123-456def-789ghi --output json

Example output:

📚 Knowledge Item: AWS Setup

Description: AWS configuration
Labels: aws, cloud

Content:
# AWS Setup Guide
1. Configure credentials
2. Set up IAM roles
3. Deploy infrastructure

Create Knowledge

Add a new knowledge item:

# Create knowledge with required metadata and content from a file
kubiya knowledge create --name "Redis Setup" --desc "How to setup Redis" --labels devops,redis --content-file redis.md

# Create knowledge with required name only
kubiya knowledge create --name "AWS Tips" --desc "AWS best practices" --labels aws,cloud

Update Knowledge

Modify an existing knowledge item:

# Update using default editor (recommended)
kubiya knowledge update abc123-456def-789ghi

# Update using specific editor flag
kubiya knowledge update abc123-456def-789ghi --editor

# Update content from a file without confirmation
kubiya knowledge update abc123-456def-789ghi --content-file new.md --yes

# Update metadata only
kubiya knowledge update abc123-456def-789ghi --name "Updated Name" --desc "New description"

Delete Knowledge

Remove a knowledge item:

# Delete a knowledge item by UUID
kubiya knowledge delete abc123-456def-789ghi

Edit Knowledge

Interactively edit a knowledge item's content:

# Open knowledge item in editor
kubiya knowledge edit abc123-456def-789ghi

Common Options

Knowledge commands support these parameters:

Command	Options
list	--output, -o: Output format (text, json)
get	--output, -o: Output format (text, json)
create	--name, -n: Knowledge item name (required) --desc, -d: Knowledge item description --labels, -l: Labels (comma-separated) --groups, -g: Groups (comma-separated) --content-file, -f: File containing the content
update	--name, -n: New name --desc, -d: New description --labels, -l: New labels (comma-separated) --groups, -g: New groups (comma-separated) --content-file, -f: File containing new content --editor, -e: Open content in editor --yes, -y: Skip confirmation prompt
delete	No additional options
edit	No additional options

Use Cases

Documentation Management

# Add documentation for team reference
kubiya knowledge create --name "Deployment Process" --desc "Our deployment workflow" --content-file ./docs/deployment.md

Knowledge Updates

# Update procedures after a process change
kubiya knowledge update abc123-456def-789ghi --content-file ./docs/updated-process.md

Collaborative Editing

# Open in editor for interactive updates
kubiya knowledge update abc123-456def-789ghi --editor

Troubleshooting

Common Issues and Solutions

1. Knowledge UUID Not Found

   • Verify the UUID is correct

   • Use kubiya knowledge list to see all valid UUIDs

2. Content Not Updating

   • Ensure the file path is correct

   • Check file permissions

   • Use the --editor flag to see changes in real-time

3. Editor Issues

   • Set your preferred editor with the $EDITOR environment variable

   • If no editor is set, the command defaults to vim

Related Commands

• kubiya chat - Interact with AI assistants that use knowledge

• kubiya integration - Set up integrations for knowledge sources

Conclusion

The knowledge command provides essential functionality for managing the information that powers your AI teammates. By maintaining accurate and up-to-date knowledge items, you ensure your AI teammates can provide helpful and contextually relevant assistance.