SamurAI 1.0 • Agentic AI • Java 17+ • Zero dependențe

Agenți AI în Java pentru automatizarea proceselor

SamurAI automatizează procesele de business cu agenți AI — de la trierea tichetelor la procesarea documentelor și aprobări. Fluxurile rulează în Java simplu, fără dependențe, comunică cu 31 de tipuri de furnizori LLM, preferă modelele gratuite și țin evidența fiecărui token cheltuit.

▶ Încearcă simularea Primii pași GitHub

AUTOMATIZARE BUSINESS

Pune munca repetitivă pe pilot automat

Automatizarea proceselor de business cu AI (AIBPA): agenții AI iau deciziile de interpretare, pașii deterministici fac restul, iar oamenii aprobă ce contează. Vrei ca AI-ul să scrie și fluxul? Vezi AIBPA2.

🎫

Trierea tichetelor și emailurilor

Clasifică cererile primite, extrage datele cheie, stabilește prioritatea și trimite fiecare cerere echipei potrivite.

📄

Procesarea documentelor

Citește facturi, contracte și formulare, extrage câmpurile necesare și le validează după regulile tale.

✅

Fluxuri de aprobare

Trimite rambursări, achiziții sau excepții unei persoane, așteaptă decizia, apoi continuă automat.

📊

Rapoarte programate

Colectează periodic date din API-uri și baze de date și le transformă în rezumate și alerte ușor de citit.

🔗

Integrarea sistemelor

Mută și reconciliază date între CRM-uri, ERP-uri și unelte interne, prin apeluri HTTP și funcții Java.

🚨

Monitorizarea operațiunilor

Verifică servere și servicii, diagnostichează incidente și redactează raportul — vezi mai jos demo-ul de triere.

FUNCȚIONALITĂȚI

Tot ce îi trebuie unui sistem de agenți

Fără dependență de un furnizor, fără facturi de tokeni scăpate de sub control, fără arbore de dependențe de auditat.

🌐

31 de tipuri de furnizori LLM

OpenAI, Claude, Gemini și Vertex AI, DeepSeek, Groq, Bedrock, Azure, Mistral, xAI, modele locale prin Ollama / LM Studio / vLLM / llama.cpp, plus abonamentele Claude Code și Gemini CLI.

💰

Rutare OPTIMAL după cost

Întâi modelele gratuite și cele locale, urmărirea cotelor, rutare după scop și escaladare în cascadă la modele plătite doar când e nevoie. Circuit breaker inclus.

⚙️

Agenți blind (0 $)

CommandAgent, HttpAgent, FunctionAgent și WaitAgent rulează pași deterministici fără să apeleze un LLM.

📜

Fluxuri XML

Declari agenți, rutere, ramuri paralele, programări și aprobări în samurai.xml, validat cu o schemă XSD. Fără compilare.

✋

Omul în buclă

Porțile de aprobare opresc fluxul până când o persoană aprobă sau respinge — din Studio, din interfața web sau printr-un apel REST.

🔌

Studio și server MCP

Studio desktop și web, cu actualizări live prin SSE; orice flux poate deveni unealtă Model Context Protocol (MCP) pentru Claude Code, Cursor sau Antigravity.

DEMO-URI INTERACTIVE

Urmărește un flux cum rulează, citește-i sursa

Două aplicații SamurAI reale, rulate în simulare, lângă codul Java sau XML care le definește. Demo-urile și codul sunt în engleză. Un exemplu real, în română, găsești pe pagina AIBPA2.

📄 IncidentWorkflow.java

COMPARAȚIE

SamurAI față de alte framework-uri de agenți

Criteriu	SamurAI	LangChain4j	Spring AI	Python (LangChain / CrewAI)
Dependențe la rulare	Niciuna	Multe JAR-uri tranzitive	Ecosistemul Spring	Multe pachete pip
Optimizarea costurilor	Integrată, întâi modelele gratuite	Manuală	Manuală	Manuală
Pași fără LLM	Agenți blind nativi	Prin unelte	Prin unelte	Prin unelte
Fluxuri declarative	XML + XSD	Doar cod	Cod / configurare	Cod / YAML
Aprobări umane	Native	De implementat	De implementat	De implementat
Unelte	Studio, interfață web, server MCP	Bibliotecă	Actuator	Terți

PRIMII PAȘI

De la zero la un flux care rulează

Adaugă JAR-ul de bază

Pune samurai-core-1.0.jar în classpath sau declară ro.softway:samurai-core:1.0. Are nevoie doar de Java 17+.
Configurează furnizorii

Pune cheile API în .env sau în proprietăți de sistem. Instanțele Ollama locale și modelele gratuite sunt detectate automat și folosite întâi.
Rulează un flux
```
java -jar samurai-xml-1.0-all.jar run app.xml <flow>
```
Sau construiește același flux în Java, cu API-ul de bază.
Deschide Studio sau conectează-te prin MCP
```
java -jar samurai-studio-1.0-all.jar serve
```
Urmărește rulările live, aprobă pașii opriți sau înregistrează serverul MCP în Claude Code / Cursor.

Mai multe detalii tehnice Codul sursă, configurarea furnizorilor, referința schemei XML și mai multe exemple de fluxuri. github.com/Ste3fan/samurAI

ÎNTREBĂRI

Întrebări frecvente

Ce este SamurAI?

SamurAI este un framework Java creat de SoftWay pentru construirea și orchestrarea agenților AI. Nucleul nu are dependențe externe la rulare și funcționează pe Java 17+.

Poate SamurAI să automatizeze procese de business?

Da. Fluxurile SamurAI combină pași cu AI și pași deterministici (apeluri HTTP, comenzi, funcții Java) pentru a automatiza procese precum trierea tichetelor, procesarea documentelor și facturilor, direcționarea cererilor cu aprobări, rapoarte programate și sincronizarea datelor între sisteme. Porțile de aprobare lasă deciziile sensibile în mâna unui om, iar fiecare rulare este înregistrată împreună cu costul ei.

Ce furnizori LLM suportă SamurAI?

31 de tipuri de furnizori, printre care OpenAI, Anthropic Claude, Google Gemini și Vertex AI, DeepSeek, Groq, AWS Bedrock, Azure, Mistral, xAI, rulare locală (Ollama, LM Studio, vLLM, llama.cpp) și CLI-uri pe bază de abonament, precum Claude Code și Gemini CLI.

Cum ține SamurAI costurile LLM scăzute?

Strategia OPTIMAL preferă modelele gratuite și cele locale, urmărește cotele, escaladează la modele plătite doar la eșec și rulează pașii deterministici cu agenți blind, care nu apelează niciun LLM. Un registru de costuri arată cheltuielile pe model sau pe orchestrator.

Pot defini fluxuri fără să scriu Java?

Da. Aplicațiile, fluxurile, programările și porțile de aprobare pot fi declarate în samurai.xml, validate cu o schemă XSD și rulate din linia de comandă sau din SamurAI Studio.

Funcționează SamurAI cu Claude Code sau Cursor?

Da. Serverul MCP integrat expune fluxurile și agenții SamurAI ca unelte Model Context Protocol pentru Claude Code, Cursor, Google Antigravity și alți clienți MCP.