Útmutató a Plugin / AI Agent fejlesztőknek, akik egyedi eszközöket szeretnének illeszteni a Privát AI - Agent Orchestration / GraphRAG Platformhoz. A dokumentáció végigvezet az első egyszerű tool-tól a komplex orchestrátoros megoldásokig.
Mi a platform, mit lehet rá fejleszteni, hogyan illeszkedik a plugin a rendszerbe.
Maven konfiguráció, platform-bom, plugin.jar felépítése, ServiceLoader regisztráció.
Egyszerű tool lépésről lépésre: implementáció, regisztráció, deploy, tesztelés.
IChatbotTool, IOrchestratorActivatedTool, IClarifiableTool, IIngestionTool – döntési útmutató.
AbstractOrchestratorTool, prototype scope, sub-query kezelés, retrieval profil.
Feladat-szétbontás, rész-lépés-fa, tool-ok együttműködésének csatornái - kontextus-megosztás, garantált függőség, közvetlen hívás.
IClarifiableTool, ClarificationSession, applyAnswer, detectNextQuestion – lépésről lépésre.
ILlmAssistant injektálása, strukturált JSON válasz, hibakezelés.
CONTEXT, ANSWER, ANSWERED, NEEDS_CLARIFICATION – mikor melyiket és mi történik utána.
IIngestionTool, tudásgráf feltöltés, KnowledgeGraphService, mikor érdemes implementálni.
Teljes lifecycle: build, könyvtárstruktúra, class loading, tranzitív függőségek.
IAsyncTaskTool, AsyncTaskProgressReporter, AbstractGraphEnrichmentTask – külső hívó által indítható, hosszú futású feladatok.
Backend integrátoroknak szóló REST végpontok – AI feladat futtatás és az aszinkron feladatok indítása/lekérdezése.
AbstractMcpTool, McpServerDescriptor, IMcpSession – külső rendszerek adatai MCP szerveren át, visszakérdezéssel, megerősítéssel és kiszivárgás-ellenőrzéssel.
BaseLLMTransformer, SummaryToolTransformer, BatchedSummaryTransformer – párhuzamos feldolgozás ingestion-ban és azon túl.
IPluginConfigurer, AbstractPluginJpaConfigurer, Spring @Transactional minta saját JPA persistence unit-hoz.
Saját tudásgráf-ingestion nem platform-feldolgozott, nem szöveges forrásadatból – upsertConcept, upsertRelation, saveMention.
Melyik tool-mintát melyik esetre – lookup, orchestrátor-lánc, interaktív tool, NER utófeldolgozás, önmagát streamelő tool, gráfbejárás.
Az SDK összes publikus interfésze, osztálya és bean-je annotált leírással.
@SdkApi(strip=true) annotációval jelölt osztályokban találhatók és csak stub formában
érhetők el az SDK JAR-ban.