A Convai MCP-je AI-ügynökökkel épít Unity-karaktereket
A Convai Unity MCP lehetővé teszi, hogy a fejlesztők Codex, Claude Code vagy Cursor segítségével, természetes nyelvű utasításokkal építsenek AI-karaktereket Unityben. Az ügynök kezeli többek között a karakter, a beszélgetés, a kezelőfelület és a Vision beállításait.
- A Convai Unity MCP Codex, Claude Code és Cursor használatával is működik.
- A Convai SDK húsz, AI-karakterekhez készült MCP-eszközt biztosít.
- Az ügynök beszélgetést, chatfelületet, objektumokat és Vision funkciót is beállíthat.
- A módosítások alapértelmezés szerint száraz futtatással és a Unity Undo rendszerével védettek.
- A használathoz Unity 6 és a Unity AI Assistant megfelelő verziója szükséges.
AI-karakterek kézi komponensbekötés helyett
A Convai augusztus 13-án ismertette Unity-integrációját, amely az AI-kódoló ügynököket közvetlenül összeköti a Convai eszközeivel. A fejlesztő leírhatja, milyen virtuális avatárt szeretne, az ügynök pedig módosítja a Unity-projektet. Ezután a fejlesztő ellenőrizheti a Hierarchy nézetet, majd elindíthatja a jelenetet.
A Convai bemutatója szerint egyetlen természetes nyelvű utasítás létrehozhat egy működő, kihangosított beszélgetést támogató AI-karaktert és egy chatfelületet. A későbbi váltás push-to-talk, vagyis gombnyomásra aktivált beszédmódra további utasítással végezhető el. Az ügynök objektumokat is elhelyezhet a környezetben, valamint bekapcsolhatja a kameraképen alapuló Vision funkciót, így a karakter leírhatja, mit lát.
A Convai szerint a bemutatóban az első karakter beállítása körülbelül öt percet, a push-to-talk módra váltás pedig további két percet vett igénybe. A cég ezt az iteráció gyorsításának példájaként mutatja be.
Húsz Convai-specifikus eszköz egészíti ki a Unity MCP-jét
A Model Context Protocol, röviden MCP, olyan nyílt szabvány, amelyen keresztül az AI-ügynökök eszközökkel és alkalmazásokkal kommunikálhatnak. A Unity saját MCP-szervere általános műveleteket támogat GameObjecteken, szkripteken, eszközökön és jeleneteken, a Convai integrációja pedig a társalgó AI-karakterekhez szükséges réteget adja hozzá.
A Convai Unity SDK húsz, Convai.* névterű eszközt regisztrál. Ezek a ConvaiManager, a ConvaiRoomManager, a ConvaiPlayer és a ConvaiCharacter komponenseit, továbbá a műveleteket, a szinkronizált szájmozgást, az átiratokat és a narratív szekciókat kezelik. A karakter nyelvi modellje, hangja, nyelve, személyisége és tudásbázisa továbbra is a Convai szolgáltatásán marad.
A rendszerhez egy csomagolt Convai-készség, a SKILL.md is tartozik. Ezt az ügynök a műveletek előtt olvassa be, hogy a megfelelő eszközt használja. A Convai közlése szerint a Unity és a Convai eszközei külön feladatköröket kapnak: előbbi az általános jelenetműveleteket, utóbbi az AI-karakterek konfigurációját kezeli.
Védelem a véletlen módosítások ellen
A Convai három fő korlátozást épített az integrációba. Az eszközök nem fogadnak el és nem adnak vissza API-kulcsokat. A Convai.GetProjectStatus megmutatja az SDK, a Unity és az Assistant verzióját, valamint azt, hogy be vannak-e állítva a hitelesítési adatok, magát a kulcsot azonban nem adja vissza.
A módosító műveletek a Unity Undo rendszerét használják, és a jelenetet nem mentik el automatikusan. A legtöbb ilyen művelet alapértelmezés szerint száraz futtatási módban, vagyis dryRun beállítással indul, így az ügynök előbb megmutathatja a tervezett változtatásokat. A módosítások visszavonhatók a Ctrl vagy Cmd és Z billentyűparanccsal.
A Convai eszközei csak Edit Mode-ban módosítanak. Ha egy ilyen művelet Play Mode közben indul, a rendszer a PLAY_MODE_ACTIVE hibakódot adja vissza, és nem konfigurálja félkészen az aktív jelenetet.
Mire van szükség a használatához?
A megoldáshoz Unity 6, vagyis 6000.x vagy újabb verzió, telepített Convai Unity SDK, valamint a com.unity.ai.assistant csomag 2.13.0-s vagy újabb, de 3.0.0-nál korábbi verziója kell. A 2.13.0-s kiadásnak legalább a pre.2 előzetes jelölést kell tartalmaznia, a 3.0.0 pedig csak előzetes kiadásként számít bele.
A Convai öt kódoló ügynököt támogat: Codex, Claude Code, Cursor, Gemini és VS Code Copilot. Emellett Convai-fiókra, a projektben beállított API-kulcsra és egy Convai-karakterre is szükség van.
A beállítás a Unity Editor Convai > AI Coding Setup menüpontjából indítható. A rendszer négy ellenőrzési sort mutat: Unity 6000+, Unity AI Assistant, Packaged Convai Skill és Convai MCP Tools. A sikeres konfigurációhoz mindegyiknek Ready állapotot kell mutatnia, a Convai eszközöknek pedig 20/20 regisztrált állapotban kell lenniük. A bemutató Codex esetében egy AGENTS.md fájlt telepít a projekt gyökerébe, a Convai utasításait pedig külön, határolt blokkban helyezi el.
A fejlesztők így a Unity Inspectorben végzett ismétlődő beállítások helyett egy kódoló ügynököt használhatnak az AI-karakterek konfigurálására és ellenőrzésére. A Convai Unity MCP Asset Store-ból is elérhető.
