Vizra ADK Agent Creation

Creating Vizra ADK Agents

Vizra ADK agents are AI-powered Laravel classes that can reason, use tools, and maintain memory. All agents must extend BaseLlmAgent.

Agent Class Structure

Every agent MUST follow this structure:

<?php

namespace App\Agents;

use Vizra\VizraADK\Agents\BaseLlmAgent;

class {{ AgentName }}Agent extends BaseLlmAgent
{
    /**
     * Unique identifier for the agent (snake_case)
     */
    protected string $name = '{{ snake_case_name }}';

    /**
     * Brief description of what the agent does
     */
    protected string $description = '{{ description }}';

    /**
     * System prompt/instructions for the LLM
     */
    protected string $instructions = <<<'INSTRUCTIONS'
        You are a {{ role description }}.

        Your capabilities include:
        - {{ capability 1 }}
        - {{ capability 2 }}

        Guidelines:
        - {{ guideline 1 }}
        - {{ guideline 2 }}
        INSTRUCTIONS;

    /**
     * LLM model to use
     */
    protected string $model = 'gpt-4o';

    /**
     * Optional: Temperature setting (0.0 to 1.0)
     */
    protected ?float $temperature = null;

    /**
     * Optional: Maximum tokens for response
     */
    protected ?int $maxTokens = null;

    /**
     * Optional: Maximum steps for tool execution (default: 5)
     */
    protected int $maxSteps = 5;

    /**
     * Tools this agent can use
     */
    protected array $tools = [
        // ToolClass::class,
    ];
}

Key Rules

1. Naming Convention:

   • Class name MUST end with Agent
   • The $name property must be unique and in snake_case
   • Place agents in App\Agents namespace

2. Auto-Discovery:

   • Agents are automatically discovered - NO registration needed
   • Simply create the class and it's ready to use

3. Required Properties:

   • $name: Unique identifier
   • $description: Brief description
   • $instructions: System prompt for the LLM
   • $model: Which LLM model to use

Common Agent Patterns