앱 프롬프트

앱 편집 화면에서 프롬프트 추가 및 관리하기

앱 편집 화면에서 프롬프트를 실시간으로 작성하고 즉시 앱에 반영할 수 있습니다. 프롬프트는 아래 두 가지 범위로 구분됩니다.

  • 앱 프롬프트: 특정 앱에만 종속되어 사용되는 프롬프트입니다. 해당 가이드에서 자세히 설명합니다.

  • 프로젝트 프롬프트: 하나의 프로젝트 내 여러 앱에서 공유 가능한 프롬프트입니다. 상세 내용은 프로젝트 프롬프트 가이드를 참고해 주세요.

1. 앱 편집 화면에서 앱 프롬프트 추가하기

  1. 프롬프트 범위를 선택합니다. 앱 프롬프트를 선택합니다.

  2. 프롬프트를 실행할 LLM 모델을 선택합니다.

  3. 기존에 만들어진 프롬프트를 활용하려면 '프롬프트' 드롭다운에서 사용하고자 하는 프롬프트를 선택합니다.

  1. 새 프롬프트를 만들기 위해서는 + 추가 버튼을 클릭합니다.

  1. 프롬프트 추가 및 작성 5-1. 프롬프트 이름을 입력합니다. 5-2. 프롬프트 설명을 입력합니다(프롬프트의 용도를 쉽게 구분하기 위한 설명으로, 실제 실행에는 영향을 주지 않습니다). 5-3. 시스템 프롬프트를 입력합니다. 시스템 프롬프트는 LLM의 동작을 설정하는 데 사용됩니다. 예를 들어, 모델에게 특정 페르소나를 부여하거나, 대화 전반에서 모델이 따라야 하는 행동 지침을 정의할 수 있습니다.

    ⚠프롬프트 내에서 동적 인풋 사용 시에는 중괄호 {}를 반드시 사용해야 합니다.

    5-4. 유저 프롬프트 입력 유저 프롬프트에서는 LLM이 응답해야 할 요청이나 질문을 작성합니다. 쿼리 및 질문 작성이 권장됩니다. 입력하지 않아도 무방합니다.

    ⚠프롬프트 내에서 동적 인풋 사용 시에는 중괄호 {}를 반드시 사용해야 합니다.

    5-5. 동적 인풋 추가 프롬프트 내에서 동적으로 값이 변하는 변수를 할당할 수 있습니다.

동적 인풋 추가하기

  1. 프롬프트 내에서 사용할 동적 인풋 항목명을 입력합니다.

  2. 해당 항목에 대입할 변수 값을 지정합니다. 동적 인풋에 할당할 수 있는 변수 값 종류에는 시스템과 앱 두 가지 옵션이 있습니다.

a. 시스템 변수 Alli 시스템과 연동되어 자동으로 값이 할당되는 입력입니다.

  • EMAIL, LANGUAGE 등 시스템에서 자동으로 제공되는 변수입니다.

b. 앱 변수

앱 내에서 직접 변수를 지정하고 값을 입력할 수 있는 옵션입니다.

  • 입력값은 상황과 필요에 따라 자유롭게 할당 가능하며, 앱 내 대화 흐름에 따라 값이 변동될 수 있습니다.

앱 변수 추가하기

  1. 변수명을 입력합니다.

  2. 변수 유형을 선택합니다.

  • 대화: 대화 내에서만 해당 값이 저장되고 반영됩니다.

  • 유저: 대화 종료 후에도 해당 유저의 값이 저장되어 반영됩니다.

  1. 변수 종류를 선택합니다. (총 11종)

  1. 저장 버튼을 클릭합니다.

  2. 필요 시 토큰 자르기 ON/OFF 옵션을 선택합니다. 긴 토큰을 가진 변수는 ON으로 설정하는 것을 권장합니다.

2. 앱 프롬프트 관리하기

  1. 대시보드 내 설정 > 프롬프트 관리 > 앱 페이지로 이동합니다.

이 때 앱 페이지에 접근할 수 있는 멤버의 권한은 앱 마켓 또는 앱 관리 접근 권한을 따라갑니다.

  1. 뷰어 혹은 편집 권한을 가지고 있는 공개된 앱과 작성 중인 모든 대화형 앱이 목록에 표시됩니다.

3. 권한에 따른 앱 프롬프트 관리 동작

앱 프롬프트 관리 기능은 사용자가 해당 앱에 대해 뷰어 권한을 가지고 있는지, 편집자 권한을 가지고 있는지에 따라 동작 방식이 달라집니다.

앱에 권한이 없는 멤버는 프롬프트 관리 화면에서 해당 앱을 확인할 수 없습니다.

반대로, 앱에 열람 또는 편집 권한이 있는 멤버는 프롬프트 관리 화면에서 앱이 목록에 표시됩니다.

바로가기 버튼 클릭 시

바로가기 버튼을 클릭하면, 해당 앱에서 어떤 프롬프트가 실제로 어떤 노드에서 사용되고 있는지를 앱 편집 화면에서 확인할 수 있습니다.

앱에 대한 편집 권한이 없는 경우에는 열람만 가능합니다.

앱에 대한 편집 권한이 있는 경우에는 앱을 ‘작성 중’ 상태로 변경하여 바로 편집할 수 있습니다.

앱 상세 프롬프트 클릭 시

앱을 클릭하여 앱 프롬프트 화면에 진입하면, 해당 앱에서 작성된 프롬프트 목록이 표시됩니다.

  • 앱에 대한 편집 권한이 없는 경우(열람 권한만 있는 경우) 프롬프트를 직접 삭제하거나 수정할 수는 없지만, 다른 앱으로 복사하거나 프로젝트에서 공유할 수 있도록 복사할 수는 있습니다.

  • 앱에 대한 편집 권한이 있는 경우에는 프롬프트를 새로 작성하거나 삭제 및 수정할 수 있습니다. 다만 실제 앱 내에서 사용 중인 프롬프트는 직접 변경할 수 없습니다. 이 경우에는 프롬프트를 복사한 후 수정하는 방식으로 진행해야 합니다.

프로젝트 프롬프트로 복사하기

앱에서 사용 중이던 프롬프트를 프로젝트 내 모든 앱에서 공유할 수 있는 프로젝트 프롬프트로 복사하여 수정해보겠습니다.

  1. 프로젝트 프롬프트 복사하기 버튼을 클릭합니다.

  1. 복사된 프롬프트에 필요한 내용을 추가로 수정할 수 있습니다. 수정하지 않고 그대로 두어도 무방하며, 완료되면 저장 버튼을 클릭합니다.

  1. 앱에 종속되어 있던 프롬프트가 프로젝트 프롬프트로 단일 프롬프트 형태로 복사된 것을 확인할 수 있습니다. 이렇게 복사된 프롬프트는 하나의 앱이 아닌 여러 앱에서 공통으로 사용할 수 있으며, LLM 실행 노드의 프롬프트 드롭다운 리스트에서 선택하여 활용할 수 있습니다.

앱 프롬프트로 복사하기

앱에서 사용 중이던 프롬프트를 다른 앱으로 복사하여 공유할 수 있도록, 앱 프롬프트 복사 기능을 사용해 보겠습니다.

  1. 앱 프롬프트 복사하기 버튼을 클릭합니다.

  1. 프롬프트를 복사할 대상 앱을 선택합니다. 예를 들어, 테스트앱2에 있는 테스트1 프롬프트를 NEW앱으로 복사해 보도록 하겠습니다.

  1. 복사 버튼을 클릭합니다.

  1. 선택한 NEW앱테스트1 프롬프트가 복사되어 있는 것을 확인할 수 있습니다

  • 이때, 선택한 앱에 편집 권한이 있어야만 복사가 가능하며, 편집 권한이 없는 경우에는 불가능하다는 안내 메시지가 표시됩니다.

Last updated