에이전트 관리

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

주요 기능

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

개념 정의

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

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

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

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

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

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

에이전트 유형

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

Built-in: 에이전트 라이브러리를 통해 설치해서 바로 쓸 수 있는 에이전트입니다. 기본 제공 에이전트를 사용하거나, 조직에 필요한 에이전트를 미리 설정할 수 있습니다.
Custom: 조직의 관리자들이 직접 에이전트 구성요소를 설정해서 만들 수 있는 에이전트입니다.

에이전트 상태

에이전트 관리 화면에서 사용하는 주요 상태는 다음과 같습니다:

Enabled: 정상적으로 구성이 완료되어 사용자에게 공유 및 실행 가능한 상태. Enabled 상태에서는 에이전트의 수정과 삭제가 불가능합니다.
Disabled: 일시적으로 비활성화된 상태로, 사용자에게 노출되지 않습니다.

에이전트 공개 승인 워크플로

승인 워크플로우를 사용하면 AI 담당자가 조직 에이전트를 사용자에게 공개하기 전에 관리자 또는 오너가 설정과 사용 목적을 먼저 검토할 수 있습니다. 승인 대상은 Disabled 상태의 조직 에이전트를 Enabled 상태로 전환하는 작업입니다.

AI 담당자는 에이전트를 구성하고 공개 승인을 요청할 수 있습니다. 관리자와 오너는 요청된 에이전트의 설정, 공개 범위, 요청 사유를 검토한 뒤 공개 여부를 결정합니다.

AI 담당자가 공개 승인을 요청하는 방법

Agent 관리 화면에서 공개할 에이전트의 활성화를 시도합니다.
공유 범위를 확인합니다. 공개 대상을 변경해야 하는 경우 공유 범위 수정을 클릭해 공유 범위를 변경합니다.
승인 요청을 클릭하고 요청 사유를 입력합니다.
요청이 생성되면 승인 요청 상세 화면으로 이동하고, 상태가 대기로 표시됩니다.

요청이 대기 중인 동안에는 해당 에이전트의 공유 설정이나 상태를 변경할 수 없습니다. 요청자는 승인 요청 상세 화면에서 요청 내용과 검토 상태를 확인하거나, 검토 전 요청을 취소할 수 있습니다.

관리자 또는 오너가 승인 요청을 검토하는 방법

Agent 관리 화면에서 승인 워크플로우로 이동합니다.
승인 요청 목록에서 요청 상태를 필터링하거나, 에이전트 이름 또는 요청자로 검색합니다.
승인 요청 상세 화면에서 요청 사유, 에이전트 정보, 현재 상태, 검토 이력을 확인합니다.
필요한 경우 에이전트 테스트로 이동을 클릭해 설정과 테스트 채팅 결과를 확인합니다.
공개해도 되는 경우 승인 후 공개를 클릭하고 검토 사유를 입력합니다.
보완이 필요한 경우 반려를 클릭하고 반려 사유를 입력합니다.

승인되면 에이전트가 Enabled 상태로 전환되고, 설정된 공유 범위에 따라 사용자에게 공개됩니다. 반려되면 에이전트는 공개되지 않으며, AI 담당자는 에이전트 설정을 수정한 뒤 다시 승인 요청을 보낼 수 있습니다.

승인 워크플로우 사용 설정

관리자 또는 오너는 승인 워크플로우 화면 상단에서 이 기능을 켜거나 끌 수 있습니다.

기능이 꺼져 있는 경우: 화면 우측 상단에 표시되는 승인 워크플로우 스위치를 켭니다.
기능이 켜져 있는 경우: 화면 제목 옆의 설정 아이콘을 클릭한 뒤, 팝오버에 표시되는 승인 워크플로우 스위치를 끕니다.

워크플로우를 끄면 AI 담당자가 관리자 또는 오너 검토 없이 에이전트를 공개할 수 있습니다. 대기 중인 요청이 있는 경우에는 끄기 확인 창에서 대기 중인 요청도 함께 취소를 선택해 남아 있는 승인 요청을 함께 취소할 수 있습니다.

관리자 또는 오너가 직접 에이전트를 활성화하는 경우에는 별도 승인 요청 없이 공개할 수 있습니다.

에이전트 관리 기능

Custom 에이전트 생성

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

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

Agent Name: 에이전트의 고유한 이름을 설정합니다. 조직 내에서 식별하기 쉬운 명확한 이름을 사용하는 것이 좋습니다.
Summary: 에이전트의 기능을 한 줄로 요약한 짧은 설명입니다. 사용자가 에이전트를 선택할 때 참고할 수 있습니다.
Icon: 에이전트를 시각적으로 구분할 수 있는 아이콘을 설정할 수 있습니다.
Description: 사용자에게 표시할 에이전트의 상세한 설명입니다. 에이전트가 수행할 수 있는 작업과 주요 기능을 명확히 설명합니다.
Prompt Guide: 사용자에게 가이드할 예시 질문입니다. 최대 5개까지 등록 가능하며, 사용자가 에이전트를 어떻게 활용할 수 있는지 보여줍니다.
LLM Model: 에이전트가 사용할 AI 모델을 선택합니다. Claude Opus 4.7, OpenAI GPT-5.5, Google Gemini 3.5 Flash 등의 최신 고성능 모델을 지원합니다.
Wide Context: (지원 모델 전용) 최대 1M 토큰까지 컨텍스트 윈도우를 확장하여 긴 문서나 대량의 데이터를 처리할 수 있도록 설정합니다. Claude 4.5 Sonnet, Claude Opus 4.7, GPT-5.4, GPT-5.4 Mini, Gemini 3.1 Pro, Gemini 3.1 Flash Lite, Gemini 3.5 Flash 모델에서 활성화할 수 있습니다.
Thinking Mode (지원 모델 전용): Adaptive Thinking과 Extended Thinking 모드를 지원하여, 복잡한 추론 작업에서 더 깊이 있는 분석 결과를 제공합니다.
Instruction: 에이전트의 역할과 행동 지침을 정의합니다. LLM에게 어떤 방식으로 응답해야 하는지, 어떤 톤과 스타일을 유지해야 하는지 등을 명시합니다. Instruction 작성 시, 입력란 상단에 표시되는 Enhance Instruction 텍스트 버튼을 클릭하면 간단한 문장(최소 10자 이상)으로 상세한 Instruction을 자동으로 생성할 수 있습니다.
MCP Tool 추가: 외부 시스템과 연동할 수 있는 도구를 추가합니다. GitHub, Notion, 데이터베이스 등 다양한 서비스와 연결할 수 있습니다. 에이전트가 사용하는 Custom MCP에서도 OAuth 연동을 지원하며, DCR(Dynamic Client Registration) 지원 여부와 관계없이 OAuth MCP와 호환이 가능합니다.
- Edge Tunnel 설정: 사설 네트워크나 로컬 환경에 있는 도구를 연결할 때 Edge Tunnel을 사용하여 안전하게 연동할 수 있습니다.
  - Personal Edge Tunnel: 개인 PC에서 실행되는 터널을 통해 연결합니다.
  - Org Edge Tunnel (Enterprise 플랜 전용): 조직 단위로 관리되는 터널을 통해 팀원들이 별도의 터널 실행 없이 도구를 사용할 수 있습니다.
Skill 추가: 관리자가 등록한 공용 스킬을 에이전트에 연결합니다. Skill 관리에서 업로드된 스킬을 선택하면, 에이전트가 대화 수행 중 필요에 따라 해당 스킬을 활용합니다.
- Edge Tunnel Scope: Skill에서 로컬 네트워크나 내부 시스템 접근이 필요한 경우, Skill 하단의 Edge Tunnel Scope를 설정합니다. Scope에 따라 사용자의 개인 Edge Tunnel 또는 조직 Edge Tunnel을 통해 Sandbox 작업에서 내부 리소스에 접근할 수 있습니다.
Knowledge Bundle 추가: 에이전트가 참조할 수 있는 지식 소스를 연결합니다. 조직의 문서, 데이터베이스, 파일 등을 벡터화하여 검색 가능한 지식으로 활용할 수 있습니다.
Allow File Upload: 활성화 시, 에이전트 대화창에서 사용자가 파일(텍스트, 이미지)을 업로드할 수 있는 기능이 사용자 에이전트 채팅 화면에서 노출됩니다. 사용자는 로컬 디바이스나 My Drive에서 파일을 선택하여 작업을 수행할 수 있습니다.
Web 앱, Widget, TTS 사용: 활성화된 기능과 연결된 도구에 따라 에이전트가 Web 앱을 생성하거나 위젯을 만들고, 응답을 음성으로 제공할 수 있습니다.
개인 메모리 사용 억제: 활성화 시, 에이전트가 사용자 개인 메모리를 저장하거나 이후 대화에 활용하지 않습니다. 관리자가 이 옵션을 활성화하면 사용자는 개인 메모리 설정을 변경할 수 없습니다.
DLP Settings: 에이전트 채팅에서 DLP 정책이 적용되어, 사용자의 입력과 AI의 응답 모두에서 민감 정보 유출을 방지할 수 있습니다.
- 조직 설정 사용: 보안 > DLP 관리에서 설정된 정책 그대로 사용합니다.
- 커스텀: 에이전트 개별로 적용할 DLP 정책을 직접 정의하는 옵션입니다. 상세 설정 방법은 DLP 관리 메뉴를 참고하세요.
테스트 채팅: 화면 우측에서 텍스트 대화로 에이전트의 동작을 즉시 테스트할 수 있습니다. 단, 파일 업로드, Artifact 기능은 사용이 불가합니다.

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

기본 제공 MCP 서버 및 툴 선택
Custom Remote MCP 직접 등록

⚠️

Authentication Method (인증 방식)

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

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

에이전트 상세페이지

에이전트 상세페이지는 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: 이름 또는 이메일로 사용자를 검색하여, 특정 사용자만 에이전트에 접근할 수 있도록 설정합니다.

태그 기반 공유가 활성화된 조직에서는 사용자 태그를 선택하여 에이전트 공유 범위를 지정할 수 있습니다. 부서, 역할, 프로젝트 단위로 사용자 태그를 관리하면 개별 사용자를 일일이 추가하지 않고도 필요한 대상에게 에이전트를 제공할 수 있습니다.

Agent chat-only 링크

특정 조직 에이전트로 바로 이동하는 chat-only 링크를 제공할 수 있습니다. 링크를 받은 사용자는 에이전트 설정 화면이 아니라 해당 에이전트의 채팅 화면으로 바로 이동합니다.

링크 접근 권한을 함께 설정할 수 있습니다.
고객 지원, 사내 FAQ, 승인 요청처럼 사용자가 특정 에이전트와 바로 대화해야 하는 업무에 적합합니다.
공유 범위를 변경하면 링크 접근 가능 대상도 함께 변경됩니다.

에이전트 라이브러리

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

주요 특징

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

설치 및 사용

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

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

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

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