Artisan Commands
Your CLI toolkit for building amazing AI agents! Master these commands to create, debug, and deploy intelligent agents with ease.
Power at Your Fingertips!
Vizra's Artisan commands are your Swiss Army knife for AI agent development. From creating new agents to debugging complex interactions, everything is just a command away!
🛠️ Agent Development Commands
Let's start building! These commands help you scaffold new agents and tools in seconds.
🤖 vizra:make:agent
Create a new AI agent with a single command! This is where the magic begins.
# Create a new agent interactively
php artisan vizra:make:agent
# The command will prompt for the agent name
# Creates: app/Agents/YourAgent.php✨ What you get:
- ✓ Name, description, and instructions properties ready to customize
- ✓ Model configuration (defaults to the blazing-fast gemini-2.0-flash)
- ✓ Temperature and max tokens settings pre-configured
- ✓ Empty tools array ready for your custom capabilities
🔧 vizra:make:tool
Give your agents superpowers! Tools let your agents interact with databases, APIs, and more.
# Create a new tool interactively
php artisan vizra:make:tool
# The command will prompt for the tool name
# Creates: app/Tools/YourTool.php⚡ Smart features:
- → Tool names are automatically snake_cased for consistency
- → "_tool" suffix is intelligently removed from the name
- → Implements ToolInterface with definition() and execute() methods
- → Includes JSON schema parameter definition for type safety
📊 vizra:make:eval
Quality assurance for your AI! Create evaluations to ensure your agents perform consistently.
# Create a new evaluation interactively
php artisan vizra:make:eval
# The command will prompt for the evaluation name
# Creates: app/Evaluations/YourEvaluation.php🔍 Agent Discovery Commands
Explore your AI workforce! These commands help you discover and manage your agents.
🔍 vizra:discover-agents
See all your available agents! This command shows you every agent in your application, whether registered or not.
# Discover all agents
php artisan vizra:discover-agents
# Clear discovery cache and rediscover
php artisan vizra:discover-agents --clear-cache✨ What you'll see:
-
✓
Complete list of all agents in your
app/Agentsdirectory - ✓ Agent names, class names, and registration status
- ✓ Automatic discovery of new agents without manual registration
- ✓ Clear indication of which agents are already registered vs available
🎛️ Options:
-
→
--clear-cache- Force rediscovery by clearing the cache
💡 Auto-Discovery Note:
Vizra ADK automatically discovers and registers agents when you use them. You don't need to manually register agents in your AppServiceProvider anymore! Just create an agent and start using it.
💬 Agent Interaction Commands
Time to talk! These commands let you interact with your agents directly from the terminal.
🗣️ vizra:chat
Have a conversation with your AI agent right in your terminal! Perfect for testing and development.
php artisan vizra:chat {agent_name}
# Example: Chat with the weather reporter agent
php artisan vizra:chat weather_reporter
# Type "exit" or "quit" to end the chat🌟 Cool features:
- • Interactive terminal-based chat interface for instant feedback
- • Unique session ID for each chat to track conversations
- • Handles string, array, and object responses gracefully
- • Comprehensive error handling so nothing breaks
🧪 Evaluation Commands
Test your agents like a pro! Run comprehensive evaluations to ensure quality at scale.
🎯 vizra:run:eval
Put your agents through their paces! Run evaluations to measure performance and catch regressions.
php artisan vizra:run:eval {name} [--output=results.csv]
# Example: Run CustomerServiceEvaluation
php artisan vizra:run:eval CustomerServiceEvaluation
# Save results to CSV file
php artisan vizra:run:eval CustomerServiceEvaluation --output=results.csv🎛️ Options:
-
→
name- The evaluation class name (e.g., MyTestEvaluation) -
→
--output- Path to save CSV results for analysis
📈 What you'll see:
- ✓ Real-time progress bar during evaluation
- ✓ Summary statistics with pass/fail counts
- ✓ Detailed results with assertion breakdowns
- ✓ CSV export with all test data for deeper analysis
🔍 Debugging Commands
Become a debugging detective! These commands help you understand exactly what your agents are doing.
🕵️ vizra:trace
X-ray vision for your agents! See every step of execution in beautiful detail.
php artisan vizra:trace {session_id} [options]
# View trace in tree format (default)
php artisan vizra:trace abc123
# View specific trace ID
php artisan vizra:trace abc123 --trace-id=xyz789
# Show detailed span data
php artisan vizra:trace abc123 --show-input --show-output --show-metadata
# Show only errors
php artisan vizra:trace abc123 --errors-only
# Different output formats
php artisan vizra:trace abc123 --format=table
php artisan vizra:trace abc123 --format=json🎛️ Powerful options:
-
→
--trace-id- Zero in on a specific trace -
→
--show-input- See what went in -
→
--show-output- See what came out -
→
--show-metadata- View all the extra details -
→
--errors-only- Focus on problems -
→
--format- Choose your view: tree, table, or json
🧹 vizra:trace:cleanup
Keep things tidy! Clean up old trace data to save space and maintain performance.
# Clean up traces older than config value (default: 30 days)
php artisan vizra:trace:cleanup
# Clean up traces older than 7 days
php artisan vizra:trace:cleanup --days=7
# Preview what would be deleted
php artisan vizra:trace:cleanup --dry-run
# Skip confirmation prompt
php artisan vizra:trace:cleanup --force🧠 Vector Memory Commands
Give your agents perfect memory! Store and search through knowledge using advanced vector embeddings.
💾 vector:store
Feed your agent's brain! Store documents, manuals, and knowledge for instant recall.
php artisan vector:store {agent} [options]
# Store content from a file
php artisan vector:store customer_support --file=docs.txt
# Store direct content
php artisan vector:store customer_support --content="Important product information"
# With metadata
php artisan vector:store customer_support \
--file=manual.pdf \
--namespace=products \
--source=manual \
--source-id=v2.0 \
--metadata='{"category":"electronics","version":"2.0"}'🎛️ Storage options:
-
→
--file- Path to document or file -
→
--content- Direct text to store -
→
--namespace- Organize your memories -
→
--source- Track where it came from -
→
--source-id- Version or ID tracking -
→
--metadata- Extra context as JSON
🔎 vector:search
Find anything instantly! Search through your agent's knowledge with semantic understanding.
php artisan vector:search {agent} {query} [options]
# Basic search
php artisan vector:search customer_support "refund policy"
# Search with custom parameters
php artisan vector:search customer_support "shipping rates" \
--limit=10 \
--threshold=0.8 \
--namespace=policies
# Generate RAG context
php artisan vector:search customer_support "product warranty" --rag
# JSON output
php artisan vector:search customer_support "user manual" --json🎛️ Search options:
-
→
--namespace- Search specific memory spaces -
→
--limit- How many results to return -
→
--threshold- Similarity score (0.0-1.0) -
→
--rag- Get formatted context for agents -
→
--json- Machine-readable output
📊 vector:stats
Monitor your memory usage! Get insights into how your vector storage is performing.
# Global statistics
php artisan vector:stats
# Agent-specific statistics
php artisan vector:stats customer_support
# Detailed statistics
php artisan vector:stats --detailed
# Specific namespace
php artisan vector:stats customer_support --namespace=products
# JSON output
php artisan vector:stats --json🏯 Setup Commands
Get started quickly! These commands help you set up and configure Vizra ADK.
📦 vizra:install
One command to rule them all! Install everything you need to start building agents.
php artisan vizra:install
# This command:
# - Publishes configuration files
# - Publishes database migrations
# - Shows post-installation information🌐 vizra:dashboard
Access your command center! Launch the web dashboard to test and monitor your agents.
# Display dashboard URL
php artisan vizra:dashboard
# Open dashboard in browser
php artisan vizra:dashboard --open💡 Pro Tips for Command Line Warriors
🎯 Development Flow
-
•
Use
vizra:chatfor rapid testing - • Create agents and tools with make commands
- • Debug with traces when things get complex
🚀 Production Excellence
- • Run evaluations before deploying
- • Clean up traces to save storage
- • Monitor vector memory performance
🚀 Ready to Build Something Amazing?
You now have all the command-line tools at your disposal. Start creating intelligent agents that can solve real problems!