에이전트 사용 가이드

AIP에서 제공되는 에이전트를 활용하여 업무를 자동화하고 효율성을 높이는 방법을 안내합니다.

에이전트는 크게 조직 에이전트와 개인 에이전트로 구분됩니다.

• 조직 에이전트: 관리자가 생성하고 조직 사용자에게 공유하는 에이전트입니다.
• 개인 에이전트: 사용자가 직접 생성하고 개인 업무 방식에 맞게 설정하는 에이전트입니다.

공통 기능

• 사용 가능한 에이전트 목록 확인 및 선택
• 에이전트와의 채팅을 통한 업무 자동화
• 에이전트 상세 정보 확인
• MCP Integration, Skill을 활용한 작업 수행
• 에이전트 실행 이력 및 결과 확인

에이전트 사용하기

에이전트 목록 확인

좌측 메뉴에서 Agents를 클릭하면 사용할 수 있는 에이전트를 확인할 수 있습니다.

Agents 화면에서는 에이전트 유형에 따라 다음 탭을 사용할 수 있습니다.

• 개인 에이전트: 내가 직접 생성한 에이전트 목록
• 조직 에이전트: 조직에서 공유된 에이전트 목록

에이전트 채팅 기능

• 채팅 입력창 우측 하단에서 컨텍스트 윈도우 사용량을 시각적으로 확인할 수 있으며, 이는 에이전트가 대화의 맥락을 처리하는 공간이 가득 차 답변 품질이 저하되기 전에 ‘새 대화 시작’이 필요한 시점을 파악하는 데 도움을 줍니다.
• 에이전트가 응답을 생성하는 동안, 진행 상태 문구와 소요 시간이 함께 표시되어 응답 과정을 직관적으로 이해할 수 있습니다.
• 에이전트 응답 하단에서 해당 응답에 사용된 크레딧을 확인할 수 있습니다.
• 도구 호출 시 MCP Integration 이름, Tool 이름, Skill 이름이 함께 표시되어, 에이전트가 어떤 출처의 도구를 사용하여 작업을 수행 중인지 명확하게 확인할 수 있습니다.
• 에이전트에서는 문서 파일 처리(PDF, Excel, PPTX, DOCX 분석)를 위한 Built-in Skill이 자동으로 제공됩니다. 별도의 설정 없이도 업로드된 문서를 빠르고 정확하게 분석할 수 있으며, 파일은 한 턴당 200MB까지 지원합니다. 세션당 누적 제한은 없습니다.
• AI 이미지 생성: 이미지 생성 MCP가 연동된 에이전트에서는 텍스트 프롬프트로 이미지를 직접 생성할 수 있습니다. 채팅창에 원하는 이미지를 설명하면 에이전트가 이미지를 생성하여 대화 내에서 바로 확인할 수 있습니다.
• Web 앱 및 위젯 생성: 에이전트 채팅에서 Web 앱이나 데이터 시각화 위젯을 생성하도록 요청할 수 있습니다. 업무용 대시보드, 검색 화면, 간단한 내부 도구처럼 대화 결과를 실행 가능한 형태로 만들 수 있습니다.
• TTS 응답: 에이전트 응답을 음성으로 들을 수 있습니다. 음성은 사용자 설정의 TTS 음성 설정을 따릅니다.
• 전용 chat-only 링크: 특정 에이전트의 채팅 화면으로 바로 이동하는 링크를 사용할 수 있습니다. 공유받은 사용자는 에이전트 설정 화면을 거치지 않고 해당 에이전트와 바로 대화할 수 있습니다.
• 런처 화면에서 에이전트 시작: 런처 역할 사용자는 할당된 에이전트를 타일 형태로 확인하고, 원하는 에이전트를 선택해 바로 새 채팅을 시작할 수 있습니다.

조직 에이전트

조직 에이전트는 관리자가 생성하고 조직 사용자에게 공유하는 에이전트입니다. 사용자는 조직에서 공유된 에이전트를 선택해 사용할 수 있습니다.

주요 특징

• 조직 관리자가 에이전트의 목적, 설명, Instruction, Integration, Skill을 설정합니다.
• 사용자는 공유된 조직 에이전트를 선택하여 채팅을 시작할 수 있습니다.
• 관리자가 “Require User Authentication”으로 설정한 경우, 사용자가 직접 인증 정보를 입력해야 합니다.

조직 에이전트 상세 정보

조직 에이전트 상세 화면에서는 다음 정보를 확인할 수 있습니다.

Overview 탭:

• 에이전트의 상세한 기능 설명
• 연동 가능한 서비스 정보

Configuration 탭:

• 사용자 인증이 필요한 서비스 연동 설정
• 개인 메모리 사용 억제 설정
• 에이전트 전용 chat-only 링크 확인

Security 탭:

• 관리자가 외부 서비스 연결을 허용한 에이전트에서는 A2A Endpoint와 Agent Card URL을 확인할 수 있습니다.
• Access Token 관리에서 외부 서비스가 에이전트를 호출할 때 사용할 A2A Access Token을 발급, 복사, 폐기할 수 있습니다.
• 외부 서비스에 Agent Card URL 또는 Endpoint와 Access Token을 등록하면 해당 서비스에서 에이전트를 호출할 수 있습니다.

개인 메모리 사용 억제:

• Configuration 탭 하단에서 개인 메모리 사용 억제 토글을 켜면, 해당 에이전트가 사용자의 개인 메모리를 저장하거나 이후 대화에 활용하지 않습니다.
• 관리자가 에이전트 단위로 개인 메모리를 비활성화한 경우, 관리자 잠금 배지가 표시되며 사용자가 직접 변경할 수 없습니다.

전용 chat-only 링크:

• 조직에서 공유한 에이전트에 전용 링크가 제공되는 경우, 사용자는 해당 링크를 통해 특정 에이전트와 바로 대화를 시작할 수 있습니다.
• 링크 접근 권한을 함께 설정할 수 있습니다.
• 고객 지원, 사내 FAQ, 승인 요청처럼 특정 에이전트로 바로 안내해야 하는 업무에 활용할 수 있습니다.

런처 화면에서 에이전트 시작하기

런처 역할로 조직에 접속하면 일반 채팅 목록이나 에이전트 설정 화면 대신, 사용할 수 있는 에이전트만 모아둔 새 채팅 화면이 표시됩니다. 사용자는 이 화면에서 필요한 에이전트를 선택해 바로 채팅을 시작할 수 있습니다.

사용 방법:

1. 런처 역할이 부여된 계정으로 로그인합니다.
2. 조직에 접속하면 새 채팅 화면에서 접근 가능한 에이전트 타일을 확인합니다.
3. 사용할 에이전트 타일에서 이름과 요약을 확인합니다.
4. 채팅 시작을 클릭해 해당 에이전트의 새 채팅으로 이동합니다.

화면에 표시되는 정보:

• 에이전트 아이콘
• 에이전트 이름
• 에이전트 요약
• 채팅 시작 버튼

접근 가능한 에이전트가 없는 경우 할당된 에이전트가 없습니다 안내가 표시됩니다. 이 경우 조직 관리자에게 사용할 에이전트 할당을 요청하세요.

개인 에이전트

개인 에이전트는 사용자가 직접 생성하고 설정하는 에이전트입니다. 개인 업무 방식에 맞게 모델, 지시사항, Skill, Integration을 구성하고 바로 채팅에서 사용할 수 있습니다.

주요 특징

• 사용자가 직접 개인 에이전트를 생성하고 삭제할 수 있습니다.
• 기존 Preset을 기반으로 개인 에이전트를 가져올 수 있습니다.
• 에이전트 이름, 설명, 아이콘을 설정할 수 있으며, 이름과 요약을 기반으로 아이콘을 생성할 수 있습니다.
• 에이전트 설명과 예시 프롬프트를 직접 작성할 수 있습니다.
• LLM 모델, Instruction, Skill, Integration, 생성 옵션을 직접 구성할 수 있습니다.

개인 에이전트 생성

개인 에이전트 탭에서 New Agent 버튼을 클릭하여 개인 에이전트를 생성합니다.

기본 정보:

• Name: 개인 에이전트 이름을 입력합니다.
• Summary: 목록에 표시할 간단한 설명을 입력합니다.
• Icon: 에이전트를 구분할 아이콘을 업로드하거나, 아이콘 생성 버튼을 클릭해 이름과 Summary에 맞는 아이콘을 생성할 수 있습니다. 아이콘 생성 시 크레딧이 사용됩니다.

생성이 완료되면 개인 에이전트 상세 화면에서 추가 설정을 구성할 수 있습니다.

Preset에서 가져오기

Preset에서 가져오기 버튼을 사용하면 기존 Preset을 기반으로 개인 에이전트를 만들 수 있습니다.

가져올 Preset을 선택하면 Preset에 포함된 설정을 기반으로 개인 에이전트가 생성됩니다. 일부 Integration은 가져온 뒤 재인증이 필요할 수 있습니다.

개인 에이전트 상세 정보

개인 에이전트 상세 화면에서는 개요와 설정 탭을 통해 에이전트의 동작 방식을 관리합니다.

개요 탭:

• Description: 에이전트의 역할과 사용 방법을 설명합니다.
• 예시 프롬프트: 사용자가 에이전트를 시작할 때 참고할 수 있는 예시 질문을 등록합니다.

설정 탭:

• LLM 모델: 에이전트가 사용할 모델을 선택합니다.
• Instruction: 에이전트가 따라야 할 지시사항을 작성합니다.
• Skills: 에이전트가 사용할 Skill을 선택합니다.
• Integrations: 에이전트가 사용할 MCP Integration을 연결합니다.
• 생성 옵션: 파일 업로드 지원, Artifacts 사용, 최대 출력 토큰, 개인 메모리 저장 여부를 설정합니다.
• Web 앱, 위젯, TTS 사용: 에이전트가 Web 앱을 만들거나 위젯을 생성하고, 응답을 음성으로 제공하도록 요청할 수 있습니다.

주의사항

1. 인증 정보 관리: 개인 인증이 필요한 서비스의 경우 안전하게 정보를 관리하세요.
2. 권한 확인: 에이전트가 접근하는 데이터와 서비스의 권한을 정기적으로 점검하세요.
3. Skill 변경 반영: Skill을 수정한 경우 새 채팅을 시작해야 변경된 내용이 안정적으로 반영됩니다.
4. 민감한 정보 보호: 개인정보나 기밀 정보가 포함된 요청은 신중하게 처리하세요.
5. A2A Access Token 관리: 외부 서비스 연결에 사용하는 token은 안전하게 보관하고, 더 이상 사용하지 않는 token은 폐기하세요.