Embabel Agent Framework: AI agent thuần JVM

Hiểu Mục Đích Cốt Lõi Của Embabel

Embabel Agent Framework là thư viện JVM để viết các luồng (flow) agentic, kết hợp các bước gọi LLM với code thông thường và domain model có kiểu, chứ không phải một sản phẩm agent được host sẵn. Framework mô hình hóa flow bằng Action, Goal, Condition và Plan mà hệ thống lập lại kế hoạch (replan) sau mỗi action, giống một vòng lặp OODA. Dùng nó khi bạn muốn hành vi của agent được viết bằng class Java hoặc Kotlin, chứ không phải YAML hay Python.

Vì Sao Cần Một Framework Agent Hướng JVM

Phần lớn framework agent hiện nay mặc định bạn viết Python và ghép các dict không có kiểu với chuỗi prompt. Những đội đang chạy dịch vụ Spring, backend Kotlin hay hệ thống doanh nghiệp trên JVM thường phải gắn thêm một microservice Python cho phần logic agent, hoặc tự viết một máy trạng thái (state machine) hard-code từng nhánh mà một lệnh gọi LLM có thể đi qua. Embabel Agent Framework nhắm đúng vào khoảng trống đó: nó cho lập trình viên JVM định nghĩa Action, Goal và Condition bằng code Java hoặc Kotlin bình thường, còn việc sắp xếp thứ tự thực thi thì giao cho một planner thay vì một chuỗi if/else phải viết lại mỗi khi thêm khả năng mới.

Khái Niệm Cốt Lõi Và Điểm Khác Biệt

• ✓Goal Oriented Action Planning (GOAP) làm mặc định — thuật toán lập kế hoạch động (mượn từ AI trong game) quyết định thứ tự action lúc chạy, lập lại kế hoạch sau mỗi bước, thay vì chạy một máy trạng thái cố định.
• ✓Chế độ Utility AI — thay GOAP bằng cách chọn action dựa trên điểm tiện ích (utility score) khi không có một goal cố định duy nhất, nhắm tới các tác vụ khám phá mở.
• ✓Hai cách viết agent — mô hình annotation (@Agent, @Goal, @Condition, @Action, giống Spring MVC) và DSL Kotlin thuần dùng block agent { } / action { }.
• ✓Domain model có kiểu tĩnh — Action, Goal và Condition đều dựa trên object có kiểu thay vì 'magic map', nên công cụ refactor vẫn hoạt động tốt trên code gần prompt.
• ✓Ba chế độ thực thi trên AgentPlatform cho việc điều phối nhiều agent (multi-agent orchestration) — Focused (code gọi thẳng một agent), Closed (platform chọn trong số agent đã biết), và Open (platform tự ráp một agent tùy biến từ mọi goal/action đang có); theo README, Open cho hệ thống nhiều dư địa nhất để tự kết hợp các khả năng, đổi lại là kém dự đoán được nhất trong ba chế độ.
• ✓Chạy trên nền Spring — agent có thể được Spring container inject và quản lý, decorate bằng Spring AOP, và dùng persistence/transaction management có sẵn.
• ✓Trộn nhiều LLM ngay trong một flow — theo README, các action khác nhau có thể gọi các LLM khác nhau, kể cả model chạy local, để cân bằng chi phí và năng lực.
• ✓Thiết kế để test được — theo README, cả unit test lẫn test end-to-end cho agent đều nằm trong quy trình dự kiến, minh họa bằng FakeOperationContext trong ví dụ mẫu.

Xây Dựng Agent: Ví Dụ Code

Ví dụ mẫu trong README là agent StarNewsFinder: một class gắn @Agent(description = "...") với nhiều method @Action — một method trích StarPerson từ input người dùng qua ai.withLlm(...).createObjectIfPossible(...), một method gọi thẳng một service Java bình thường không dùng LLM, một method gọi nhóm tool tìm kiếm web, và method cuối được đánh dấu @AchievesGoal để kết thúc flow và trả về object Writeup. Bản Kotlin có cấu trúc tương tự, viết dưới dạng function gắn @Action, và README còn cho thấy kiểu viết DSL Kotlin thuần bằng block agent { } và action { } như một cách khác thay cho annotation. Các domain object như StarPerson và Horoscope là record Java hoặc data class Kotlin thông thường, nên trình biên dịch bắt được ngay chỗ lệch giữa kết quả prompt trả về và code phía sau mong đợi.

Quick Start: Cài Đặt Embabel

Đường quick start trong README không phải kiểu cài package mà theo template: bấm 'Use this template' trên repo template Java hoặc Kotlin trên GitHub để có sẵn một project Maven chạy được. Nếu đã có OPENAI_API_KEY và cài Maven, README nói bạn sẽ có một agent chạy được trong chưa đầy một phút; mục tiêu quick start rộng hơn mà README nêu là dưới 5 phút. Có thêm một Embabel Agent Examples Repository riêng cho tutorial. Cách thêm Embabel làm dependency vào một project Maven hoặc Gradle có sẵn, không xuất phát từ template, thì README không nêu, nên phần đó không được tài liệu hóa rõ ràng.

So Sánh Embabel Với Các Framework Khác

Câu Hỏi Thường Gặp Về Embabel

Trường Hợp Sử Dụng Tốt Nhất

• •Thêm một tính năng dùng LLM vào service Spring Boot có sẵn mà không cần viết lại cả app bằng Python.
• •Xây agent nhiều bước mà action tiếp theo phụ thuộc vào điều kiện lúc chạy, chứ không phải một kịch bản cố định.
• •Đội muốn có unit test cho logic agent và nội dung prompt, không chỉ QA thủ công qua khung chat.
• •Prototype dựa trên ví dụ agent lập kế hoạch du lịch Tripper trong README làm kiến trúc tham chiếu cho một agent app thực tế, không phải hàng demo.

Ai Nên Dùng — Và Ai Nên Bỏ Qua

Chọn Embabel Agent Framework nếu bạn đã chạy backend Spring Boot hoặc JVM và muốn logic agent nằm chung codebase, chung DI container, chung test suite với phần còn lại của app — các đội xây tool nội bộ, flow hỗ trợ khách hàng, hay thứ gì đó giống ví dụ Tripper travel-planner trong README là trường hợp phù hợp. Bỏ qua nếu đội bạn ship bằng Python, cần một hệ sinh thái connector và tích hợp cộng đồng đã trưởng thành ngay bây giờ, hoặc một lệnh gọi LLM hard-code đơn giản là đã đủ mà không cần lập kế hoạch động.

Repo liên quan