Weave Code
Vizra Adk Laravel Package
vizra/vizra-adk
Vizra ADK is a Laravel AI Agent Development Kit for building autonomous agents with tools, sub-agents, workflows, and persistent memory. Supports multiple LLM providers, streaming responses, tracing, evaluation, and a Livewire dashboard.
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`. This publishes the config, migrations, and sets up Livewire for the dashboard. Ensure PHP 8.2+ and Laravel 11+ are installed first.
- Which LLM providers are supported out of the box?
- Vizra ADK supports OpenAI, Anthropic, and Google Gemini via Prism PHP. You can also integrate custom providers by implementing Prism’s adapter interface or extending Vizra’s tool system.
- Can I use Vizra ADK in a headless Laravel API without Livewire?
- Yes, but the Livewire dashboard won’t be available. The core agent logic, tools, and memory persistence work independently. Disable Livewire-related services in the config if needed.
- How do I create a tool for my agent to interact with a database?
- Implement the `ToolInterface` and bind it in a service provider. Use Laravel’s Eloquent or Query Builder directly in the tool’s `execute()` method. Tools can also wrap API calls or external services.
- Does Vizra ADK support agent memory persistence across sessions?
- Yes, agent memory is stored in the database via Eloquent models. You can configure retention policies (TTL) and prune stale data using Laravel’s scheduler or custom logic.
- How do I test agents locally before deploying to production?
- Use the Livewire dashboard for interactive testing or write PHPUnit tests with mock LLM responses. Vizra provides a `TestAgent` trait and `AgentEvaluator` for automated quality checks.
- What’s the best way to handle LLM API rate limits and cost spikes?
- Implement rate-limiting in your agent logic using Vizra’s `ToolChain` with `tap()` and `catch()`. Set token budgets per workflow and use fallback models (e.g., cheaper providers) for non-critical tasks.
- Can I deploy Vizra agents in a distributed or serverless environment?
- Agents can run in distributed setups, but persistent memory requires a shared database. For serverless, use Laravel Vapor or similar with database-backed sessions. State management may need custom logic for high-scale setups.
- How do I monitor agent performance and debug issues?
- Use Vizra’s built-in tracing system to log agent execution flows. The Livewire dashboard visualizes traces, and you can integrate Laravel Telescope for deeper debugging.
- Are there alternatives to Vizra ADK for Laravel AI agents?
- Alternatives include Laravel AI (basic agent support), LangChain PHP (more generic), or custom solutions with OpenAI’s API. Vizra ADK stands out for its Laravel-native workflows, persistent memory, and Livewire dashboard.
Weaver
How can I help you explore Laravel packages today?