제품 가이드

이 가이드가 다루는 것

이 장은 API 키 없이 따라 할 수 있습니다.

이 가이드는 계정 없이 누구나 오늘 사용할 수 있는 TAVONEL의 부분을 차례로 안내합니다. 근거·변경·관계를 갖춘 공개 Compiled World, 서명된 샘플 패키지, 키가 필요 없는 API 읽기, 개발자 파일, MCP 브리지입니다. 각 장은 어디를 누르는지와 화면이 어디서 멈추는지를 말합니다.

“완성된 Compiled World는 오늘 근거까지 전부 읽을 수 있습니다. 직접 가진 원문의 컴파일은 요금제 구매가 아니라 저희와 함께 설정합니다.”

참고 “내 자료의 연결과 컴파일은 상담 후 함께 설정합니다.”

위치Compiled World 살펴보기 (영문)이용 문의

TAVONEL이 만드는 것

이 장은 API 키 없이 따라 할 수 있습니다.

TAVONEL은 문서를 Compiled World로 컴파일합니다. 의미 객체, 객체 사이의 관계, 그리고 각 객체가 기대는 근거입니다.

근거는 페이지 하나와 그 페이지 위의 영역이며, 다이제스트로 원문 버전에 묶입니다. 근거가 없는 객체는 게시되지 않습니다.

컴파일은 후보를 만듭니다. 로그인한 세션에서 사람이 그것을 활성화하고, 답은 활성 버전에서만 나옵니다. 어떤 API 키도 후보를 활성화할 수 없고, 어떤 컴파일도 스스로를 활성화하지 않습니다.

참고 “Activation is always an explicit human decision.” 활성화는 언제나 사람이 명시적으로 내리는 결정입니다.

위치개념 (영문)Compiled World (영문)

공개 World 열기

이 장은 API 키 없이 따라 할 수 있습니다.

/explore는 Apple의 공개 SEC 공시로 컴파일한 읽기 전용 샘플 World입니다. 로그인 없이 열립니다.

1. /explore를 엽니다. 맨 위의 안내가 샘플과 그 원문을 수집한 날짜를 알려 줍니다.
2. Find a sample question 아래에서 준비된 질문 하나를 고르거나, 입력해서 질문을 거릅니다.
3. Retrieved source passage 아래의 답을 읽습니다. 검색이 고른 원문 영역의 전체 텍스트이며, 다시 쓴 글이 아닙니다.
4. 발췌 아래의 각 행은 원문 파일과 페이지를 알려 줍니다. 행을 고르면 그 페이지가 열립니다. 휴대폰에서는 Result와 Source로 발췌와 페이지를 오갑니다.

참고 “Prepared retrieval results from this artifact. Free-form AI queries are not running in this public demo.” 이 아티팩트에서 준비한 검색 결과이며, 이 공개 데모에서는 자유 형식 AI 질의가 실행되지 않습니다.

위치Compiled World 살펴보기 (영문)

근거 읽기

이 장은 API 키 없이 따라 할 수 있습니다.

원문 창은 발췌가 나온 페이지를 그 영역이 표시된 채로 보여 주고, 그 아래에 정확한 발췌를 보여 줍니다. 창의 머리글은 지금 보는 것이 원본 PDF인지, 그 페이지의 기준 렌더인지 알려 줍니다.

1. Source version은 영역이 묶인 문서의 버전을 가리킵니다. 문서와, 정제된 바이트의 sha256입니다.
2. Permanent evidence link는 이 근거의 주소이며, 복사해서 공유할 수 있습니다.
3. Open full evidence inspector는 객체를, 그것을 받치는 원문 영역과 함께 엽니다. 객체의 상태, 근거, 관계가 보입니다. 객체에 영역이 하나보다 많으면 Previous와 Next로 차례로 넘깁니다.

참고 “This is a quotation selected by retrieval, not an independently verified conclusion.” 검색이 고른 인용이며, 독립적으로 확인된 결론이 아니라는 뜻입니다.

위치Compiled World 살펴보기 (영문)개념의 근거 항목 (영문)

변경 보기

이 장은 API 키 없이 따라 할 수 있습니다.

Changes는 Apple의 2025 Form 10-K로 컴파일한 World를, 2026년 공시가 도착한 뒤의 같은 World와 나란히 둡니다.

1. /explore에서 Changes를 고릅니다.
2. 수치를 읽습니다. Objects reached와 Unchanged object identities가 있고, 그 아래에 추가·제거·제자리 재구성된 객체가 있습니다.
3. FILINGS THAT ARRIVED는 도착한 공시마다 그것을 읽은 페이지를 보여 주고, 원본 PDF나 그 기준 렌더를 엽니다.
4. HOW THIS WORLD WAS REACHED는 단계마다 추가·제자리 재구성·제거·변경 없음을 나열합니다.
5. Objects, relations and evidence as a list는 모든 객체에 AFFECTED 또는 UNCHANGED를 글자로 표시합니다.

이것은 이 샘플에 기록된 비교이며, 새 공시를 실시간으로 받는 피드가 아닙니다.

참고 “Both snapshots are complete compiles of the corpus as it stood, compared object by object. Every count below is measured from that comparison.” 두 스냅숏은 모두 그 시점의 코퍼스를 완전히 컴파일한 것이며, 객체 단위로 비교했습니다. 아래의 모든 수치는 그 비교에서 측정한 것입니다.

위치Changes (영문)

관계 보기

이 장은 API 키 없이 따라 할 수 있습니다.

Relations는 World를 컴파일된 객체와 객체 사이의 관계로 이루어진 그래프로 엽니다.

1. /explore에서 Relations를 고릅니다.
2. 객체를 선택합니다. Directly connected가 각 관계를 그 이름과 반대쪽 끝의 객체로 나열합니다.
3. 객체에 근거가 있으면 Open source evidence가 그것을 받치는 영역으로 데려갑니다.
4. Objects, relations and evidence as a list는 같은 그래프를 텍스트로 보여 줍니다. 시스템이 동작 줄이기를 요청하면 처음부터 열려 있습니다.

참고 그래프 아래의 줄은 World의 그래프 노드 가운데 몇 개가 화면에 있는지 알려 줍니다.

위치Relations (영문)

서명 패키지 검증

이 장의 일부 단계에는 API 키가 필요합니다.

/demo는 합성 원문 하나를 컴파일, 검토, 활성화를 거쳐 답과 서명된 내보내기까지 따라갑니다.

1. /demo를 열고 Signed export로 갑니다. 샘플 매니페스트에 대한 Ed25519 서명 확인 결과와 함께 매니페스트 스키마, 패키지 파일, 키, 서명된 페이로드 다이제스트가 보입니다.
2. Download the offline verifier를 누르면 tavonel-verify-export.mjs를 받습니다. /developer/channel.json이 내보내기를 확인하는 파일로 올려 둔 파일입니다.
3. GET /api/export/trust는 내보내기에 서명하는 키 기록을 공개하고, 서명자가 설정되지 않은 곳에서는 EXPORT_SIGNER_NOT_CONFIGURED로 거절합니다.
4. 검증기는 아카이브를 확인합니다. World의 아카이브를 내려받으려면 collections:download scope를 가진 API 키가 필요합니다.

참고 “A valid signature proves manifest integrity. It does not certify semantic quality, customer approval, or current activation status.” 유효한 서명은 매니페스트의 무결성을 증명합니다. 의미 품질, 고객의 승인, 현재 활성화 상태를 보증하지는 않습니다.

위치서명된 제품 경로 (영문)내보내기 (영문)CLI와 패키지 검증 (영문)

키 없이 API 호출

이 장은 API 키 없이 따라 할 수 있습니다.

/api의 API 레퍼런스는 Try it, with no key로 시작합니다. “Three unauthenticated reads, run from this page against TAVONEL. No signup, no credential, nothing that spends.” 이 페이지에서 TAVONEL을 상대로 실행하는 인증 없는 읽기 세 가지입니다. 가입도, 자격 증명도, 비용이 드는 일도 없습니다.

1. What TAVONEL can read는 GET /api/v1/capabilities를 실행합니다. 업로드 경로가 형식을 확인할 때 사용하는 것과 같은 목록입니다.
2. What is open right now는 GET /api/status를 실행합니다. 내 파일의 컴파일이 열려 있는지도 여기에 나옵니다.
3. The shape of an answer는 GET /reproducibility/sample-world를 실행합니다. 고정 샘플에서 객체, 근거, 원문 버전, 페이지, 영역을 돌려줍니다.
4. Integration recipes의 Recipe 2는 같은 읽기를 공개된 Python 스크립트로 합니다. 이 스크립트는 받은 바이트로 응답의 Content-Digest 헤더를 다시 계산합니다.

참고 “A deterministic product fixture, unsigned and labelled as such in its own disclosure field. Build against the shape; do not judge extraction from it.” 결정적인 제품 픽스처이며, 서명되지 않았고 자체 disclosure 필드에 그렇게 표시되어 있습니다. 모양에 맞춰 개발하고, 이것으로 추출 품질을 판단하지 마세요.

위치Try it, with no key (영문)Recipe 2: 공개 샘플 World를 Python으로 (영문)

개발자 파일 받기

이 장의 일부 단계에는 API 키가 필요합니다.

/developer/channel.json은 TAVONEL이 개발자에게 공개하는 모든 파일을 URL, sha256과 함께 하나의 채널 버전 아래에 나열합니다.

1. 필요한 파일을 channel.json에 적힌 URL에서 내려받습니다.
2. 파일의 sha256을 계산해 channel.json의 값과 비교합니다. Linux는 sha256sum, macOS는 shasum -a 256, Windows는 certutil -hashfile에 SHA256을 붙여 실행합니다.
3. node tavonel-cli.mjs status는 공개 상태를 출력하며 키가 필요 없습니다.

curl -fsS https://tavonel.com/developer/channel.json
curl -fsSO https://tavonel.com/developer/tavonel-cli.mjs
sha256sum tavonel-cli.mjs
node tavonel-cli.mjs status

참고 CLI에는 업로드 명령이 없습니다. 사용법 텍스트는 키를 “Scoped tvnl_live_... token (required except status)”로 적습니다. status를 뺀 모든 명령에 범위가 정해진 키가 필요하다는 뜻입니다.

위치channel.jsonCLI와 패키지 검증 (영문)

MCP 브리지 연결

이 장의 일부 단계에는 API 키가 필요합니다.

MCP 서버는 파일 하나, tavonel-mcp.mjs이며 읽기 전용 도구 9개를 제공합니다. npm이나 PyPI 패키지는 없습니다. 파일을 내려받고 클라이언트가 그 파일을 가리키게 합니다.

1. tavonel-mcp.mjs를 내려받고, 앞 장처럼 /developer/channel.json으로 sha256을 확인합니다.
2. node tavonel-mcp.mjs --version은 정확한 빌드를 출력합니다.
3. Claude Desktop(claude_desktop_config.json)이나 Claude Code(.mcp.json)에 절대 경로로 등록합니다. 설정 블록은 /docs/mcp에 있습니다.
4. node tavonel-mcp.mjs --doctor는 키, 채널 고정값, 실제 읽기를 점검하고, 처음 실패한 점검을 알려 줍니다.

쓰기 도구가 추가되면 서버는 시작을 거부합니다. 활성화 도구는 없습니다. 활성화는 브라우저에서 사람이 합니다.

참고 키가 없어도 도구 목록은 응답하고, 모든 도구 호출은 “API_KEY_MISSING: set TAVONEL_API_KEY to a key from your workspace”를 돌려줍니다. 워크스페이스에서 발급한 키를 TAVONEL_API_KEY에 넣으라는 뜻입니다. 키와 내 World는 저희와 함께 설정합니다.

위치클라이언트에 등록하기 (영문)MCP와 에이전트 (영문)

비용 미리 보기

이 장은 API 키 없이 따라 할 수 있습니다.

/pricing에는 계산기 What will this run cost?가 있습니다. 이번 실행의 원문 수와 가장 긴 원문의 페이지 수를 넣습니다.

1. 먼저 그 실행이 컴파일 한도를 어떻게 만나는지 행별로 보여 줍니다.
2. 이어서 Developer와 Team의 합계, Developer를 넘는 페이지, 추가 페이지가 모두 상향될 때의 최대 금액을 보여 줍니다.

“All figures in US dollars, excluding tax.” 모든 금액은 미국 달러이며 세금은 포함하지 않습니다.

참고 요금제 구매는 상담으로 시작합니다. /pricing의 요금제 버튼은 /contact로 연결됩니다.

위치What will this run cost? (영문)요금이용 문의

상태와 신뢰

이 장은 API 키 없이 따라 할 수 있습니다.

1. /status는 설정과 활성화 상태, 예약된 의존성 점검, 장애 이력을 보여 줍니다.
2. /trust는 갖춘 것, 앞으로 갖출 것, 없는 것을 나열하고, 각 행을 그것을 밝힌 페이지에 연결합니다.
3. /security는 문서 처리를 어떻게 통제하는지 설명합니다. 강제되는 처리 경계와, 믿고 기댈 수 있는 통제입니다.
4. /benchmarks/gdp-pdf는 공개 GDP.pdf 과제 세트로 돌린 두 갈래 실행을 게시하며, 그 결과를 페이지 제목으로 보여 줍니다.

참고 “No SOC 2 report, ISO 27001 certificate or independent penetration-test report exists yet.” SOC 2 보고서, ISO 27001 인증서, 독립 침투 테스트 보고서는 없습니다.

위치상태 (영문)신뢰 센터 (영문)보안 (영문)GDP.pdf 실행 (영문)

내 파일로 시작하려면

이 장은 API 키 없이 따라 할 수 있습니다.

1. /sources는 TAVONEL이 읽는 모든 원문과, 읽은 뒤에 남는 것을 형식별로 나열합니다.
2. /ko/evaluation은 내 문서 평가를 어떻게 합의하는지 설명합니다. 처리를 시작하기 전에 권한, 질문, 한도, 비용, 근거 품질을 정합니다.
3. /ko/contact는 이렇게 묻습니다. “자료를 보내지 않고 해결하려는 일과 필요한 범위를 알려주세요.”

참고 “내 자료의 연결과 컴파일은 상담 후 함께 설정합니다.”

위치지원 파일 (영문)내 문서 평가이용 문의

도움 받기

이 장은 API 키 없이 따라 할 수 있습니다.

“Email to support@tavonel.com is acknowledged within 1 business day (KST). That is an acknowledgement target and not a resolution time: no resolution time is committed, and security reports to security@tavonel.com are read first rather than queued behind product questions.” support@tavonel.com으로 보낸 메일은 KST 기준 1영업일 안에 접수를 확인합니다. 이는 접수 확인 목표이며 해결 시간이 아닙니다. 해결 시간은 약속하지 않으며, security@tavonel.com으로 보낸 보안 제보는 제품 문의 뒤에 쌓이지 않고 먼저 읽습니다.

모든 문서 섹션은 Report an issue with this page로 끝납니다. 누르면 support@tavonel.com으로 가는 메일이 열리고, 제목에 그 페이지가 적힙니다. 이 가이드는 같은 메일을 여는 이 페이지의 문제 알리기 링크로 끝납니다.

위치support@tavonel.com이용 문의

용어집과 개정 이력

이 장은 API 키 없이 따라 할 수 있습니다.

위치개념 (영문)