# Concepts Glossary
Short definitions of the terms used across docspi's product, API, and MCP documentation.
- **Virtual tree** -- The tree of folders and documents docspi presents to users and agents. It is independent of where content is physically stored -- a virtual tree node points at a physical file (local, GitHub, or Google Drive) through a mapping, so the same document can be reorganised in the tree without moving the underlying file.
- **Virtual alias** -- A virtual tree node's name and path are an alias for whatever physical file its mapping points at -- the node itself stores no document bytes. Renaming or moving a node changes its alias, not the underlying file.
- **Global Doc ID** -- A short, portable identifier in the `@tenant:project:seq` format, issued for a specific document node. Handing this string to another agent or account is enough for it to resolve the document, subject to an explicit share grant for cross-tenant access.
- **Personal view** -- A user-specific virtual tree that organises references (and folders) to documents from multiple projects into one personalised structure, without moving or copying the underlying documents.
- **spid (default agent)** -- The reserved, auto-provisioned agent that represents the tenant itself rather than a specific named custom agent. It is used as the default acting/owning agent for nodes and history entries created without an explicit acting agent.
- **Provenance** -- The recorded chain of edits (document lineage) behind a published document, hashed at each step. It lets docspi verify that a live document's content still matches an unbroken edit history.
- **Verified Origin** -- A published document's provenance status as shown to readers: `verified` when its lineage chain exists and the tip hash matches the live content, `mismatch` when the hash no longer matches, `missing` when there is no chain, or `unknown` when the check could not be performed.
- **Capability** -- A narrow, single-use, time-limited token minted for one recipient actor, one resource, and one set of scopes -- issued and consumed through the capabilities API, independent of the recipient's own API token.
- **SEAL** -- docspi's HPKE-based secret hand-off between two agent actors. The sender encrypts locally against the recipient's enrolled public key; docspi stores and relays only the ciphertext, and the envelope can be fetched and decrypted exactly once.
- **Agent pairing (RFC 8628)** -- The RFC 8628-style device-authorization flow an agent uses to obtain its own API token without a human ever typing a request: the agent starts a pairing request, a human approves a short code in the browser, and the agent polls until the token is issued.
- **White-label delivery** -- Serving a tenant's published documents, `llms.txt`, `docspi.json` manifest, and sitemap under the tenant's own verified custom domain, with no docspi branding or navigation. By convention the serving subdomain is `docs.<domain>`, or `docspi.<domain>` when `docs.` is already in use; agents check `docs.<domain>/docspi.json` then `docspi.<domain>/docspi.json` to identify a docspi-served domain. Verification is a DNS TXT record (`docspi-verify=<token>`) plus a CNAME to `docspi.ai`; adding and verifying a domain is a browser-session step for the human owner.
- **DDP (cross-project distribution)** -- Cross-project Document Distribution: a source project fans a document set out to a list of target projects, each of which acknowledges receipt and can file structured feedback back to the sender.
- **AIO score** -- An AI-Optimisation score docspi computes for a published document, reflecting how readily an AI search/answer engine can parse and cite it.
- **llms.txt** -- A plain-text index of a tenant's published documents at `/llms.txt` (and a full-text version at `/llms-full.txt`), following the llms.txt convention that AI search/crawling agents read.
## See also
- `use-cases.md`, `agent-quickstart.md`, `mcp-server.md`, `api-reference.md`
---
# 用語集
docspi の製品・API・MCPドキュメント全体で使われる用語の簡潔な定義です。
- **仮想ツリー** -- docspi がユーザーとエージェントに提示する、フォルダとドキュメントのツリーです。コンテンツが物理的にどこに保存されているかとは独立しています -- 仮想ツリーのノードはマッピングを通じて物理ファイル（local / GitHub / Google Drive）を指すため、実体のファイルを移動せずにツリー上での整理を変更できます。
- **仮想エイリアス** -- 仮想ツリーのノードの名前とパスは、そのマッピングが指す物理ファイルへのエイリアス（別名）にすぎません -- ノード自体はドキュメントの実体を保持しません。ノードの名前変更や移動は、このエイリアスを変えるだけで、実体のファイルは変わりません。
- **グローバルDoc ID** -- 特定のドキュメントノードに対して発行される、`@tenant:project:seq` 形式の短く可搬な識別子です。この文字列を別のエージェントやアカウントに伝えるだけでそのドキュメントを解決できます。ただしテナントを跨ぐアクセスには明示的な共有付与が必要です。
- **パーソナルビュー** -- 複数のプロジェクトにまたがるドキュメントへの参照（およびフォルダ）を、ユーザー固有の1つの構造にまとめた仮想ツリーです。実体のドキュメントを移動・複製することはありません。
- **spid（デフォルトエージェント）** -- 特定の名前付きカスタムエージェントではなく、テナント自身を表す、予約された自動発行のエージェントです。明示的な実行エージェントを指定せずに作成されたノードや履歴エントリの、既定の実行者/所有者エージェントとして使われます。
- **来歴（Provenance）** -- 公開ドキュメントの背後にある編集の連鎖（document lineage）で、各段階でハッシュ化されています。これにより docspi は、公開中のドキュメントの内容が、途切れのない編集履歴と一致していることを検証できます。
- **Verified Origin** -- 読者に提示される公開ドキュメントの来歴ステータスです: 来歴チェーンが存在し末尾のハッシュが公開中の内容と一致すれば `verified`、ハッシュが一致しなければ `mismatch`、チェーンが存在しなければ `missing`、判定自体ができなければ `unknown` となります。
- **Capability** -- 1人の受信者アクター・1つのリソース・1組のスコープに限定された、単回使用・時間制限付きのトークンです。受信者自身のAPIトークンとは独立して、capabilities API を通じて発行・消費されます。
- **SEAL** -- 2つのエージェントアクター間での、docspi の HPKE ベースの秘密情報受け渡し機能です。送信者は受信者の登録済み公開鍵に対してローカルで暗号化し、docspi は暗号文のみを保存・中継します。エンベロープはちょうど1回だけ取得・復号できます。
- **エージェントペアリング（RFC 8628）** -- エージェントが、人間にリクエストを一切入力させることなく自分自身のAPIトークンを取得するための、RFC 8628 準拠のデバイス認可フローです。エージェントがペアリングリクエストを開始し、人間がブラウザで短いコードを承認し、エージェントはトークンが発行されるまでポーリングします。
- **白ラベル配信** -- テナントの公開ドキュメント、`llms.txt`、`docspi.json` マニフェスト、サイトマップを、テナント自身の検証済みカスタムドメインの下で、docspi のブランディングやナビゲーションなしに配信することです。慣例として配信サブドメインは `docs.<domain>` ですが、`docs.` が使用済みの場合は `docspi.<domain>` を使います。エージェントは `docs.<domain>/docspi.json`、次に `docspi.<domain>/docspi.json` を確認して docspi 配信かどうかを識別します。検証は DNS TXT レコード（`docspi-verify=<トークン>`）と `docspi.ai` への CNAME で行い、ドメインの追加・検証はオーナー（人間）のブラウザセッションで行う手順です。
- **DDP（プロジェクト横断配布）** -- プロジェクト横断ドキュメント配布（Document Distribution）: 配布元プロジェクトがドキュメント一式を複数の対象プロジェクトへ展開し、各対象プロジェクトが受領を確認し、送信元へ構造化されたフィードバックを送ることができます。
- **AIOスコア** -- docspi が公開ドキュメントに対して算出する、AI検索・回答エンジンがどれだけ容易に解析・引用できるかを示すAI最適化スコアです。
- **llms.txt** -- テナントの公開ドキュメントの索引を `/llms.txt`（全文版は `/llms-full.txt`）で提供する、AI検索・クローリングエージェントが読み取る llms.txt 規約に準拠したプレーンテキストです。
## 関連ページ
- `use-cases.md`, `agent-quickstart.md`, `mcp-server.md`, `api-reference.md`
---
Canonical: https://docspi.ai/docs/concepts