Management Commands
django-agents provides several Django management commands for working with agents.
list_agents
List all registered agents in the project.
Usage:
python manage.py list_agents [options]
Options:
--verbose: Show detailed information about each agent--app APP: Filter agents by app name--enabled-only: Show only enabled agents--format {table,json,list}: Output format (default: table)
Examples:
# List all agents
python manage.py list_agents
# List agents from specific app
python manage.py list_agents --app myapp
# List with detailed information
python manage.py list_agents --verbose
# Output as JSON
python manage.py list_agents --format json
run_agent
Execute a specific agent manually from the command line.
Usage:
python manage.py run_agent AGENT_NAME [options]
Options:
--context JSON: JSON string containing execution context--context-file FILE: Path to JSON file with execution context--app APP: App name where agent is located--async: Execute agent asynchronously (if supported)--output {json,pretty,minimal}: Output format (default: pretty)
Examples:
# Run agent with context
python manage.py run_agent email_notification --context '{"recipient": "user@example.com"}'
# Run with context from file
python manage.py run_agent data_processor --context-file context.json
# Run asynchronously
python manage.py run_agent report_generator --async
create_agent
Create a new agent in an existing Django app.
Usage:
python manage.py create_agent AGENT_NAME APP_NAME [options]
Options:
--template {base,async,workflow,api,data}: Agent template type (default: base)--no-tests: Skip test file generation--description DESC: Agent description--overwrite: Overwrite existing agent if it exists
Examples:
# Create basic agent
python manage.py create_agent EmailNotification myapp
# Create async agent
python manage.py create_agent ReportGenerator myapp --template async
# Create with description
python manage.py create_agent DataProcessor myapp --description "Processes CSV data"
# Create without tests
python manage.py create_agent QuickAgent myapp --no-tests
agent_stats
Display execution statistics for all registered agents.
Usage:
python manage.py agent_stats [options]
Options:
--agent AGENT: Show stats for specific agent only--app APP: Filter agents by app name--format {table,json,detailed}: Output format (default: table)--sort-by {name,executions,last_run,app}: Sort agents by field (default: name)
Examples:
# Show all agent statistics
python manage.py agent_stats
# Show stats for specific agent
python manage.py agent_stats --agent email_notification
# Show detailed stats
python manage.py agent_stats --format detailed
# Sort by execution count
python manage.py agent_stats --sort-by executions
check_agents_health
Perform health checks on all registered agents.
Usage:
python manage.py check_agents_health [options]
Options:
--app APP: Check agents in specific app only--verbose: Show detailed health check information--test-execution: Test agent execution with empty context (may be slow)
Examples:
# Run health checks
python manage.py check_agents_health
# Check specific app
python manage.py check_agents_health --app myapp
# Verbose output with execution tests
python manage.py check_agents_health --verbose --test-execution
generate_context
Generate context files for AI coding assistants.
Usage:
python manage.py generate_context [options]
Options:
--output FILE: Output file name (default: agent-context.json)--format {json,yaml}: Output format (default: json)--include-stats: Include agent execution statistics
Examples:
# Generate context file
python manage.py generate_context
# Generate as YAML
python manage.py generate_context --format yaml --output agent-context.yaml
# Include statistics
python manage.py generate_context --include-stats
agent-audit
Run comprehensive project audit.
Usage:
python manage.py agent-audit [options]
Run audits on codebase, tests, settings, and deployment configuration.
startproject
Create a new Django project with django-agents pre-configured.
Usage:
python manage.py startproject PROJECT_NAME [directory]
Creates a new Django project with django-agents already set up.
startapp
Create a new Django app with agent scaffolding.
Usage:
python manage.py startapp APP_NAME [directory]
Creates a new Django app with agents.py file pre-configured.