Vizra.ai |

Documentation

โœจ

Welcome to Vizra ADK

The Laravel-native framework for building production-ready AI agents that actually work! ๐Ÿš€ No more toy demos โ€“ build intelligent systems that solve real problems and make your users amazed!

๐ŸŽฏ What is Vizra ADK?

Vizra ADK (Agent Development Kit) is a comprehensive Laravel package that makes building AI agents as easy as creating a controller. We've taken all the hard parts of AI development โ€“ managing conversations, handling tools, storing memories, debugging failures โ€“ and wrapped them in familiar Laravel patterns you already love! ๐Ÿ’œ

๐Ÿ’ก Think of it this way...

If Laravel made web development delightful, Vizra ADK does the same for AI agents. We handle the complex stuff so you can focus on building amazing AI-powered features!

๐ŸŒŸ Why Developers Love Vizra ADK

๐Ÿ—๏ธ Laravel Native

Artisan commands, service providers, facades โ€“ everything you expect from a Laravel package

๐Ÿ”Œ Multi-LLM Support

Works with OpenAI, Anthropic Claude, and Google Gemini out of the box

๐Ÿงช Built-in Testing

LLM-as-a-Judge evaluation system for quality assurance at scale

๐Ÿ” Debug Everything

Comprehensive tracing shows exactly what your agents are thinking

๐Ÿ’พ Smart Memory

Vector memory with RAG for agents that actually remember

โšก Production Ready

Streaming, async processing, and queue support built-in

๐ŸŽจ Core Concepts That Power Everything

Vizra ADK is built on six fundamental concepts that work together seamlessly. Master these, and you'll be building incredible AI agents in no time!

๐Ÿค–
Agents - Your AI Teammates

The stars of the show! Agents are intelligent systems that can chat, analyze data, trigger workflows, and work together. They're like smart controllers that understand natural language.

class CustomerSupportAgent extends BaseLlmAgent
{
    protected string $name = 'customer_support';
    protected string $instructions = 'You are a helpful assistant...';
}

๐Ÿ› ๏ธ
Tools - Agent Superpowers

Tools let agents interact with the real world โ€“ query databases, call APIs, send emails, or anything else your Laravel app can do. Think of them as specialized methods agents can call.

Example tools: DatabaseQueryTool, EmailSenderTool, WeatherAPITool, PDFGeneratorTool

๐Ÿง 
Memory & Sessions - Never Forget

Agents remember conversations, learn from interactions, and build knowledge over time. Sessions track conversations while memory stores long-term knowledge and user preferences.

Features: Conversation history, Vector search, User preferences, Persistent facts

๐ŸŽฏ
Execution Modes - Beyond Chat

Agents aren't just chatbots! Use different modes for different tasks: ask() for conversations, trigger() for events, analyze() for data, and more.

Six modes: ask, trigger, analyze, process, monitor, generate

๐Ÿงช
Evaluations - Quality at Scale

Test your agents like you test your code! Our LLM-as-a-Judge system automatically evaluates agent responses for quality, accuracy, and helpfulness.

Testing tools: CSV test data, Automated scoring, Quality metrics, Regression testing

๐Ÿ”
Tracing - X-Ray Vision

See exactly what your agents are thinking! Our tracing system records every decision, tool call, and response, making debugging a breeze.

Debug features: Execution timeline, Token usage, Performance metrics, Error tracking

๐Ÿš€ Getting Started is a Breeze

We've made it incredibly easy to get up and running. Here's how simple it is to create your first agent:

1. Install the package:

composer require vizra/vizra-adk

2. Create your first agent:

php artisan vizra:make:agent CustomerSupportAgent

3. Chat with your agent:

php artisan vizra:chat customer_support

That's it! You now have a working AI agent in your Laravel app. ๐ŸŽ‰

๐Ÿ’ก What Makes Vizra ADK Special?

๐ŸŽฏ Built for Real Production Use

This isn't a toy or a demo framework. We've built Vizra ADK to handle real production workloads with streaming responses, queue processing, proper error handling, and comprehensive monitoring. Your agents can handle thousands of conversations while maintaining quality.

๐Ÿงฉ Seamless Laravel Integration

We don't fight Laravel โ€“ we embrace it! Use facades, service providers, middleware, jobs, events, and everything else you love about Laravel. Your AI agents feel like a natural extension of your application, not a bolted-on afterthought.

๐Ÿ”ฌ Developer Experience First

From our intuitive Artisan commands to our comprehensive debugging tools, everything is designed to make your life easier. See exactly what your agents are thinking with our tracing system, test them with our evaluation framework, and deploy with confidence.

๐Ÿ“š Your Learning Journey

Ready to dive deeper? Here's your roadmap to becoming a Vizra ADK expert:

๐ŸŽ“ Start Here

  • โ†’ Agents - Build your first AI teammate
  • โ†’ Tools - Give agents superpowers
  • โ†’ Execution Modes - Beyond simple chat

๐Ÿš€ Level Up