neuron-core/neuron-ai

Neuron AI – エージェント型 アプリケーションを構築するための PHP フレームワーク

概要

• Composer でインストール可能な PHP ライブラリで、PHP コードベース内で直接 AI エージェントを作成、オーケストレーション、実行できます。
• LLM プロバイダー、メモリ、ツールキット、RAG、構造化出力、マルチエージェントワークフロー、ヒューマン・イン・ザ・ループ処理のためのファーストクラスの抽象化を提供します。
• エージェントをアプリのコアアーキテクチャにしたい（後付けの機能ではなく）開発者を対象としています。

主要な概念とコンポーネント

コンポーネント	役割
Agent（NeuronAI\Agent\Agent を継承）	組み込みのメモリ、ストリーミング、ツール呼び出しを備えた対話型 AI の基底クラス。
RAG（NeuronAI\RAG\RAG を継承）	プロバイダー、埋め込みサービス、ベクトルストア（例：Pinecone）を組み合わせて検索拡張生成を実現。
ツール / ツールキット	関数呼び出しを介して LLM に具体的なアクション（例：MySQL クエリ）を公開する PHP オブジェクト。
MCP コネクタ	外部の モデルコンテキストプロトコル サーバーに接続し、ツールをリモートで提供できるようにします。
Workflow	プロバイダー、ローダー、ベクトルストアなどをカスタムエージェントフローに配線できる低レベルでコンポーネントベースのパイプライン。チェックポイントとヒューマン・イン・ザ・ループステップをサポート。
構造化出力	#[SchemaProperty] 属性で PHP クラスを装飾。エージェントは生のテキストではなく型付きオブジェクトを返します。

サポートされている LLM プロバイダー（単一の provider() メソッドでプラグアンドプレイ）：Anthropic、OpenAI（Azure および互換 API を含む）、Ollama、Gemini、Mistral、HuggingFace、Deepseek、Grok、AWS Bedrock、Cohere、ZAI、Alibaba DashScope、および汎用の Neuron Router。

典型的なワークフロー

1. インストール – composer require neuron-core/neuron-ai。
2. スキルの追加 – npx skills add ./vendor/neuron-core/neuron-ai/skills -y（シンボリックリンクで最新状態を維持）。
3. フレームワーク統合の選択 – 適切なスキル（neuron-laravel-integration または neuron-symfony-integration）を実行するか、プレーンな PHP スキルを使用します。
4. エージェントの作成 – vendor/bin/neuron make:agent MyAgent を実行し、provider()、instructions()、およびオプションで tools() を実装します。
5. 対話 – エージェントをインスタンス化し、スレッド ID を設定し、$agent->chat(new UserMessage('…')) を呼び出します。
6. 拡張 – ツールキット、RAG、構造化出力を追加するか、複雑な多段階プロセス用に完全な Workflow を構成します。

例 – データアナリストエージェント

class DataAnalystAgent extends Agent {
    protected function provider(): AIProviderInterface {
        return new Anthropic(key: 'ANTHROPIC_API_KEY', model: 'ANTHROPIC_MODEL');
    }
    protected function instructions(): SystemMessage {
        return new SystemMessage('You are a data analyst expert in creating reports from SQL databases.');
    }
    protected function tools(): array {
        return [MySQLToolkit::make(\DB::connection()->getPdo())
                ->only([MySQLSchemaTool::class, MySQLSelectTool::class])];
    }
}

$resp = DataAnalystAgent::make()->setThreadId('demo')
        ->chat(new UserMessage('How many orders did we receive today?'))
        ->getMessage();
echo $resp->getContent();

このエージェントは会話を記憶し、読み取り専用の SQL を安全に実行でき、1 行の変更で別の LLM プロバイダーに切り替えることができます。

エコシステムとコミュニティ

• エージェント型 PHP アプリ専用に構築された 拡張機能のレジストリ（スキル、統合、ツールキット）。
• 公式チャネル：ドキュメントサイト、ニュースレター、Inspector 監視サービス、電子書籍、ソーシャルメディア。
• 垂直 スタックとして設計：単一エージェントのデモを動かす同じ Workflow が、マルチエージェントの本番システムにもスケールします。

開発とテスト

• PHP ≥ 8.1 が必要です。
• テストスイートは Docker Compose で実行されます（docker compose up -d の後 vendor/bin/phpunit）。
• セキュリティ問題は support@inspector.dev に報告されます。

Neuron AI を検討すべき人

• AI エージェントをアーキテクチャの第一級市民にしたい PHP チーム（Laravel、Symfony、またはプレーンな PHP）。
• 内部ツール、データ分析ボット、または AI にメモリ、ツールアクセス、検索拡張生成が必要な製品を構築している企業。
• LLM プロバイダーの切り替え、カスタムツールの追加、複雑なワークフローのオーケストレーションを、異なるライブラリを継ぎ接ぎせずに統一された方法で行いたい開発者。

---

すべての詳細はリポジトリの README から直接取得されています。追加の機能は推測されていません。