--- name: "Vizra ADK Agent Creation" description: "Create AI agents with Vizra ADK - includes patterns for customer service, data analysis, and content generation agents" --- # 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 go(); // With user context (maintains memory) $response = MyAgent::run('Remember my name is John') ->forUser($user) ->go(); // With session persistence $response = MyAgent::run('What did we discuss earlier?') ->forUser($user) ->withSession($sessionId) ->go(); ``` ### Advanced Execution Options ```php // Pass parameters to the agent $response = MyAgent::run($message) ->withParameters([ 'context' => 'customer_support', 'priority' => 'high', 'metadata' => ['ticket_id' => 12345] ]) ->go(); // Enable streaming $stream = MyAgent::run($message) ->forUser($user) ->streaming(true) ->go(); foreach ($stream as $chunk) { echo $chunk; } ``` ## Sub-Agent Delegation Agents can delegate to other agents using the `DelegateToSubAgentTool`: ```php use Vizra\VizraADK\Tools\DelegateToSubAgentTool; class ManagerAgent extends BaseLlmAgent { protected string $name = 'manager'; protected string $description = 'Coordinates tasks between specialized agents'; protected string $instructions = <<<'INSTRUCTIONS' You are a task coordinator. Delegate specialized tasks to appropriate agents: - Use 'research' agent for information gathering - Use 'writer' agent for content creation - Use 'analyzer' agent for data analysis INSTRUCTIONS; protected string $model = 'gpt-4o'; protected array $tools = [ DelegateToSubAgentTool::class, ]; } ``` ## Model Selection Guide Choose the appropriate model based on your needs: - **GPT-4o**: Best for complex reasoning, tool use, and general tasks - **GPT-4o-mini**: Cost-effective for simpler tasks - **Claude-3-Opus**: Excellent for creative writing and analysis - **Claude-3-Sonnet**: Balanced performance and cost - **Gemini-Pro**: Good for multi-modal tasks - **Gemini-Flash**: Fast responses for simple queries ## Testing Your Agent ```php use Tests\TestCase; use App\Agents\MyAgent; class MyAgentTest extends TestCase { public function test_agent_responds_correctly() { $response = MyAgent::run('test message')->go(); $this->assertNotEmpty($response); $this->assertIsString($response); } } ``` ## Common Mistakes to Avoid 1. **Don't forget to extend BaseLlmAgent** - Your agent won't work without it 2. **Don't use duplicate agent names** - Each $name must be unique 3. **Don't hardcode sensitive data** - Use environment variables 4. **Don't make instructions too vague** - Be specific about the agent's role 5. **Don't forget to include required tools** - Agents need tools to interact with systems ## Artisan Commands ```bash # Create new agent php artisan vizra:make:agent MyAgent # List discovered agents php artisan vizra:agents # Test agent interactively php artisan vizra:chat my_agent ```

Vizra ADK Agent Creation

Scan your own AI components