데이터 위키¶

데이터 페이지의 위키 탭에는 앱이 대신 써 주는 문서가 모입니다. 라이브러리를 가리키면 색인과 개요, 그리고 문서들을 가로질러 발견한 개념과 대상마다 한 편씩을 만들어 냅니다. 그 문서의 모든 서술에는 근거가 된 원본 문서가 인용으로 붙습니다. 위키 문서는 라이브러리를 대신하는 것이 아니라 라이브러리로 들어가는 입구입니다.

핵심은 결과가 쌓인다는 점입니다. 검색은 물어볼 때마다 문서를 처음부터 다시 읽지만, 위키 문서는 한 번 쓰고 그 뒤로는 관리됩니다. 앱이 이미 정리해 둔 내용이 정리된 채로 남습니다.

제공 범위¶

위키는 Backend.AI GO v1.12.0부터 정식 제공되는 데이터 허브 안에 있습니다. 페이지 단위 정책 제어는 데이터 허브를 보세요. 아래 설명은 라이브러리에 문서가 이미 있고, 문서를 만들거나 다시 쓸 모델을 사용할 수 있다고 가정합니다. 이미 만들어진 위키 문서를 읽는 일은 모델이 없어도 가능합니다.

위키 문서란¶

위키 문서는 고유한 핸들(D42)을 가진 평범한 문서이고, 직접 넣은 문서와 나란히 저장됩니다. 그냥 넘겨도 되는 구현 세부가 아닙니다. 위키 문서가 검색되고, 인용될 수 있고, 변경 이력을 갖고, 채팅 답변의 근거가 될 수 있는 이유가 전부 여기에서 나옵니다.

직접 넣은 문서와 다른 점은 두 가지입니다.

• 라이브러리 목록에는 나오지 않습니다. 생성된 문서는 파이프라인의 결과물이지 여러분이 정리해 넣은 항목이 아니므로 위키 탭에만 머무릅니다. 검색은 여전히 찾아내고, 근거 주입도 그대로 씁니다.
• 본문을 직접 고치지 않습니다. 본문은 파이프라인이 관리합니다. 내용이 틀렸거나 빠졌다면 고쳐야 할 것은 그 문서가 근거로 삼은 원본입니다. 원본 문서의 카드에 메모를 남기면 다음번에 다시 쓸 때 반영됩니다.

문서 종류는 네 가지입니다.

위키 만들기¶

비어 있는 위키 탭에는 동작이 하나 있습니다. 무엇을 근거로 만들지 고르고 위키 생성을 누르세요.

• 전체 문서는 라이브러리 전체를 씁니다. 범위를 지정하지 않은 검색과 마찬가지로 민감 컬렉션은 빠집니다.
• 컬렉션 하나를 고르면 그 컬렉션만 씁니다. 여기서 민감 컬렉션을 지정하는 것은 허용됩니다. 여러분이 직접 지정했기 때문입니다. 이때 생성된 문서는 같은 컬렉션에 들어가 원본과 같은 경계 안에 머무릅니다.

생성은 백그라운드로 돌아가고, 변환 작업과 같은 진행 표시줄에 위키 작업으로 표시됩니다. 한 번의 실행에는 상한이 있습니다. 큰 주제부터 최대 80편까지 씁니다. 다룰 주제가 그보다 많으면 몇 개가 남았는지 진행 표시줄의 안내 문구로 알려 주고, 탭 상단에 남은 개수가 적힌 이어쓰기 버튼이 나타납니다. 이어쓰기는 실행할 때마다 아직 쓰지 않은 주제를 다음 묶음만큼 새로 쓰고, 이미 있는 문서는 건드리지 않습니다. 남은 개수가 0이 될 때까지 누르면 라이브러리가 아무리 커도 전체를 다 다룹니다. 아주 큰 라이브러리에는 상한이 하나 더 있습니다. 한 번의 실행은 문서를 최대 20,000개까지 읽습니다. 라이브러리가 그보다 크면 탭에 일부만 다뤘다는 안내가 표시됩니다. 읽기 상한 밖의 문서는 위키에 아예 나타날 수 없기 때문입니다.

모델이 없으면 아무것도 생성되지 않습니다. 문서를 쓰는 일은 모델 호출이므로, 사용할 모델이 없으면 생성 버튼이 비활성화되고 그 이유가 표시됩니다. 모델이 없는 환경에서 위키 탭이 잃는 것은 이 한 가지뿐이고, 이미 만들어진 위키를 읽는 일은 언제나 가능합니다.

위키 읽기¶

왼쪽 레일에는 모든 문서가 개요(색인과 개요), 개념, 대상 순으로 묶여 나오고, 제목이나 핸들로 찾을 수 있는 검색 상자가 있습니다. 색인 문서도 다른 문서와 똑같이 목록에 있고, 한 번 열어 볼 만합니다. 레일이 조립한 목록이 아니라 파이프라인이 직접 쓴 위키 자신의 목록이기 때문입니다.

문서 본문은 가운데에 열립니다. 본문 속 인용은 링크입니다.

• 다른 위키 문서를 가리키는 인용은 탭 안에서 그 문서를 엽니다. 위키를 읽는다는 것이 바로 이것입니다.
• 여러분이 넣은 문서를 가리키는 인용은 데이터 허브의 상세 서랍을 엽니다. 거기서 카드와 변환된 본문, 변경 이력을 볼 수 있습니다. 그 순간부터는 다시 라이브러리입니다.
• 아무 문서에도 닿지 않는 인용은 링크가 아니라 흐린 글자로 표시됩니다. 숨기지 않고 그대로 알립니다. 인용을 조용히 지워 버리면 정작 의심해야 할 지점이 가려집니다.

제목 아래에는 몇 건의 자료를 근거로, 어떤 모델이, 언제 썼는지가 한 줄로 나옵니다.

문서 옆 패널¶

오른쪽 패널은 그 문서가 무엇으로 이루어졌는지 보여 줍니다.

• 출처. 그 문서가 인용한 원본들이고, 각각 눌러서 열 수 있습니다. 문서가 쓰인 뒤에 바뀐 출처에는 표시가 붙습니다.
• 이 문서를 인용한 문서. 몇 편이 이 문서를 인용하는지 항상 보여 주고, 어떤 문서인지는 요청할 때 확인합니다. 묻지도 않은 질문에 답하려고 모든 문서를 읽어 두는 것은 아무도 원하지 않는 일이라 그렇습니다.
• 생성 정보. 문서 종류, 쓰인 시각, 사용한 모델.
• 이 문서 다시 쓰기. 현재 인용을 근거로 이 문서 한 편만 다시 씁니다.

최신 상태 유지하기¶

문서를 쓴 뒤에도 원본은 바뀝니다. 위키는 조용히 낡아 가는 대신 그 사실을 알립니다.

해결하는 방법은 두 가지이고 규모가 다릅니다.

• 이 문서 다시 쓰기는 한 편만 다시 씁니다. 갱신 필요 배지가 요구하는 것이 이것입니다.
• 위키 갱신은 증분 방식입니다. 마지막 실행 이후 추가되거나 바뀐 문서를 살펴 그것을 인용한 문서를 순위와 상관없이 다시 씁니다. 이어쓰기로 만든 문서도 똑같이 관리됩니다. 새로 하나의 주제를 이룰 만한 것이 생겼으면 문서를 새로 쓰고, 색인을 다시 만듭니다. 아무것도 바뀌지 않은 문서는 건드리지 않습니다. 한 번에 다 쓰지 못할 만큼 영향받은 문서가 많으면 남은 수를 알려 주고, 다음 갱신이 이어받습니다.
• 이어쓰기는 계획된 주제 중 아직 문서가 없는 것이 남아 있는 동안 표시됩니다. 문서를 새로 추가하기만 하고 기존 문서는 절대 다시 쓰지 않으므로, 큰 라이브러리를 묶음 단위로 채워 나가는 동작입니다.
• 다시 생성은 모든 문서를 처음부터 다시 씁니다. 옆에 있는 갱신보다 훨씬 큰 동작이라 먼저 확인을 받습니다. 잃는 것은 없습니다. 각 문서의 이전 내용은 그 문서의 변경 이력에 남습니다.

다시 쓰는 도중에 그 문서의 원본을 편집하면 여러분의 버전이 이깁니다. 진행 중이던 초안은 버려지고, 탭이 그 사실을 알려 줍니다. 둘 중 하나를 말없이 남기지 않습니다.

문서가 만들어지지 않을 때¶

실패가 아니라 상태로 보고되는 결과가 세 가지 있습니다.

• 사용할 모델이 없음. 실행이 즉시 멈추고 아무것도 쓰지 않습니다.
• 인용할 것이 남지 않음. 주어진 원본으로 근거를 댈 수 없는 서술만 나왔다면 그 문서는 쓰지 않고 거부합니다. 아무도 확인할 수 없는 서술은 문서가 없는 것보다 나쁘므로 일부러 이렇게 동작합니다.
• 쓰는 사이에 문서가 바뀜. 더 새로운 쪽을 남깁니다.

실패한 실행은 진행 표시줄에서 다시 시도할 수 있고, 실패했던 작업이 그대로 다시 실행됩니다.

검색과 채팅 속의 위키¶

위키 문서는 별도 설정 없이 데이터 허브의 나머지 기능에 그대로 참여합니다.

• 검색이 다른 문서와 함께 찾아냅니다. 개념을 검색해서 개념 문서를 찾는 것이 바로 이 기능의 목적입니다.
• 근거 주입이 채팅 답변에서 위키 문서를 인용할 수 있고, 출처 줄은 원본 문서를 가리킬 때와 똑같이 그 문서로 이어집니다.
• 에이전트 도구는 읽기 전용으로만 다룹니다. list_data는 라이브러리 목록과 마찬가지로 위키 문서를 열거하지 않고, write_data와 delete_data는 아예 거부합니다. 이 문서는 파이프라인이 관리하므로 모델이 자기 참고 자료를 고쳐 쓸 수는 없습니다.

내 컴퓨터에 남는 것¶

데이터 허브가 이미 로컬에 두는 것은 여기서도 그대로 로컬에 남습니다. 위키 문서는 현재 앱이 서빙 중인 모델이 씁니다. 로컬 모델이라면 작성 과정 자체가 컴퓨터 밖으로 나가지 않고, 클라우드 제공자를 설정해 두었다면 문서를 쓰는 데 쓰이는 원본 발췌가 다른 프롬프트와 마찬가지로 그 제공자로 갑니다. 그 밖에 위키에 대해 전송되는 것은 없으며, 생성된 문서는 여러분의 문서 옆에 저장됩니다.