Skip to content

CoreAiUnity

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

CoreAiUnity

README.md

🎮 CoreAI Unity — AI-агенты в твоей игре

Unity-слой CoreAI: DI, LLM, MessagePipe, Lua sandbox, тесты, Editor-меню.

Версия Зависит от Статус
См. package.json com.nexoider.coreai v0.16.0 ✅ Готово

🚀 Что внутри

Конструктор агентов (AgentBuilder)

Создай NPC за 3 строки:

var merchant = new AgentBuilder("Blacksmith")
    .WithSystemPrompt("You are a blacksmith. Sell weapons and remember purchases.")
    .WithTool(new InventoryLlmTool(myInventory))  // Знает ассортимент
    .WithMemory()                                  // Помнит покупателей
    .WithMode(AgentMode.ToolsAndChat)              // Инструменты + чат
    .Build();

Инструменты (Tools)

Инструмент Что делает Пример
🧠 MemoryTool Память между сессиями "Игрок купил меч"
📜 LuaTool Выполняет Lua код create_item("Sword")
🎒 InventoryTool Инвентарь NPC Список товаров
⚙️ GameConfigTool Конфиги игры Баланс, настройки
🎭 SceneLlmTool Иерархия/transform в PlayMode Поворот GameObject
📸 CameraLlmTool Base64 JPEG скриншоты для Vision Снимок с Camera.main

Tool Call Retry

AI получает 3 попытки исправить формат tool call:

AI: {"memory": "..."}  ← Неправильный формат
System: "ERROR: Use {"name": "memory", "arguments": {...}}"
AI: {"name": "memory", "arguments": {...}}  ← Исправлено ✅

📖 Документация

Документ Что внутри
🏗️ AGENT_BUILDER.md Конструктор агентов
🔧 TOOL_CALL_SPEC.md Tool calling спецификация
🛒 CHAT_TOOL_CALLING.md Merchant NPC
🧠 MemorySystem.md Память агентов
🗺️ DEVELOPER_GUIDE.md Карта кода
🤖 AI_AGENT_ROLES.md Роли и промпты
📋 CHANGELOG.md История изменений

📏 Рекомендуемые модели

Модель Размер Tool Calling
Qwen3.5-4B 4B ✅ Отлично — рекомендуется локально
Qwen3.5-35B (MoE) API 35B/3A ✅ Превосходно — идеально через API
Gemma 4 26B 26B ✅ Превосходно через LM Studio / HTTP API
Qwen3.5-2B 2B ⚠️ Работает, но иногда ошибается
Qwen3.5-0.8B 0.8B ⚠️ Большинство тестов проходит

🏆 4B проходит ВСЕ тесты. Рекомендуемый минимум для продакшена.

🧪 Тесты

Unity → Window → General → Test Runner
  ├── EditMode — 191 тест
  └── PlayMode — 12 тестов (с реальной LLM)

📦 Установка

https://github.com/NeoXider/CoreAI.git?path=Assets/CoreAiUnity

Сначала добавь com.nexoider.coreai, затем com.nexoider.coreaiunity.

🤝 Автор

Neoxider • NeoxiderTools

🎮 CoreAI Unity — AI-агенты, которые делают игру живой.