neuron-test-engineer

Neuron AI Test Engineer

This skill helps you write comprehensive tests for Neuron AI applications using the built-in testing utilities in NeuronAI\Testing.

Testing Philosophy

Neuron AI provides fake implementations that:

• Never make real API calls - All AI provider calls are mocked
• Record all interactions - Inspect what was sent and when
• Provide fluent assertions - PHPUnit-style assertions for verification

Core Testing Utilities

1. FakeAIProvider

The primary tool for testing agents without real AI API calls.

use NeuronAI\Testing\FakeAIProvider;
use NeuronAI\Chat\Messages\AssistantMessage;
use NeuronAI\Chat\Messages\UserMessage;

// Create with predetermined responses
$provider = new FakeAIProvider(
    new AssistantMessage('Hello! How can I help you?'),
    new AssistantMessage('The answer is 42.')
);

// Or use static constructor
$provider = FakeAIProvider::make(
    new AssistantMessage('Response 1'),
    new AssistantMessage('Response 2')
);

Key Features:

• Responses are returned sequentially from queue
• Supports chat(), stream(), and structured() methods
• Records all requests for assertion

2. FakeVectorStore

For testing RAG systems without real vector databases.

use NeuronAI\Testing\FakeVectorStore;
use NeuronAI\RAG\Document;

// Pre-populate with search results
$vectorStore = new FakeVectorStore([
    new Document('France is a country in Europe. Its capital is Paris.'),
    new Document('Germany is a country in Europe. Its capital is Berlin.'),
]);

// Or create empty and set results later
$vectorStore = FakeVectorStore::make();
$vectorStore->setSearchResults([
    new Document('Relevant document content')
]);

3. FakeEmbeddingsProvider

For testing embeddings without real API calls.

use NeuronAI\Testing\FakeEmbeddingsProvider;

// Create with default dimensions (8)
$embeddings = new FakeEmbeddingsProvider();

// Or specify dimensions
$embeddings = new FakeEmbeddingsProvider(dimensions: 1536);

// Use static constructor
$embeddings = FakeEmbeddingsProvider::make();