Supervisor Agent (Multi-Agent) — 기초

​

개요

• 에이전트 간 상호작용 관리
• 태스크 위임(Delegation)
• 결과 종합(Synthesis)
• 사용자 권한 기반 라우팅

• 시장 분석 (데이터 + 문서 결합)
• 사내 프로세스 자동화
• 고객 서비스 (여러 지식 소스 통합)

​

지원하는 서브 에이전트 유형

참고 중요: Agent Endpoints는 Knowledge Assistant로 만든 엔드포인트만 지원합니다. 일반 Agent Framework 엔드포인트는 사용할 수 없습니다.

​

추가 요구사항

• On-Behalf-Of-User Authorization 활성화
• 최소 1개의 서브 에이전트 또는 도구
• Enhanced Security and Compliance 워크스페이스는 미지원

​

생성 단계 (Step by Step)

​

Step 1: 서브 에이전트 생성 및 권한 부여

1. Knowledge Assistant 생성 → 엔드포인트 확인
   - 엔드 유저에게 CAN QUERY 권한 부여

2. Genie Space 생성 → Space ID 확인
   - 엔드 유저에게 Space 접근 + UC 테이블 SELECT 권한 부여

3. (선택) UC Function 생성
   - 엔드 유저에게 EXECUTE 권한 부여

4. (선택) MCP Server 연결
   - UC Connection 생성 후 USE CONNECTION 권한 부여

​

Step 2: Supervisor 설정

1. Agents> Supervisor Agent> Build 클릭
2. 기본 정보 입력:
   • Name: Supervisor 고유 이름
   • Description: 전체 시스템 목적 설명
3. 서브 에이전트 추가(최대 20개):
   • 각 서브 에이전트의 이름 과 Content Description 입력
   • Description이 태스크 위임 로직에 직접 영향을 줌
4. Instructions(선택): Supervisor의 전체 동작 가이드라인

주의 Description이 라우팅의 핵심입니다. Supervisor는 각 서브 에이전트의 Description을 기반으로 어떤 에이전트에 태스크를 위임할지 결정합니다. 가능한 한 상세하게 작성하세요.

​

Step 3: 테스트

1. Test Your Agent 패널에서 대화형 테스트
2. 올바른 서브 에이전트로 태스크가 위임되는지 확인
3. AI Playground 에서 고급 평가 기능 활용:
   • AI Judge: 자동 품질 평가
   • Synthetic Task Generation: 합성 태스크로 테스트

​

Step 4: 품질 개선

• Examples 탭에서 라벨링된 질문/태스크 시나리오 추가
• SME에게 공유 링크 전달하여 피드백 수집
• 자연어 가이드라인 추가 (저장 즉시 적용)
• 재테스트로 개선 효과 검증

​

Step 5: 권한 관리

​

Step 6: 엔드포인트 쿼리

• AI Playground 인터랙티브 인터페이스
• REST API(curl)
• Python SDK

​

라우팅 로직과 접근 제어

사용자 질문 입력
    ↓
사용자의 서브 에이전트 접근 권한 확인
    ↓
┌─ 모든 서브 에이전트 접근 불가 → 대화 종료
├─ 일부 서브 에이전트 접근 가능 → 접근 불가한 에이전트 자동 회피
└─ 모든 서브 에이전트 접근 가능 → Description 기반 최적 에이전트 선택
    ↓
선택된 서브 에이전트에 태스크 위임
    ↓
결과 종합 후 응답

​

Long-Running Task Mode