Agent Manager 툴킷
Agent Manager 툴킷을 사용하면 프로젝트에서 에이전트를 생성하고 관리할 수 있습니다: 프롬프트 또는 구성으로 생성, 에이전트 나열 및 검사, 성격과 툴킷 업데이트, 구성 검증, 목 모킹된 엔드투엔드 테스트 실행. OAuth나 API 키를 사용하지 않으며 접근은 EKB 프로젝트 구성원 자격과 Agents 권한에 기반합니다.
이 툴킷은 주로 Autopilot (빌드 모드) 및 유사한 빌드 표면에서 사용됩니다. 일반 고객 통합으로 모든 에이전트에 중첩할 것을 의도하지 않았습니다(Agent Manager가 생성한 에이전트에 Agent Manager를 연결할 수 없음).
전제 조건
- 대상 프로젝트의 에이전트 편집 권한 (생성/업데이트/삭제/복제/테스트를 위한 Agents 편집)
- 읽기 전용 작업을 위한 프로젝트 구성원 자격 (나열, 조회, 검증, 연결 확인)
- 읽기 전용 Autopilot 시스템 프로젝트에서 작업할 때는 생성 및 변경 작업에 항상 대상 프로젝트를 선택
사용 가능한 도구
| 도구 | 설명 |
|---|---|
| Get Available Toolkits | 플랫폼 레지스트리에서 툴킷 이름과 설명을 나열합니다(Agent Manager 제외). |
| Create Agent from Prompt | 자연어 설명으로 에이전트를 생성합니다. 대상 프로젝트 필요. |
| Create Agent from Config | 명시적인 이름, 성격, 툴킷 JSON, 옵션(temperature, 에이전트 타입, 출력 형식, 선택적 MCP 서버)으로 에이전트를 생성합니다. |
| List Agent Templates | 내장 에이전트 템플릿을 나열합니다. |
| List Agents | 프로젝트의 에이전트를 나열합니다. |
| Get Agent | 하나의 에이전트에 대한 전체 세부 정보를 반환합니다. |
| Clone Agent | 새 이름으로 에이전트를 복제합니다. |
| Delete Agent | 에이전트를 영구 삭제합니다. |
| Update Agent | 성격 및/또는 전체 툴킷 구성을 교체합니다. |
| Get Agent Toolkits | 에이전트에 연결된 툴킷을 나열합니다. |
| Search Agent Toolkits by Name | 이름 패턴으로 에이전트의 툴킷을 찾습니다. |
| Get Agent Toolkit by ID | id 또는 인덱스로 툴킷 구성 하나를 반환합니다. |
| Get Toolkit Schema | 툴킷의 스키마/예제를 반환하거나, 이름이 없으면 툴킷 이름을 나열합니다. |
| Validate Agent | 에이전트 구성 및/또는 툴킷을 검증합니다(config, toolkits, 또는 full). |
| Test Agent | 외부 통합을 목 모킹하고 실제 LLM으로 엔드투엔드 테스트를 생성하고 실행합니다. |
| Get Connection Requirements | 에이전트의 툴킷에 대한 OAuth/API 키 상태를 보고하여 연결을 완료할 수 있게 합니다. |
사용 사례
- Autopilot 빌드 모드에서 짧은 설명으로 지원 또는 리서치 에이전트의 골격 생성
- 검증된 에이전트를 복제한 다음 성격과 툴킷 조정
- 에이전트 게시 전에 툴킷 구성 검증
- Gmail, Jira 또는 유사한 툴킷을 연결한 후 어떤 연결이 아직 빠져 있는지 확인
팁
- 이미 그 프로젝트 안에 있지 않은 경우 생성/업데이트/삭제에는 항상 대상 프로젝트를 설정하세요(Autopilot 기본 프로젝트에서 필수).
- 프로덕션 채팅에서 새로 구축한 에이전트에 의존하기 전에 Validate Agent를 선호하세요.
- Delete Agent는 영구적입니다 — 먼저 에이전트 id와 프로젝트를 확인하세요.
- MCP 시크릿(API 키, Authorization 헤더)은 에이전트 JSON의 일반 텍스트가 아니라 플랫폼 시크릿 경로를 통해 저장됩니다.
- 기존 에이전트와의 일상적 채팅에는 그 에이전트에 Agent Manager가 필요 없습니다 — 빌드 쪽에서만 사용하세요.
문제 해결
| 증상 | 확인할 사항 |
|---|---|
| 에이전트를 생성하거나 업데이트할 수 없음 | 역할에 프로젝트의 Agents 편집 권한이 필요 |
| 기본 / Autopilot 프로젝트에 관한 오류 | 변경 도구에는 명시적인 대상 프로젝트 id 전달 |
| 툴킷이 노출되지 않음 / Agent Manager 연결 불가 | 예상된 동작 — Agent Manager는 자신이 생성한 에이전트에 설치할 수 없음 |
| Test Agent 결과가 불완전해 보임 | 외부 통합은 목 모킹됨; 성격과 로컬 도구 동작에 집중 |
| 연결 요건이 여전히 실패 | 나열된 툴킷의 OAuth 또는 API 키 설정을 완료한 다음 다시 확인 |