Core Concepts
AI Agent
Một Agent là một trợ lý được hỗ trợ bởi AI được cấu hình với một mục đích cụ thể, lời nhắc hệ thống, nhà cung cấp LLM và các công cụ kết nối. NPO hỗ trợ hai loại:
- Single Agent: Một AI Agent độc lập hoạt động độc lập với LLM, công cụ và kỹ năng riêng.
- Deep Agent: Một kiến trúc đa AI Agent với một AI Agent Chính phân công nhiệm vụ cho một hoặc nhiều AI Agent Phụ, mỗi AI Agent có LLM, công cụ và kỹ năng riêng.
Máy chủ MCP
MCP (Model Context Protocol) Servers cung cấp các công cụ mà các AI Agent có thể sử dụng để tương tác với các hệ thống và API bên ngoài. Máy chủ MCP có thể là:
- Internal: Được quản lý trong nền tảng NPO.
- External: Kết nối từ các dịch vụ bên thứ ba (ví dụ: Notion, AWS, DuckDuckGo Search).
Kỹ năng
Skills là các tập hợp hướng dẫn có thể tái sử dụng (được định nghĩa trong các tệp SKILL.md) tiêu chuẩn hóa hành vi của AI Agent. Kỹ năng có thể bao gồm các định nghĩa quy trình làm việc, mẫu sử dụng công cụ và kiến thức theo miền cụ thể. Chúng được quản lý thông qua Đăng ký Kỹ năng và có thể được chia sẻ giữa các AI Agent và nhóm.
Middleware
Middleware các lớp thêm các điều khiển xử lý vào các tương tác của AI Agent:
- Human in the Loop: Yêu cầu sự chấp thuận của con người trước khi thực hiện các công cụ cụ thể — với các tùy chọn để Chấp thuận, Chỉnh sửa hoặc Từ chối các cuộc gọi công cụ.
- PII Protection: Tự động phát hiện và xóa dữ liệu nhạy cảm (email, thẻ tín dụng, IP, địa chỉ MAC, URL) trong các đầu vào, đầu ra và kết quả công cụ.
- Summarization: Tóm tắt lịch sử cuộc trò chuyện bằng cách sử dụng LangChain để quản lý giới hạn cửa sổ ngữ cảnh trong khi vẫn bảo tồn thông tin quan trọng.
Cơ sở dữ liệu tri thức
Knowledge Databases cho phép các AI Agent tham chiếu các tài liệu đã tải lên để có kiến thức theo miền cụ thể trong các cuộc trò chuyện.
Tóm tắt phụ thuộc đối tượng
| Đối tượng | Được sử dụng bởi / Phụ thuộc vào |
|---|---|
| LLM Provider | Node LLM AI Agent, Tóm tắt LLM |
| Model | Node LLM AI Agent (Mô hình Mặc định), Tóm tắt (Mô hình Mặc định) |
| API Key (LLM_PROVIDER) | Node LLM AI Agent, Tóm tắt LLM |
| API Key (BACKEND_SERVER) | Xác thực Máy chủ Backend |
| Kubernetes Cluster | Cung cấp Instance MCP, Triển khai AI Agent |
| Backend Server | Hồ sơ MCP (đã đăng ký làm backend) |
| MCP Profile | Instance MCP (được cung cấp từ hồ sơ) |
| OAuth Credentials | Xác thực Hồ sơ MCP, xác thực Kết nối Playground |
| Tools (API Endpoints) | Hồ sơ MCP → AI Agent (được công khai như các công cụ có thể gọi) |
| MCP Instance | AI Agent (cung cấp công cụ), Con người trong Quy trình (quy tắc theo công cụ) |
| External MCP | AI Agent (cung cấp công cụ qua Đăng ký MCP) |
| Provisioning Spec | Instance MCP (Bản sao, CPU, Bộ nhớ, Affinity, Tolerations) |
| Network Spec | Instance MCP (ClusterIP/NodePort, Ingress, TLS) |
| Skill | AI Agent (được gắn như bộ hướng dẫn mô-đun) |
| SKILL.md | Kỹ năng (định nghĩa hành vi và quy trình làm việc) |
| Skill Files | Kỹ năng (Kịch bản, Tài liệu tham khảo, Tài sản) |
| Skill Version | Kỹ năng (phiên bản được ghim sử dụng bởi các AI Agent) |
| Trigger | AI Agent (điểm vào: Chatbot, Webhook, Lịch trình) |
| Chat Memory | AI Agent (duy trì cuộc trò chuyện qua PostgreSQL) |
| User | Nhóm (thành viên), Vai trò (gán), Kỹ năng (chia sẻ), AI Agent (chia sẻ) |
| Group | Người dùng (chứa các thành viên), Vai trò (gán), Kỹ năng (chia sẻ), AI Agent (chia sẻ) |
| Role | Người dùng (kiểm soát truy cập), Nhóm (kiểm soát truy cập) |
| Human in the Loop | Middleware AI Agent → Quy tắc Quyền công cụ theo Máy chủ MCP |
| PII Protection | Middleware AI Agent → quét Đầu vào, Đầu ra, Kết quả Công cụ |
| Summarization | Middleware AI Agent → sử dụng LLM + Khóa API của riêng nó |
| Playground | AI Agent (kiểm tra), Kết nối (xác thực MCP), Kỹ năng (xác thực) |
| Published Agent | Giao diện trò chuyện NPO Workspace |
| Conversation History | NPO Workspace (lưu trữ theo phiên trò chuyện) |
| Theme / Color | Cá nhân hóa giao diện NPO Studio |