> For the complete documentation index, see [llms.txt](https://docs.allganize.ai/allganize-alli-works/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allganize.ai/allganize-alli-works/alli-dashboard/app-management/agent-app.md). # 에이전트형 앱 이 가이드는 에이전트를 활용해 앱을 구축하는 방법을 소개합니다. 에이전트는 간단한 인스트럭션 및 외부 연동을 통해, LLM이 직접 답변/수행할 수 없는 작업들을 상황에 맞게 실행할 수 있습니다. MCP(Model Context Protocol) 서버 및 도구들의 연동이 지원되며, 그에 따라 다양한 MCP 생태계의 툴 및 자사에서 자체적으로 추가한 문서 관리 도구들을 이용할 수 있습니다. 여러 도구를 연동해, 업무흐름을 자동화해보세요. 에이전트가 요청에 맞게 필요한 도구들을 활용합니다. ## 시작하기: 에이전트 앱 구축

앱 관리 페이지에 진입, "새로운 앱 생성" 버튼을 누른 후, "에이전트 만들기" 카드를 선택합니다. 아래와 같이, 에이전트 빌더 페이지로 이동합니다.

1. 앱 정보: 이름, 아이콘, 설명 * 기존의 답변형, 대화형 앱과 같이, 앱의 이름, 설명, 아이콘을 설정할 수 있습니다. 설정하신 내용들은 관리자 대시보드 및 Works에 노출됩니다. 2. LLM 모델 설정 및 인스트럭션 * LLM 모델: 원하는 모델을 선택합니다. * 인스트럭션: Agent에게 인스트럭션(시스템 프롬프트)을 입력합니다. 페르소나 및 역할을 부여하고, 따라야하는 구체적인 지침을 제공합니다. * 변수: {variable\_name}과 같이 변수를 지정해, 값을 대입할 수 있습니다. "변수 추가" 버튼을 통해서, 앱이 실행될 때 사용자에게 변수에 대입될 값을 입력하도록 요구하거나, 시스템 변수들을 활용할 수 있습니다. 여기서 설정된 변수들은, 대화형 앱의 변수와 동일합니다. 기존 변수활용에 대한 자세한 내용은 [여기](https://docs.allganize.ai/allganize-alli-works/alli-dashboard/setting/variable/value)를 참고하세요.

사용자 입력 변수 (앱 실행 시, 대화형 앱의 입력 폼 보내기 노드와 같은 방식으로 동작합니다.)

일반 변수 (앱 실행 시, 설정된 값을 변수에 대입하며 값이 없을 경우 빈 값이 대입됩니다.)

3. 도구 * MCP 서버를 연동하고, 도구 (MCP Tool)을 추가할 수 있습니다. 시간 체크, 웹 검색 등의 단순한 도구부터 각종 서드 파티 서비스들의 MCP Server 연동을 통해 전문적인 자동화를 실행합니다. * "추가" 버튼을 누르면, 아래와 같이 프로젝트 별로 연동된 MCP 서버 및 도구들을 확인하실 수 있습니다. 필요한 도구를 선택하여 에이전트에 추가합니다. \*제품 내에서 필요한 Tool을 찾지못하신 경우, 담당자에게 문의 부탁드립니다.

* 추가 후, 아래와 같이 서버, 도구 별로 연동/설정 버튼을 눌러 연동에 필요한 정보나 상세 argument 값을 입력합니다. 도구의 argument는 일반적으로 에이전트가 사용자의 질의 및 파악한 컨텍스트를 바탕으로 자동으로 채워집니다. 사용자가 직접 입력하는 경우는 예외적인 상황으로 간주되어 해당 값이 항상 실행되는 덮어쓰기(override) 방식으로 인풋이 채워집니다.

MCP 서버 연동을 위해 API Key를 입력합니다. OAuth 인증 등 서버 별 인증 방식이 상이합니다.

도구 (MCP tools)를 활용하기 위한 argument를 확인할 수 있습니다.

4. 대화 시나리오 * 원활한 앱 활용을 위해, 대화 시작 메시지, 모델 호출 실패 시 메시지, 변수 값 요청 메시지(위 2번의 변수에서 "사용자 입력 변수 추가"를 선택했을 때만 사용됩니다.) 를 지정할 수 있습니다. 5. 미리보기 시작 * 버튼을 눌러 우측 미리보기 영역에서 앱을 실행해볼 수 있습니다. 필수 입력 항목이 모두 입력되면 활성화됩니다. 이후 변동이 생기면, "미리보게 업데이트" 버튼으로 변경되어, 업데이트된 내역을 바탕으로 다시 미리보기를 실행할 수 있습니다. ## 예시 앱 위에서 설명한 내용을 바탕으로, 아주 단순한 ‘지역에 따른 시간 반환 앱’을 만들어 보면 아래와 같습니다.

## 공개하기 구축한 에이전트 타입의 앱을 공개하여, Alli Works에서 사용할 수 있습니다. 다른 앱들처럼, [접근 권한](https://docs.allganize.ai/allganize-alli-works/alli-dashboard/app-management/app-permission)을 설정하고 공개합니다.

## 공개하기 - 숙련자용 만약 구축한 Agent를 활용해, 더 복잡하고 구체적인 흐름의 대화형 앱을 만들고 싶으신 경우는 아래와 같은 방식으로 사용하세요.

* 더보기(세 개의 점) 버튼을 누른 후, "에이전트만 공개"를 선택합니다. 이 경우에는 앱은 공개되지 **않으며**, 구축한 에이전트를 대화형 앱의 LLM 실행 노드에서**만** 사용하실 수 있습니다. ("앱 공개하기"를 선택하는 경우에도, LLM 실행 노드에서 마찬가지로 에이전트를 사용할 수 있습니다. 다만, 위의 "에이전트만 공개"는 **앱이 Works 상에 공개되지 않습니다.**) 이를 통해 아래와 같이 더 커스텀한 메시지, 흐름을 만드실 수 있습니다.

## 버전관리 우측 상단에서 과거에 저장 혹은 "공개하기"한 버전 히스토리를 확인하고, 각 버전을 편집 및 '공개'할 수 있습니다. * 각 버전 별로 미리보기가 지원됩니다. * 공개된 버전은 그대로 둔 채, 새 버전을 생성/편집할 수 있습니다. * 과거의 특정 버전 혹은 현재 편집중인 "Current"를 선택 후, "공개하기"를 선택하면, 기존 앱을 '작성 중' 상태로 변경하지 않고 공개할 수 있습니다.

## 작성 중으로 변경하기 앱 관리 페이지에서 앱을 작성 중으로 변경할 수 있습니다. 변경 된 앱은 더 이상 Works 상에서도 노출이 되지 않고, LLM 실행 노드의 에이전트 목록에도 노출이 되지 않습니다.

## 작성 중으로 변경하기 - 숙련자용 앱 빌더 페이지에 진입 후에도, 현재 공개된 버전을 선택하면 앱 및 에이전트의 상태를 "작성 중"으로 변경할 수 있습니다. * 앱이 "작성 중"이면 Works 상에 노출되지 않으며 사용자가 접근할 수 없고, 에이전트가 "작성 중"이면, LLM 실행 노드에 노출되지 않아 사용할 수 없습니다. * 타 버전들은 '공개'될 여지가 있기 때문에, 현재 공개된 버전으로 진입하는 경우에만 "작성 중으로 변경" 버튼이 노출됩니다.

만약 다른 대화형 앱에서 이 에이전트가 사용되고 있을 경우, 이 에이전트는 작성 중으로 변경될 수 없습니다. 다만, 아래와 같이, 앱**'만'** 작성 중으로 변경할 수는 있습니다. * 위와 마찬가지로 현재 공개된 버전으로 진입하는 경우에만 해당 옵션이 노출됩니다.