> 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 생태계의 툴 및 자사에서 자체적으로 추가한 문서 관리 도구들을 이용할 수 있습니다. 여러 도구를 연동해, 업무흐름을 자동화해보세요. 에이전트가 요청에 맞게 필요한 도구들을 활용합니다.

## 시작하기: 에이전트 앱 구축

<figure><img src="/files/MSaDIK5orZzf13uiE2hm" alt=""><figcaption></figcaption></figure>

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

아래와 같이, 에이전트 빌더 페이지로 이동합니다.

<figure><img src="/files/G0yqeApGpxcqposD9SoB" alt=""><figcaption></figcaption></figure>

1. 앱 정보: 이름, 아이콘, 설명

* 기존의 답변형, 대화형 앱과 같이, 앱의 이름, 설명, 아이콘을 설정할 수 있습니다. 설정하신 내용들은 관리자 대시보드 및 Works에 노출됩니다.

2. LLM 모델 설정 및 인스트럭션&#x20;

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

<figure><img src="/files/XXFjeJuu5ow8pydLUDJL" alt=""><figcaption><p>사용자 입력 변수 (앱 실행 시, 대화형 앱의 <a href="https://docs.allganize.ai/allganize-alli-works/alli-dashboard/app-management/conversation-app/nodes/undefined-1">입력 폼 보내기 노드</a>와 같은 방식으로 동작합니다.)</p></figcaption></figure>

<figure><img src="/files/ASszrar4Xie4rxTAYJal" alt=""><figcaption><p>일반 변수 (앱 실행 시, 설정된 값을 변수에 대입하며 값이 없을 경우 빈 값이 대입됩니다.)</p></figcaption></figure>

<figure><img src="/files/Lvhzs0eqLSrbPeWGpc91" alt=""><figcaption></figcaption></figure>

3. 도구

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

<figure><img src="/files/C6MmI5PCFIIFXlGvNE2G" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/AILEDZErVjwqtCwRE1P9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OuE0obKw8AJmnCznYNHl" alt=""><figcaption><p>MCP 서버 연동을 위해 API Key를 입력합니다. OAuth 인증 등 서버 별 인증 방식이 상이합니다.</p></figcaption></figure>

<figure><img src="/files/6UhOf9TKHGq6qDjfShVY" alt=""><figcaption><p>도구 (MCP tools)를 활용하기 위한 argument를 확인할 수 있습니다. </p></figcaption></figure>

4. 대화 시나리오

* 원활한 앱 활용을 위해, 대화 시작 메시지, 모델 호출 실패 시 메시지, 변수 값 요청 메시지(위 2번의 변수에서 "사용자 입력 변수 추가"를 선택했을 때만 사용됩니다.) 를 지정할 수 있습니다.

5. 미리보기 시작

* 버튼을 눌러 우측 미리보기 영역에서 앱을 실행해볼 수 있습니다. 필수 입력 항목이 모두 입력되면 활성화됩니다. 이후 변동이 생기면, "미리보게 업데이트" 버튼으로 변경되어, 업데이트된 내역을 바탕으로 다시 미리보기를 실행할 수 있습니다.

## 예시 앱

위에서 설명한 내용을 바탕으로, 아주 단순한 ‘지역에 따른 시간 반환 앱’을 만들어 보면 아래와 같습니다.

<figure><img src="/files/8NmX3zhqvcLcTiYJErJs" alt=""><figcaption><p>앱 구축 한모습</p></figcaption></figure>

<figure><img src="/files/v9SvW71Twl0MRobyzLOa" alt=""><figcaption><p>미리보기를 실행한 모습</p></figcaption></figure>

## 공개하기&#x20;

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

<figure><img src="/files/SXzYEqLSsBrJfy8URiMS" alt=""><figcaption><p>앱을 공개하는 모습</p></figcaption></figure>

<figure><img src="/files/teQyu9rUJl51kyeb1No8" alt=""><figcaption><p>Works 상에서 사용하는 모습</p></figcaption></figure>

## 공개하기 - 숙련자용

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

<figure><img src="/files/rzqiARMejJm5UsgoOya2" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/XjGyIbw9BsJy93fxZbT8" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Ie6MD38dSe7ozIOP74FS" alt=""><figcaption></figcaption></figure>

## 버전관리

우측 상단에서 과거에 저장 혹은 "공개하기"한 버전 히스토리를 확인하고, 각 버전을 편집 및 '공개'할 수 있습니다.&#x20;

* 각 버전 별로 미리보기가 지원됩니다.
* 공개된 버전은 그대로 둔 채, 새 버전을 생성/편집할 수 있습니다.
* 과거의 특정 버전 혹은 현재 편집중인 "Current"를 선택 후, "공개하기"를 선택하면, 기존 앱을 '작성 중' 상태로 변경하지 않고 공개할 수 있습니다.&#x20;

<figure><img src="/files/jst1C8iOZcLO62c1INSA" alt=""><figcaption></figcaption></figure>

## 작성 중으로 변경하기

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

<figure><img src="/files/M3AAADLz3T4HkGWEo3is" alt=""><figcaption></figcaption></figure>

## 작성 중으로 변경하기 - 숙련자용

앱 빌더 페이지에 진입 후에도, 현재 공개된 버전을 선택하면 앱 및 에이전트의 상태를 "작성 중"으로 변경할 수 있습니다.&#x20;

* 앱이 "작성 중"이면 Works 상에 노출되지 않으며 사용자가 접근할 수 없고, 에이전트가 "작성 중"이면, LLM 실행 노드에 노출되지 않아 사용할 수 없습니다.&#x20;
* 타 버전들은 '공개'될 여지가 있기 때문에, 현재 공개된 버전으로 진입하는 경우에만 "작성 중으로 변경" 버튼이 노출됩니다.

<figure><img src="/files/VeEllQQqm7Id4cMPkHw6" alt=""><figcaption></figcaption></figure>

만약 다른 대화형 앱에서 이 에이전트가 사용되고 있을 경우, 이 에이전트는 작성 중으로 변경될 수 없습니다. 다만, 아래와 같이, &#xC571;**'만'** 작성 중으로 변경할 수는 있습니다.&#x20;

* 위와 마찬가지로 현재 공개된 버전으로 진입하는 경우에만 해당 옵션이 노출됩니다.&#x20;

<figure><img src="/files/ehEmbBMnEYA7hu5H3hvK" alt=""><figcaption></figcaption></figure>