Weave Code
Vizra Adk Laravel Package
vizra/vizra-adk
Vizra ADK is an AI Agent Development Kit for Laravel to build autonomous agents with multi-model LLM support, tools, workflows, streaming, tracing, and a Livewire dashboard. Includes sub-agent delegation, persistent memory, and agent evaluation.
Build, test, and deploy intelligent AI agents the Laravel way
Frequently asked questions about Vizra Adk
- How do I install Vizra ADK in a Laravel 11 project?
- Run `composer require vizra/vizra-adk` and execute `php artisan vizra:install` to publish configurations and migrations. The package includes Artisan commands like `vizra:make:agent` to scaffold new agents quickly. Ensure your project meets the PHP 8.2+ and Laravel 11+ requirements.
- Which AI models does Vizra ADK support out of the box?
- The package integrates with OpenAI, Anthropic, and Google Gemini via Prism PHP, an abstraction layer for LLM providers. You can easily switch providers by configuring the `config/vizra.php` file. Prism supports additional models, so check its documentation for full compatibility.
- Can I use Vizra ADK with Laravel’s queue system for async agent execution?
- Yes, Vizra ADK supports queue-based execution for agents. Use the `Agent::dispatch()` method with a queue connection (e.g., `queue:default`) to offload agent processing. This is ideal for scaling workloads or handling long-running tasks without blocking the user experience.
- How do I create custom tools for my agents?
- Implement the `ToolInterface` and register your tool in the `Toolbox` via the `register()` method. Tools can interact with databases, APIs, or external services. The package provides a `ToolboxInterface` for organizing tools, and you can extend functionality using Laravel’s service container or macros.
- Does Vizra ADK support persistent memory for agents across sessions?
- Yes, the package includes persistent memory via Eloquent models (e.g., `AgentMemory`) and supports vector databases like Meilisearch for advanced retrieval. Configure memory storage in `config/vizra.php` and use the `AgentMemory` facade to manage agent recall. Note that this adds latency and storage costs.
- Is the Livewire dashboard compatible with Laravel 11 and Livewire v4?
- The dashboard is built for Livewire v4 and Laravel 11, leveraging modern features like Blade components and Alpine.js. If your project uses Livewire v3, you’ll need to upgrade or manually adapt the dashboard code. The package assumes Livewire is installed via `laravel/livewire`.
- How can I monitor and debug agent execution in production?
- Vizra ADK provides comprehensive tracing via the `AgentTrace` model, which logs every step of an agent’s execution. Use the Livewire dashboard to visualize traces or query the database directly. For advanced monitoring, integrate with Laravel’s logging system or third-party tools like Sentry.
- Are there alternatives to Vizra ADK for building AI agents in Laravel?
- Alternatives include Laravel-based packages like `spatie/laravel-ai` (for simpler LLM integrations) or standalone tools like LangChain.js (ported to PHP via custom wrappers). However, Vizra ADK stands out for its native Laravel integration, tooling ecosystem, and built-in evaluation framework for agent quality.
- How do I handle rate limits or cost management for LLM providers?
- Configure provider-specific rate limits in `config/vizra.php` under the `providers` section. Use Prism’s built-in retry logic or implement custom middleware to throttle requests. For cost management, monitor token usage via the `AgentTrace` model or integrate with provider-specific billing APIs.
- Can I use Vizra ADK in a Laravel project with PHP 8.1 or older?
- No, Vizra ADK requires PHP 8.2+ due to dependencies like Livewire v4 and Laravel 11’s features (e.g., enums, attributes). If you’re on PHP 8.1 or older, consider downgrading to an earlier version of the package (if available) or upgrading your PHP version to maintain compatibility.
Weaver
How can I help you explore Laravel packages today?