Introduction

AI Agentic Framework with built-in observability for PHP

Neuron AI is a framework for integrating AI Agents into your existing PHP applications.

It simplify every stage of the AI application development life cycle:

• Development: You can build AI driven features into your application thanks to the Neuron core components or third party extensions.

• Integration: Neuron is framework agnostic so you are free to create LLM interactions as stand alone applications, or integrate them as part of an existing architecture.

• Observability: Turn your Neuron agents into production-ready applications, monitoring their performance and accuracy with built-in observability and AI Bug Fix provided by Inspector.dev

Neuron AI architecture

Neuron uses a standard interface for large language models (AIProviderInterface) that can be easily implemented to support more LLMs, as well as for the other components, such as embedding, vector stores, and data loaders.

Anthropic

use NeuronAI\Agent;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Anthropic\Anthropic;

class MyAgent extends Agent
{
    public function provider(): AIProviderInterface
    {
        return new Anthropic(
            key: 'ANTHROPIC_API_KEY',
            model: 'ANTHROPIC_MODEL',
        );
    }
}

echo MyAgent::make()->chat('Hi!');
// Hi, how can I help you today?

OpenAI

use NeuronAI\Agent;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\OpenAI\OpenAI;

class MyAgent extends Agent
{
    public function provider(): AIProviderInterface
    {
        return new OpenAI(
            key: 'OPENAI_API_KEY',
            model: 'OPENAI_MODEL',
        );
    }
}

echo MyAgent::make()->chat('Hi!');
// Hi, how can I help you today?

Mistral

use NeuronAI\Agent;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Mistral;

class MyAgent extends Agent
{
    public function provider(): AIProviderInterface
    {
        return new Mistral(
            key: 'MISTRAL_API_KEY',
            model: 'MISTRAL_MODEL',
        );
    }
}

echo MyAgent::make()->chat('Hi!');
// Hi, how can I help you today?

With Neuron you will have a standard toolkit to implement AI driven applications drastically reducing vendor lock-in. You can switch between LLMs, vector stores, embedding providers, etc. with just a few lines of code without the need to refactor big portions of your application.

Before you start writing code, we recommend reading the "Key Concepts" section to be aware of the fundamentals of the project.

What is an AI Agent

AI agents are essentially programs that can perform tasks in response to a prompt.

The key difference between AI assistants (that primarily provide information and respond to questions within a conversation) and AI agents, is that agents can take independent actions to complete tasks.

While a simple LLM can answer your questions directly during a conversation, an AI agent might be able to:

• Research information across multiple websites and compile it for you

• Manage your email by responding to simple messages

• Monitor data and alert you via email when something important happens

Why create your AI Agent

Because you can connect your specific application context and services to handle repetitive or complex processes that would otherwise require significant user effort or technical knowledge.

At Inspector we have created the "AI Bug Fix". It's an agent that automatically provides you with a bug fix proposal in real-time as an error occur, and it's obviously built with Neuron.

It incorporates several tools and prompts, it analyzes your application data and errors, connects with your repository, etc. to achieve a very accurate result.

This is just an example, and it depends by the domain of your applications.

Ecosystem

Inspector.dev

Trace and evaluate your agents execution flow to help you move from prototype to production with confidence. Check out the observability integrations.

Core components

• AI Provider

• Embeddings Provider

• Data Loader

• Vector Store

Additional Resources

• Repository: https://github.com/inspector-apm/neuron-ai

• Inspector: https://inspector.dev