Omni에 앱 연결하기
비즈니스 인텔리전스 플랫폼인 Omni에 앱을 연결해 데이터 팀이 Omni에서 정의한 지표로 대시보드와 리포트를 만드세요.
Omni는 시맨틱 레이어(semantic layer)를 중심으로 만들어진 비즈니스 인텔리전스(BI) 플랫폼입니다. 데이터 팀이 모델(model), 토픽(topic), 디멘션(dimension), 메저(measure)를 한 번 정의하면 모든 쿼리가 그 정의를 기준으로 실행됩니다. Omni 커넥터를 사용하면 Lovable 앱이 이렇게 정의된 지표를 쿼리할 수 있으므로, 팀이 이미 신뢰하는 숫자로 대시보드와 리포팅 도구를 만들 수 있습니다.
Omni는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.
Omni를 사용하면 앱에서 다음과 같은 작업이 가능합니다.
- 팀이 정의한 모델과 토픽, 그리고 각 토픽 안의 디멘션과 메저 찾기
- 필드, 필터, 정렬, 행 수 제한을 골라 토픽에 쿼리 실행하기
- 차트와 표에 바로 쓸 수 있는 JSON 행으로 결과 읽기
- 느린 웨어하우스 쿼리가 끝날 때까지 기다리기
- 저장된 Omni 워크북 쿼리가 커스텀 SQL을 쓰지 않는다면 그 쿼리 구성을 앱에서 재사용하기
데이터 팀이 이미 관리하는 지표 정의가 앱에 필요할 때 Omni를 사용하세요. Omni가 그 정의로부터 웨어하우스 SQL을 생성하므로 앱에서 계산 로직을 다시 만들 필요가 없습니다.
주요 활용 사례 및 예시 앱
Omni로 다음과 같은 내부용·고객용 리포팅 도구를 만들 수 있습니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 매출 대시보드 | Omni를 사용해서 Order Items 토픽의 메저로 지역별 월 매출 대시보드를 만들어줘. | 팀의 지표를 앱에서 차트로 보여 줍니다. 앱이 매출 메저를 월별, 지역별로 쿼리하고 결과를 차트로 그립니다. |
| 지표 탐색기 | Omni를 사용해서 내가 토픽을 고른 다음 쿼리할 디멘션과 메저를 선택할 수 있는 탐색기를 만들어줘. | 연결로 접근할 수 있는 데이터를 팀이 둘러보게 합니다. 앱이 Omni가 노출하는 토픽과 필드를 나열하고 이를 바탕으로 선택기를 만듭니다. |
| 고객 사용량 페이지 | Omni를 사용해서 Accounts 토픽에서 계정별 사용량 합계를 보여 주는 고객용 페이지를 만들어줘. | 고객에게 각자의 수치를 보여 줍니다. 앱이 로그인한 고객의 계정으로 각 쿼리를 필터링합니다. 모든 쿼리가 같은 Omni 사용자로 실행되므로, 각 고객이 볼 수 있는 행은 Omni가 아니라 앱이 제어해야 합니다. |
| 주간 지표 요약 | Omni를 사용해서 이번 주 핵심 메저를 지난주와 비교하는 주간 요약 페이지를 만들어줘. | 시간에 따른 변화를 추적합니다. 앱이 두 기간에 대해 같은 메저를 실행하고 차이를 보여 줍니다. |
| 지역별 성과표 | Omni를 사용해서 지역별 매출 순위를 매기고 목표에 못 미친 지역을 강조 표시하는 성과표를 만들어줘. | 지역별 성과를 비교합니다. 앱이 매출 메저를 지역별로 그룹화하고 결과를 정렬합니다. |
| 지표 질문 앱 | Omni를 사용해서 팀원이 "지난 분기 West 지역 매출은 얼마였어?" 같은 질문을 하면 Omni 토픽에서 답을 가져오는 앱을 만들어줘. | 지표에 관한 질문에 일상 언어로 답합니다. 앱이 각 질문을 알맞은 토픽, 필드, 필터를 사용하는 쿼리로 바꿉니다. |
Omni 연결 작동 방식
Lovable은 커넥터 게이트웨이를 통해 Omni를 호출합니다. 게이트웨이는 API 키를 안전하게 저장하고 모든 요청에 키를 덧붙입니다. 앱 코드에는 Omni 자격 증명이나 Omni 호스트가 필요하지 않습니다.
쿼리는 개인 토큰(personal token)을 만든 Omni 사용자로 실행됩니다. 그 사용자의 모델 접근 권한과 행 수준 제한은 게시된 앱을 통한 사용을 포함해 연결을 쓰는 모든 사람에게 적용됩니다. 커넥터는 앱 사용자마다 따로 Omni에 로그인시키지 않습니다.
앱에 필요한 모델에만 접근할 수 있는 전용 Omni 사용자의 키를 사용하세요. 예를 들어 영업 대시보드에는 영업 모델로 접근이 제한된 사용자를 써야 합니다. 서로 다른 데이터가 필요한 팀에는 사용자와 연결을 따로 만드세요.
Lovable은 admin을 포함해 어떤 Omni 사용자의 개인 토큰이든 받아들입니다. admin의 토큰은 사용하지 마세요.
커넥터 게이트웨이는 탐색과 쿼리를 위한 Omni API 호출만 전달합니다. 그 밖의 Omni 엔드포인트는 모두 거부하므로, 연결을 통해 Omni의 대시보드, 워크북, 모델, 사용자를 만들거나 변경하거나 삭제할 수 없습니다. 커스텀 SQL을 포함하거나 Omni에 쿼리용 워크북을 만들도록 요청하는 쿼리도 거부합니다.
프로젝트 채팅에서 Lovable은 승인을 요청하지 않고 이런 호출을 실행합니다. 쿼리에 Lovable이 읽기 전용인지 확인할 수 없는 옵션이 포함된 경우에만 먼저 승인을 요청합니다. 프로젝트 채팅에서 커넥터 작업 승인하기를 참고하세요.
Omni 연결 방법
Omni 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자 설정의 기본값이 No one이기 때문입니다.
서로 다른 API 키로 Omni 연결을 여러 개 만들 수 있습니다. 접근 수준이나 Omni 인스턴스를 분리할 때 유용합니다.
연결이 만들어지면 연결을 사용할 프로젝트에 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 요구사항
Omni를 연결하기 전에 다음을 준비하세요.
*.omniapp.co호스트의 Omni 인스턴스 또는*.playground.exploreomni.dev호스트의 플레이그라운드 인스턴스. 커넥터는 다른 호스트를 받아들이지 않습니다- Restricted Querier 이상의 역할을 갖고 모델 접근 권한이 앱에 필요한 범위와 일치하는 Omni 사용자, 그리고 그 사용자의 개인 토큰(1단계 참고)
- Lovable 워크스페이스에서 연결을 만들 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
Omni 라이선스와 웨어하우스 컴퓨팅 비용은 Lovable 청구와 별개입니다. 최신 결과가 필요한 쿼리는 웨어하우스에서 실행되며 웨어하우스의 컴퓨팅 자원을 사용하므로, 필터와 행 수 제한을 추가해 비용을 줄이세요. Omni는 기본적으로 키당 분당 60회의 API 요청을 허용합니다. 앱이 실행하는 모든 쿼리가 이 한도에 포함되며, 느린 쿼리 하나가 요청을 최대 5회까지 사용할 수 있습니다.
1단계: Omni API 키 만들기
Omni는 두 종류의 API 키를 제공합니다. 개인 토큰을 사용하세요. 개인 토큰은 토큰을 만든 사용자로 쿼리를 실행하므로, 접근이 제한된 전용 사용자를 쓰면 앱이 접근할 수 있는 범위가 제한됩니다. 조직 키(organization key)는 Organization Admin 권한을 가지며 어떤 Omni 사용자로든 쿼리를 실행할 수 있으므로, Connect를 클릭하면 Lovable이 거부합니다.
Omni 사용자 선택
전용 사용자를 쓰려면 Omni 조직 admin에게 사용자를 만들어 달라고 요청합니다. 사용자에게 Restricted Querier 이상의 역할과 앱에 필요한 모델에 대한 접근 권한만 줍니다. 그런 다음 앱이 가져야 할 접근 권한을 가진 사용자로 Omni에 로그인합니다. Omni의 권한 문서를 참고하세요.
개인 토큰 만들기
프로필 메뉴를 열고 Manage account를 선택한 다음 Generate token을 클릭합니다. 토큰을 복사합니다. 이 옵션이 없다면 Omni 조직 admin이 먼저 Settings → API access → Personal tokens를 활성화해야 합니다.
Omni 호스트 확인
Omni 호스트는 Omni에 로그인했을 때 브라우저 주소 표시줄에 보이는 호스트 이름에서 https://와 경로를 뺀 값입니다. 예를 들어 yourcompany.omniapp.co입니다.
API 키는 비밀번호처럼 작동합니다. 안전하게 보관하고 Lovable의 연결 양식에만 붙여 넣으세요. 프롬프트나 채팅 메시지, 앱 코드에는 넣지 마세요.
자세한 내용은 Omni 문서 API authentication과 API base URL을 참고하세요.
2단계: Omni를 Lovable에 연결
연결 양식을 열고 1단계에서 준비한 값을 입력합니다.
Connectors에서 Omni 열기
Connectors를 열고 Omni를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾는 위치를 참고하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 접을 수 있는 Details, Configure connection, Sharing 섹션으로 나뉩니다.
연결 이름 지정
Details 아래에 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다(예: Omni Sales). 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다. Omni 사용자의 접근 수준을 드러내는 이름을 쓰세요.
자격 증명 입력
Configure connection 아래에 다음 값을 입력합니다.
- Omni host: 1단계에서 확인한 소문자 호스트 이름입니다. 예를 들어
yourcompany.omniapp.co입니다.https://, 경로, 대문자가 포함된 값은 양식에서 거부됩니다 - API key: 1단계에서 만든 개인 토큰입니다
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.
접근 권한이 있는 모든 사람은 같은 Omni 사용자로 Omni를 쿼리합니다. 자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Omni 인스턴스에서 키를 확인하고 개인 토큰인지 검증합니다.
연결 테스트에 성공했다고 모델에 접근할 수 있다는 뜻은 아닙니다. 연결을 프로젝트에 링크한 뒤 Lovable에게 사용 가능한 모델 목록을 보여 주고 앱에 필요한 모델 하나로 쿼리를 실행해 달라고 요청하세요. 모델이 보이지 않으면 Omni admin에게 사용자의 모델 접근 권한을 확인해 달라고 요청하세요.
연결되면 프로젝트에서 빌드하는 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 Omni에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한에 따라). 그러면 Lovable 앱이 빌드 중에도, 게시한 뒤에도 모델과 토픽을 찾고 팀의 지표 정의를 사용하는 쿼리를 실행할 수 있습니다.
키가 바뀌면 Lovable에서 연결을 열고 Configure connection 아래의 Update를 클릭해 키를 교체하세요.
제한 사항
Omni로 빌드할 때는 다음 제한을 염두에 두세요.
- 지원되는 호스트. 호스트는
.omniapp.co또는.playground.exploreomni.dev로 끝나야 합니다. 다른 호스트는Must be a bare lowercase *.omniapp.co or *.playground.exploreomni.dev hostname (no https:// or path)오류와 함께 거부됩니다. - 공유 ID. 커넥터는 사용자별 Omni 로그인을 지원하지 않으며 앱 사용자마다 데이터를 자동으로 제한하지도 않습니다. 각 연결은 연결에 링크된 모든 프로젝트가 공유하는 단일 Omni 사용자를 나타냅니다.
- 대시보드 임베드. 이 구성은 앱 자체 차트에 쓸 쿼리 결과를 반환합니다. Omni 대시보드나 워크북을 앱에 임베드하지는 않습니다.
- 커스텀 SQL과 워크북. 커넥터는 커스텀 SQL을 포함하거나 Omni에 쿼리용 워크북을 만들도록 요청하는 쿼리를 거부합니다. 커스텀 SQL 대신 팀이 Omni에서 정의한 토픽, 디멘션, 메저를 사용해 달라고 Lovable에게 요청하세요.
Omni 연결 관리
연결은 Connectors에서 관리합니다. **Omni**를 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 사용할 수 있게 두고 특정 프로젝트의 Omni 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 링크 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거합니다. 삭제는 영구적입니다. 링크된 모든 프로젝트에서 자격 증명이 제거되고, Omni를 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.