Core Concepts
Agents
에이전트는 특정 목적, 시스템 프롬프트, LLM 제공자 및 연결된 도구로 구성된 AI 기반 어시스턴트입니다. NPO는 두 가지 유형을 지원합니다.
- 단일 에이전트: 자체 LLM, 도구 및 스킬을 사용하여 독립적으로 작동하는 독립형 에이전트입니다.
- 딥 에이전트: 메인 에이전트가 하나 이상의 서브 에이전트에게 작업을 위임하는 멀티 에이전트 아키텍처이며, 각 에이전트는 자체 LLM, 도구 및 스킬을 가집니다.
MCP Server
MCP (Model Context Protocol) 서버는 에이전트가 외부 시스템과 API와 상호작용할 수 있도록 해주는 도구를 제공합니다. MCP 서버는 다음과 같이 분류됩니다.
- 내부: NPO 플랫폼 내에서 관리됩니다.
- 외부: 제3자 서비스에서 연결됩니다 (예: Notion, AWS, DuckDuckGo Search).
Skills
Skills는 에이전트의 동작을 표준화하는 재사용 가능한 지침 세트(SKILL.md 파일에서 정의)로, 워크플로 정의, 도구 사용 패턴 및 도메인별 지식을 포함할 수 있습니다. Skill Registry를 통해 관리되며 에이전트와 팀 간에 공유할 수 있습니다.
Middleware
Middleware는 에이전트 상호작용에 처리 제어를 추가합니다.
- Human in the Loop: 특정 도구를 실행하기 전에 인간의 승인을 요구합니다 — 도구 호출에 대해 승인, 편집 또는 거절할 수 있는 옵션이 있습니다.
- PII Protection: 입력, 출력 및 도구 결과에서 민감한 데이터(이메일, 신용카드, IP, MAC 주소, URL)를 자동으로 탐지하고 삭제합니다.
- Summarization: LangChain을 사용하여 대화 기록을 압축하여 중요한 정보를 보존하면서 컨텍스트 윈도우 제한을 관리합니다.
Knowledge DB
Knowledge Databases는 에이전트가 대화 중 도메인별 지식을 위해 업로드된 문서를 참조할 수 있도록 합니다.
객체 의존성 요약
| 객체 | 사용 대상 / 의존 관계 |
|---|---|
| LLM Provider | 에이전트 LLM 노드, 요약 LLM |
| Model | 에이전트 LLM 노드 (기본 모델), 요약 (기본 모델) |
| API Key (LLM_PROVIDER) | 에이전트 LLM 노드, 요약 LLM |
| API Key (BACKEND_SERVER) | 백엔드 서버 인증 |
| Kubernetes Cluster | MCP 인스턴스 프로비저닝, 에이전트 배포 |
| Backend Server | MCP 프로파일 (백엔드로 등록됨) |
| MCP Profile | MCP 인스턴스 (프로파일에서 프로비저닝됨) |
| OAuth Credentials | MCP 프로파일 인증, 플레이그라운드 커넥터 인증 |
| Tools (API Endpoints) | MCP 프로파일 → 에이전트 (호출 가능한 도구로 노출됨) |
| MCP Instance | 에이전트 (도구 제공), 루프 내 인간 (도구별 규칙) |
| External MCP | 에이전트 (MCP 레지스트리를 통해 도구 제공) |
| Provisioning Spec | MCP 인스턴스 (복제본, CPU, 메모리, 친화성, 내성) |
| Network Spec | MCP 인스턴스 (ClusterIP/NodePort, Ingress, TLS) |
| Skill | 에이전트 (모듈식 명령 세트로 첨부됨) |
| SKILL.md | Skill (행동 및 워크플로 정의) |
| Skill Files | Skill (스크립트, 참조, 자산) |
| Skill Version | Skill (에이전트가 사용하는 고정 버전) |
| Trigger | 에이전트 (진입점: 챗봇, 웹훅, 스케줄러) |
| Chat Memory | 에이전트 (PostgreSQL을 통한 대화 지속성) |
| User | 그룹 (회원), 역할 (할당), Skill (공유), 에이전트 (공유) |
| Group | 사용자 (구성원 포함), 역할 (할당), Skill (공유), 에이전트 (공유) |
| Role | 사용자 (접근 제어), 그룹 (접근 제어) |
| Human in the Loop | 에이전트 미들웨어 → MCP 서버별 도구 권한 규칙 |
| PII Protection | 에이전트 미들웨어 → 입력, 출력, 도구 결과 스캔 |
| Summarization | 에이전트 미들웨어 → 자체 LLM + API 키 사용 |
| Playground | 에이전트 (테스트), 커넥터 (MCP 인증), Skill (검증) |
| Published Agent | NPO Workspace 채팅 인터페이스 |
| Conversation History | NPO Workspace (채팅 세션별로 저장됨) |
| Theme / Color | NPO Studio UI 개인화 |