neuron-core/neuron-ai

Neuron AI – 에이전트형 애플리케이션 구축을 위한 PHP 프레임워크

정의

• PHP 코드베이스 내에서 직접 AI 에이전트를 생성, 오케스트레이션, 실행할 수 있는 Composer 설치 가능한 PHP 라이브러리입니다.
• 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을 안전하게 실행할 수 있으며, 한 줄 변경으로 다른 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에서 직접 가져왔습니다. 추가 기능은 추론되지 않았습니다.