보안 · 데이터

데이터는 어디에서 처리되고, 무엇이 전송되나요?

링클비 엔진은 직접 운영하는 서버에서 동작합니다. 요청은 그 서버에서 사용 중인 AI 제공사로 직접 전송되며, 링클비 서버를 거치지 않습니다.

진단기

진단기는 단일 Python 파일로 제공되며, 표준 라이브러리만 사용합니다. 네트워크 통신 코드는 포함하지 않습니다. 진단 중 AI API 호출이나 사용 정보 자동 전송이 발생하지 않습니다. AI 제공사의 API 응답을 그대로 저장한 로그도 분석할 수 있습니다. 결과 파일에는 숫자·모델 이름·시각과 해시만 남습니다(--hashify). 해시 변환 결과에 원문이 포함된 경우 파일을 저장하지 않습니다. --share 옵션으로 생성한 공유용 요약 파일에는 본문·파일명·키 없이 숫자만 들어갑니다.

링클비 엔진

직접 운영하는 서버에서 동작하고, 요청은 그 서버에서 AI 제공사로 직접 전송됩니다. 이전 응답과 해당 응답을 생성한 요청 본문은 고객사 서버에 저장하며, 고객사별로 분리합니다. 문서 ID와 항목 종류는 해시로 저장합니다.

한 고객사 안에서는 문서 키마다 나뉩니다. 여러 최종 고객의 요청을 한 계정에서 처리하는 경우, 연동 시 고객별 분리 설정이 필요합니다. X-Linklbee-Key에 최종 고객 ID를 넣어 주세요(예: {고객_ID}:{문서_ID}). 최종 고객 식별자를 지정하지 않으면, 같은 계정 안에서 서로 다른 최종 고객의 요청에 이전 응답이 초안으로 재사용될 수 있습니다. 재사용은 같은 고객사의 응답 안에서만 일어나고, 고객사별 저장소가 분리되어 다른 고객사의 응답이 섞이지 않습니다.

API 키

폐쇄망 운영형에서는 링클비 API 키를 그 서버에서 발급하고 SHA-256만 남깁니다. AI 제공사의 API 키는 링클비가 저장하지 않고 요청과 함께 해당 제공사로 전달합니다. 링클비 API 키는 AI 제공사로 전송되지 않습니다.

폐쇄망 운영형클라우드 관리형
엔진 실행 위치직접 운영하는 서버직접 운영하는 서버
관리 위치그 서버의 명령줄링클비 대시보드
링클비에 전송되는 데이터사용자가 확인 후 내보내는 월간 사용량 보고 파일사용량 통계와 운영 메타데이터(아래 항목 참조)
API 키 발급직접 운영하는 서버에서링클비에서

클라우드 관리형에서 전송되는 데이터

가는 길은 하나입니다. 링클비 대시보드 서버가 엔진의 사용량 응답을 하루 한 번 읽어 갑니다(엔진이 먼저 보내지 않습니다). 엔진이 읽는 것은 사용량 장부뿐이며, 저장된 요청·응답 본문 파일은 읽지 않습니다. 「저장」은 링클비 쪽 대시보드 기준입니다.

항목포함되는 정보예시전송 시점저장 여부
조회 구간시작·끝 날짜 · 단가표 날짜 · 고객사 식별자(문자열 ID)2026-10-01 ~ 10-28 · 단가표 2026-10-25하루 한 번 + 설정 화면 열 때날짜만
사용량 합계모델 이름 · 경로(기존 응답 재사용 / 정확 일치 / 변경 부분만 / 재호출 / 전체 / 대상 아님) · 갈래(링클비 / 기준 요청 / 대상 아님) · 요청 수 · 입력/출력 토큰 · 캐시 읽기/쓰기 토큰 · 오디오·이미지 토큰 · 답 토큰 수 · 금액(단가표 기준)gpt-4o-mini · 변경 부분만 · 링클비 · 1,204건 · $18.42하루 한 번 + 화면저장(일별 요약, 모델·경로·갈래별 한 줄)
문서별 통계문서 키의 해시(12자, 원문 아님) · 갈래 · 모델 · 요청 수 · 토큰 · 금액 · 답 토큰3f9a1c0e…하루 한 번 + 화면해시는 저장 안 함 — 문서 수와 범위 계산용 합계만
비용 라벨 합계고객이 키나 요청에 붙인 라벨 이름 · 모델 · 요청 수 · 토큰 · 금액"billing-team"하루 한 번 + 화면저장 안 함(화면 표시만)
기준 요청 설정적용 중인 기준 요청 비율 · 맞춘 값인지 기본값인지 · 다음 후보 · 한 줄 사유 · 이 구간의 기준 요청 수0.10 · 기본값하루 한 번 + 화면비율만 저장
절감 설정 상태자동 절감 설정 이름별 켜짐/꺼짐 · 결정 이력 · 그 설정이 아낀 금액 추정 · 고쳐 쓰기만 끄는 스위치(전체 재작성 금지)의 켜짐/꺼짐 · 제안 카드(설정 이름 · 금액 · 고객의 답) · 자동 조정 요약접두 정규화 켜짐 · 채우기 제안 $12.3하루 한 번 + 화면저장 안 함
추가 지시문설정 화면에 직접 입력한 캐시 최소 길이 채우기 문구(있을 때만)(고객이 쓴 글)하루 한 번 + 화면엔진 서버에 저장(고객사 설정 파일) · 대시보드는 표시만 — 본문이 오가는 유일한 예외
낭비 집계진단 항목별 건수·금액 집계(재시도 · 길이 상한 중단 · 접두 불안정 · 캐시 최소 길이 · 캐시 적중률 · 공통 접두 · Flex)재시도 12건 $0.41하루 한 번 + 화면저장 안 함
캐시 적중률 요약 · 비용이 발생한 빈 응답비율 · 판정 행 수 · 건수 · 금액23.4%하루 한 번 + 화면저장 안 함
안내 문장엔진이 숫자 옆에 적는 설명 문장(산정 기준 · 주의) — 영문 고정 문장, 고객 데이터 없음"cache-read input tokens / input tokens …"하루 한 번 + 화면저장 안 함
읽어 간 기록읽어 간 시각 · 성공 여부 · 행 수 · 실패 사유2026-10-28 00:10 UTC · 성공읽어 갈 때마다대시보드가 기록

숫자와 이름, 그리고 엔진이 쓰는 안내 문장뿐입니다.

전송 시점: 사용량 데이터는 하루 한 번 전송합니다. 설정 화면을 열면 추가로 조회하며, 이때 조회한 데이터는 저장하지 않습니다.

전송하지 않는 것: 요청·응답 본문 · 프롬프트 · API 키(해시도 없음) · 최종 고객 ID · 고객사 이름 · 문서 원문과 문서 이름 · 요청 시각(행 단위 시각 없음, 구간 합계만).
다만 설정 화면에 직접 입력한 추가 지시문은 링클비 관리 화면을 거쳐 엔진에 저장되며, 설정 조회 시 관리 화면에 다시 표시됩니다 — 이것 하나가 예외입니다. 대시보드 설정의 「앞에 붙이는 고정 문구」 칸에 적은 내용은 고객 엔진의 설정 파일에만 저장되며 대시보드 데이터베이스에는 저장되지 않습니다.

폐쇄망 운영형에서는 위 전부가 직접 운영하는 서버 안에만 남습니다. 링클비에는 사용자가 확인 후 직접 내보내는 월간 보고 파일만 전달됩니다(사람이 읽을 수 있는 JSON). 그 파일에 들어가는 것은 기간 · 라이선스 참조 · 엔진 판 · 단가표 날짜 · 규모(적격 문서 수 · 기준 요청 문서 수와 비율 · 요청 수) · 두 갈래의 토큰당 비용 · 경로별 요청 수·비용·절감액 · 청구 기준(절감액과 95% 하한) · 청구서 대조용 모델별 합계 · 무결성 정보(장부 줄 수 · 해시 사슬 · 읽은 파일 목록)와 서명입니다. 본문 · 문서 이름 · 키 · 요청 시각 · 고객사 이름은 없습니다.

직접 확인해 주세요

로컬 처리 구조와 공개 소스를 확인할 수 있습니다.

# 진단기 파일 안에 네트워크 관련 문자열이 몇 줄 있는지 셉니다 grep -cE "ht[t]p|sock[e]t|url[l]ib" linklbee_scan.py 0

FAQ

연동 전에 자주 묻는 질문

응답 시간이 늘어나나요?

🧪 모의 AI 제공사 환경에서 측정한 링클비 엔진 자체 처리 시간(중앙값)은 그대로 보낼 때 +0.33ms, 전체를 다시 생성할 때 +4.8ms, 변경 부분만 생성할 때 +20.8ms입니다. AI 제공사의 응답 시간을 포함한 전체 응답 시간이 아니라 엔진이 더하는 시간입니다. 문서 ID 없이 문서를 자동으로 식별할 때 요청당 추가되는 처리 시간은 중앙값 3~9ms, p99 23ms 이하였습니다(저장된 이전 응답 1천~6천 건).

대상 호출의 스트리밍은 전체 응답을 완성한 뒤에 나가므로 첫 토큰 수신이 늦어집니다.

변경 부분 생성에 실패한 요청은 AI 제공사를 한 번 더 호출합니다. 해당 요청에는 추가 API 호출에 필요한 시간이 더해집니다.

요청이 링클비 서버를 거치나요?

아니요. 링클비 엔진은 직접 운영하는 서버에서 동작하고 요청은 그 서버에서 AI 제공사로 직접 전송됩니다. 사내 LLM 게이트웨이를 요청 전달 대상으로 지정할 수도 있습니다. 기본 수신 주소는 127.0.0.1이고, 자체 TLS가 없으므로 다른 서버에서 접근해야 한다면 엔진 앞단에 TLS를 지원하는 리버스 프록시를 구성해 주세요.

응답 저장과 처리 기록을 비활성화할 수 있나요?

변경 부분 생성은 이전 응답을 활용하므로 응답 저장이 필요합니다. 저장 위치는 그 서버 디스크의 디렉터리 한 곳이고 지우면 사라집니다. 현재 요청 처리 경로 기록만 별도로 비활성화하는 설정은 제공하지 않습니다.

사내 인프라에 설치할 수 있나요?

네. Python 3.9 이상에서 표준 라이브러리만 사용하며, 추가 Python 패키지를 설치할 필요가 없습니다(pip install 없음). 폐쇄망 운영형에서는 링클비 API 키 발급, 과거 로그 적재, 절감 보고까지 전부 그 서버의 명령줄에서 합니다.

프롬프트 캐싱을 이미 쓰고 있는데요.

프롬프트 캐싱을 사용 중이어도 추가 개선 항목을 확인할 수 있습니다. 캐시 최소 토큰 수를 충족하지 못하는 요청, 접두부가 매번 달라 캐시가 적용되지 않는 요청, 실제 캐시 적중률을 계산합니다.

변경 부분 생성으로 줄이는 것은 출력이고, 이 실험에 적용한 요율에서는 출력 토큰 단가가 입력 토큰 단가보다 높습니다. 측정에 쓴 단가표(claude-sonnet-5-5, 2026-10-08 공식 단가 확인)에서 출력 단가는 입력의 5배이고, 캐시 할인은 입력에만 있습니다.

연동을 해제하려면 어떻게 하나요?

엔진 주소(base_url)와 링클비 요청 헤더를 원래 설정으로 되돌리면 연동을 해제할 수 있습니다. 요청 형식은 바꾸지 않습니다.