에이전트 관리

AIP의 에이전트 생성, 구성 및 활용 가이드

주요 기능

AIP의 에이전트는 단순한 채팅 기능을 넘어서, 조직 내 다양한 도구와 지식을 연결해주는 업무 특화형 AI 인터페이스입니다. 사용자는 자연어로 요청을 입력하고, 에이전트는 정의된 목적과 도구를 기반으로 자동화된 응답을 제공합니다.

개념 정의

에이전트는 다음의 요소로 구성됩니다:

Instruction (행동 지침): LLM에게 어떤 역할과 행동을 수행할지 정의
LLM 모델: GPT-4, Claude 등 AI 모델을 선택하여 에이전트의 지능 기반 제공
MCP Tool (외부 시스템과의 인터페이스): GitHub, Notion, Snowflake 등 외부 시스템과 연동
Knowledge Bundle (벡터 기반 조직 지식): 조직의 문서, 데이터를 벡터화하여 검색 가능한 지식으로 활용

이 조합은 관리자 화면에서 구성되며, 사용자는 조직에 공유된 에이전트를 사용할 수 있습니다.

에이전트 구성 요소 및 동작 원리

AIP의 에이전트는 다음과 같은 구성 요소로 정의합니다.

구성 요소	설명
LLM Model	GPT-4, Claude 등 사전 등록된 모델 중 선택 (추후 자체 api key 지원, byok)
Instruction	프롬프트 수준의 역할 정의. LLM에게 어떤 응답을 유도할지 지정
MCP Tool	GitHub, Notion, Snowflake 등 외부 시스템 제어를 위한 도구
Knowledge Bundle	파일, GitHub, Drive 등에서 수집한 데이터를 임베딩한 검색 소스

에이전트 유형

에이전트는 두 가지 유형으로 구분됩니다:

Built-in: 에이전트 라이브러리를 통해 설치해서 바로 쓸 수 있는 에이전트입니다. QueryPie AIP에서 제공하는 경우도 있고, 별도 조직에 필요한 에이전트를 미리 설정할 수도 있습니다.
Custom: AIP 내에서 조직의 관리자들이 직접 에이전트 구성요소를 설정해서 만들 수 있는 에이전트입니다.

에이전트 상태

에이전트는 다음 세 가지 상태 중 하나를 가집니다:

Draft: Custom Agent 생성된 직후 또는 Built-In Agent 설치 직후 상태. 사용자는 사용할 수 없는 상태.
Enabled: 정상적으로 구성이 완료되어 사용자에게 공유 및 실행 가능한 상태. 한번 Enabled로 변경하면 Draft 상태로 돌아갈 수 없으며, Enabled 상태에서는 에이전트의 수정과 삭제가 불가능합니다.
Disabled: 일시적으로 비활성화된 상태로, 사용자에게 노출되지 않습니다.

에이전트 관리 기능

Custom 에이전트 생성

“Create Agent” 버튼 클릭 시 에이전트 이름 및 요약 정보를 입력 후 Custom 에이전트를 생성할 수 있습니다.

관리자는 에이전트 상세화면에서 다음 항목을 구성할 수 있습니다.

Agent Name: 에이전트의 고유한 이름을 설정합니다. 조직 내에서 식별하기 쉬운 명확한 이름을 사용하는 것이 좋습니다.
Summary: 에이전트의 기능을 한 줄로 요약한 짧은 설명입니다. 사용자가 에이전트를 선택할 때 참고할 수 있습니다.
Icon: 에이전트를 시각적으로 구분할 수 있는 아이콘을 설정할 수 있습니다.
Description: 사용자에게 표시할 에이전트의 상세한 설명입니다. 에이전트가 수행할 수 있는 작업과 주요 기능을 명확히 설명합니다.
Prompt Guide: 사용자에게 가이드할 예시 질문입니다. 최대 5개까지 등록 가능하며, 사용자가 에이전트를 어떻게 활용할 수 있는지 보여줍니다.
LLM Model: 에이전트가 사용할 AI 모델을 선택합니다. 현재 Claude 4 Sonnet 모델을 기본값으로 제공합니다.
Instruction: 에이전트의 역할과 행동 지침을 정의합니다. LLM에게 어떤 방식으로 응답해야 하는지, 어떤 톤과 스타일을 유지해야 하는지 등을 명시합니다. Instruction 작성 시, 입력란 상단에 표시되는 Enhance Instruction 텍스트 버튼을 클릭하면 간단한 문장(최소 10자 이상)으로 상세한 Instruction을 자동으로 생성할 수 있습니다.
MCP Tool 추가: 외부 시스템과 연동할 수 있는 도구를 추가합니다. GitHub, Notion, 데이터베이스 등 다양한 서비스와 연결할 수 있습니다. 에이전트가 사용하는 Custom MCP에서도 OAuth 연동을 지원하며, DCR(Dynamic Client Registration) 지원 여부와 관계없이 OAuth MCP와 호환이 가능합니다.
Knowledge Bundle 추가: 에이전트가 참조할 수 있는 지식 소스를 연결합니다. 조직의 문서, 데이터베이스, 파일 등을 벡터화하여 검색 가능한 지식으로 활용할 수 있습니다.
테스트 채팅: 화면 우측에서 텍스트 대화로 에이전트의 동작을 즉시 테스트할 수 있습니다. 단, 파일 업로드, Artifact 기능은 사용이 불가합니다.

MCP Tool은 두 가지 방식으로 추가 가능합니다:

AIP에서 제공하는 MCP 서버 및 툴 선택
Custom Remote MCP 직접 등록

⚠️

Authentication Method (인증 방식)

에이전트에 MCP Tool을 추가할 때 인증 방식을 선택할 수 있습니다.

관리자 인증 위임 (Use with admin-provided credentials): 관리자가 인증을 미리 완료하고 사용자에게 이를 위임하는 방식. 현재 기본 값.
사용자 인증 필요 (Require User Authentication): 에이전트를 사용할 때 MCP 서버 구성 및 인증을 사용자가 직접하도록 제공하는 방식.

에이전트 상세페이지

에이전트 상세페이지는 Custom Agent와 Built-in Agent에 따라 다른 관리 기능을 제공합니다.

Custom Agent

관리자가 직접 생성한 에이전트로, 모든 구성 요소를 자유롭게 수정할 수 있습니다.

완전한 편집 권한: 에이전트 이름, 설명, Prompt Guide, 아이콘, LLM 모델, Instruction 등 모든 설정을 수정 가능
Tool 및 Knowledge 관리: MCP Tool 추가/삭제, Knowledge Bundle 연결/해제 등 자유로운 구성
고급 설정: Artifact 활성화, Max Token 설정 등 세부 옵션 조정 가능
즉시 저장: 설정 변경 시 즉시 반영되어 실시간으로 에이전트 동작 확인 가능

Built-in Agent

에이전트 라이브러리에서 설치한 에이전트로, 제한된 편집 권한을 가집니다.

제한된 편집 권한: 에이전트 이름만 수정 가능하며, 핵심 설정은 변경 불가
Tool 연동만 가능: MCP Tool 인증 및 연동 설정만 추가 가능
고정된 구성: LLM 모델, Instruction, Knowledge Bundle 등은 사전 정의된 상태 유지
안정성 우선: 원본 에이전트의 안정성을 위해 핵심 설정 변경 제한

에이전트 공유범위를 설정하는 항목이며, 다음 두 가지 공유 범위를 가집니다.

All Users: 조직의 모든 구성원이 이 에이전트에 접근할 수 있습니다.
Specific Users: 이름 또는 이메일로 사용자를 검색하여, 특정 사용자만 에이전트에 접근할 수 있도록 설정합니다.

에이전트 라이브러리

에이전트 라이브러리는 AIP에서 제공되는 사전 제작한 Built-in 에이전트를 조직에서 설치하여 사용할 수 있도록 하는 기능입니다.

주요 특징

사전 구성된 에이전트: 특정 업무나 도메인에 최적화된 에이전트를 제공
즉시 사용 가능: 설치 후 바로 사용할 수 있도록 모든 구성이 완료된 상태

설치 및 사용

에이전트 선택: 라이브러리에서 원하는 에이전트를 선택
설치: “Install” 버튼을 클릭하여 조직에 에이전트 설치
설정: 필요에 따라 MCP Tool 연동 및 인증 설정
활성화: 에이전트를 활성화하여 사용자에게 공유

사용자 인터페이스 내 에이전트 사용

관리자가 에이전트에 속한 툴 인증방식을 “Require User Authentication”로 설정한 경우, 상세페이지의 Configuration 탭에서 사용자가 직접 구성정보를 입력하거나 인증을 필요로 합니다

상세한 사용자 에이전트 사용 가이드는 사용자 가이드 > Agents를 참고하세요.