anwar / gunma-ai-agent
AI Agent orchestrator for Gunma Halal Food — OpenAI tool calling, Qdrant vector search, Ollama embeddings
0.1.1
2026-04-22 06:50 UTC
Requires
- php: ^8.1
- guzzlehttp/guzzle: ^7.0
- illuminate/database: ^10.0|^11.0
- illuminate/http: ^10.0|^11.0
- illuminate/routing: ^10.0|^11.0
- illuminate/support: ^10.0|^11.0
README
Modern, tool-calling AI agent backend for Gunma Halal Food. Orchestrates OpenAI, Qdrant, and real-time support channels.
Core Features
- Piku Orchestrator: Humanoid AI agent with tool-calling capabilities.
- Omnichannel Support: Seamlessly handles Web Chat, Email (IMAP/Webhook), and Support Tickets.
- Smart Order Logic: Intelligent order status reasoning and cancellation prevention for shipped items.
- Vector Search (Qdrant): High-speed semantic search for products and knowledge base.
- Support Tickets: Dedicated
support_ticketstable for formal complaints and claims. - Vision Support: Analyzes customer-uploaded photos for damage claims.
Installation
composer require anwar/gunma-ai-agent
Setup
- Publish migrations and config:
php artisan vendor:publish --provider="Anwar\GunmaAgent\GunmaAgentServiceProvider"
- Run migrations:
php artisan migrate
Architecture
- ToolExecutor: The brain that connects AI to your Laravel database and services.
- AgentOrchestrator: Manages the message loop, context window, and streaming.
- EmailWebhookController: Handles incoming support emails.
License
MIT © Anwar