Skip to main content
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

These commands help you scaffold new agents, tools, and testing components in seconds.
Create a new AI agent with a single command. This is where the magic begins.
Terminal
# 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
Give your agents superpowers. Tools let your agents interact with databases, APIs, and more.
Terminal
# 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
Group related tools together with shared configuration. Toolboxes provide a clean way to organize tools with common gates, policies, or middleware.
Terminal
# Create a new toolbox interactively
php artisan vizra:make:toolbox

# Create with specific options
php artisan vizra:make:toolbox --gate=admin --policy=App\\Policies\\ToolPolicy

# Create with pre-configured tools
php artisan vizra:make:toolbox --tools=SearchTool,DatabaseTool,ApiTool

# Creates: app/Toolboxes/YourToolbox.php
Options:
OptionDescription
--gateApply a Laravel gate to all tools in the toolbox
--policyApply a policy class for authorization
--toolsComma-separated list of tools to include
What you get:
  • A toolbox class extending BaseToolbox
  • Centralized configuration for related tools
  • Built-in support for gates and policies
  • Easy tool registration via the $tools property
Quality assurance for your AI. Create evaluations to ensure your agents perform consistently.
Terminal
# Create a new evaluation interactively
php artisan vizra:make:eval

# The command will prompt for the evaluation name
# Creates: app/Evaluations/YourEvaluation.php
Create custom assertions for your evaluations. Assertions define the criteria for pass/fail outcomes.
Terminal
# Create a new assertion interactively
php artisan vizra:make:assertion

# The command will prompt for the assertion name
# Creates: app/Assertions/YourAssertion.php
What you get:
  • An assertion class extending BaseAssertion
  • The evaluate() method ready for your custom logic
  • Access to the agent response and expected outcome
  • Integration with the evaluation framework

​
Agent Discovery Commands

Explore your AI workforce. These commands help you discover and manage your agents.
See all your available agents. This command shows you every agent in your application, whether registered or not.
Terminal
# 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/Agents directory
  • 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:
OptionDescription
--clear-cacheForce rediscovery by clearing the cache
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.
Have a conversation with your AI agent right in your terminal. Perfect for testing and development.
Terminal
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
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.
Put your agents through their paces. Run evaluations to measure performance and catch regressions.
Terminal
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:
OptionDescription
nameThe evaluation class name (e.g., MyTestEvaluation)
--outputPath 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

​
Prompt Management Commands

Master your AI’s voice. Manage prompt versions without touching code.
Your command center for prompt versioning. Create, list, activate, and manage different prompt versions for each agent.
Terminal
# Create a new prompt version
php artisan vizra:prompt create {agent} {version} [--content="..."]

# List all prompt versions
php artisan vizra:prompt list [agent]

# Activate a version (database only)
php artisan vizra:prompt activate {agent} {version}

# Export prompt to file
php artisan vizra:prompt export {agent} {version} [--file=output.txt]

# Import prompt from file
php artisan vizra:prompt import {agent} {version} --file=input.txt
Examples in action:
Terminal
# Create friendly customer support prompt
php artisan vizra:prompt create customer_support friendly \
    --content="You are a warm and friendly support agent. Use casual language."

# List all weather reporter prompts
php artisan vizra:prompt list weather_reporter

# Switch to professional version in production
php artisan vizra:prompt activate customer_support professional

# Share prompts between projects
php artisan vizra:prompt export my_agent v2 --file=awesome_prompt.txt
php artisan vizra:prompt import other_agent v1 --file=awesome_prompt.txt
Prompt versioning features:
  • File-based storage by default at resources/prompts/{agent}/{version}.txt
  • Optional database storage for production environments
  • Runtime version switching without code changes
  • Perfect for A/B testing and experimentation
  • Integration with evaluations for systematic testing

​
Debugging Commands

Become a debugging detective. These commands help you understand exactly what your agents are doing.
X-ray vision for your agents. See every step of execution in beautiful detail.
Terminal
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
Options:
OptionDescription
--trace-idZero in on a specific trace
--show-inputSee what went in
--show-outputSee what came out
--show-metadataView all the extra details
--errors-onlyFocus on problems
--formatChoose your view: tree, table, or json
Keep things tidy. Clean up old trace data to save space and maintain performance.
Terminal
# 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.
Feed your agent’s brain. Store documents, manuals, and knowledge for instant recall.
Terminal
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:
OptionDescription
--filePath to document or file
--contentDirect text to store
--namespaceOrganize your memories
--sourceTrack where it came from
--source-idVersion or ID tracking
--metadataExtra context as JSON
Monitor your memory usage. Get insights into how your vector storage is performing.
Terminal
# 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

​
MCP Commands

Manage Model Context Protocol servers. Connect your agents to external tool servers for extended capabilities.
List and test your configured MCP servers. See which external tool servers are available and their connection status.
Terminal
# List all configured MCP servers
php artisan vizra:mcp:servers

# Test connectivity to all servers
php artisan vizra:mcp:servers --test
Options:
OptionDescription
--testTest connectivity to each configured server
What you’ll see:
  • All configured MCP servers from your config
  • Server names, URLs, and transport types
  • Connection status when using --test
  • Available tools from each connected server

​
Setup Commands

Get started quickly. These commands help you set up and configure Vizra ADK.
One command to rule them all. Install everything you need to start building agents.
Terminal
php artisan vizra:install

# This command:
# - Publishes configuration files
# - Publishes database migrations
# - Shows post-installation information
Install Vizra ADK guidelines for Laravel Boost integration. This adds AI agent development context to your Boost configuration.
Terminal
# Install Boost integration
php artisan vizra:boost:install

# Force overwrite existing configuration
php artisan vizra:boost:install --force
Options:
OptionDescription
--forceOverwrite existing Boost guidelines
What it does:
  • Adds Vizra ADK context to your Laravel Boost setup
  • Provides AI coding assistants with agent development patterns
  • Includes tool and evaluation scaffolding guidance
Access your command center. Launch the web dashboard to test and monitor your agents.
Terminal
# Display dashboard URL
php artisan vizra:dashboard

# Open dashboard in browser
php artisan vizra:dashboard --open

​
Pro Tips

Development Flow

  • Use vizra:chat for 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

​
Next Steps

Quick Start Guide

Jump back to the basics and get started

Full API Reference

Explore all the APIs and capabilities