> ## Documentation Index
> Fetch the complete documentation index at: https://docs-eos.fpt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

> ドキュメントのアップロードからエージェント接続まで - Enterprise Data Platform の画面操作を順に説明します。

このページは実際の作業順に沿っています：ドキュメントをソースに入れ、ナレッジベースにまとめ、検索をテストし、最後にエージェントに渡します。すべて画面上で操作でき、コードは不要です。

## ログインと画面の見方

**1. ログイン**

管理者から案内された URL を開き、**Login with FPT** をクリックするか、メールアドレスとパスワードでログインします。

**2. ワークスペースを選択**

サイドバー上部に現在のワークスペースとロール（*ワークスペースオーナー*、*メンバー*）が表示されます。クリックすると切り替えられます。

サイドバーの主な機能グループ：

| グループ | 項目 | 用途 |
| - | - | - |
| 取り込み・処理 | データソース | ドキュメントをプラットフォームに取り込む |
| ナレッジ | ナレッジベース | ドキュメントをエージェントが検索できる形にまとめる |
| 品質 | 検索テスト・品質評価 | エージェントが受け取る内容を確認し、数値で測る |
| 管理 | データガバナンス・メンバーとロール | メタデータスキーマ、ユーザー |

**概要** は毎朝確認したい画面です：準備完了のソース数、インデックス済みドキュメント数、直近 14 日の取り込み量、そして回答品質に影響している問題を一覧する **要対応**（例：処理に失敗したドキュメント）。下部の **データリネージ** 図では、どのソースがどのナレッジベースに流れ、どのナレッジベースがエージェントに呼ばれているかが分かります。ノードをクリックすると該当画面が開きます。

## ステップ 1：データソースを作成する

すべてのドキュメントはソースを通じて取り込まれます。現在はファイルとフォルダのアップロードでソースを作成します。

**1. ウィザードを開く**

**データソース** → **データソースを追加** → **ファイルとフォルダをアップロード** → **続行**。

**2. ファイルやフォルダをドロップ**

ドキュメントのフォルダを枠にドラッグするか、*ファイルを選択*／*フォルダを選択* をクリックします。右側のキューにファイル数と容量が表示されます。

**3. 名前とオプションを設定**

分かりやすい **ソース名** を付けます（例：*経理手順 2026*）。次の 2 つはオンを推奨します。

* **フォルダ構成を保持** - フォルダ名が検索時のフィルター用メタデータになります。
* **同一ドキュメントは 1 件のみ保存** - 同じ文章が二重に返されるのを防ぎます。

**4. 作成**

**ソース概要** を確認し、**ソースを作成** をクリックします。アップロードが始まったら、ダイアログを閉じて他の作業を続けられます。

> [!NOTE]
>
> 手順 3 の 2 つのオプションは作成時に確定し、後から変更できません。

### ソース内のファイル管理

ソース詳細画面には次のタブがあります。

| タブ | 用途 |
| - | - |
| ファイル一覧 | フォルダの閲覧・作成・名前変更・移動・削除。*取り込み済み*／*必須メタデータ不足* で絞り込み。**Excel で編集** でメタデータを一括修正 |
| アップロード履歴 | アップロード単位ごとの結果と、エラー・スキップされたファイルの確認（再アップロード用） |
| ゴミ箱 | 削除したファイルは 30 日間ここに残り、インデックスからは外れているためエージェントには見えません |
| 設定 | ソース名の変更、利用中のナレッジベースの確認、**フォルダ単位のメタデータルール**、ソースの削除 |

各ファイルの **⋯** メニュー：**ダウンロード**、**名前を変更**、**移動**、**メタデータ**、**削除**。

**フォルダ単位のメタデータルール** を使えば、ファイルを 1 つずつタグ付けする必要はありません。*契約書/2026* フォルダに *muc\_do\_mat = 2* を設定すれば、そこに入れたファイルはすべて自動で引き継ぎます。サブフォルダは親のルールを継承し、ファイルに手動で設定した値が常に優先されます。

## ステップ 2：ナレッジベースを作成する

ナレッジベースは、エージェントが実際に検索する対象です。読み取り・分割・埋め込みはソースではなくナレッジベース側で行われるため、1 つのソースから処理方法の異なる複数のナレッジベースを作れます。

**1. データを選択**

**ナレッジベース** → **ナレッジベースを作成**。1 つ以上のソースにチェックを入れます。特定のフォルダやファイルだけを使う場合はツリーを開いて選択します。**システムソース** には毎日自動更新される *法令文書* インデックスがあります。

**2. パイプラインを選択**

既定の **ファイルごとに自動** のままで構いません。各ファイル形式がどう処理されるかが画面に表示されます。

**3. 名前とエージェント向けの説明**

**エージェント向けの説明** は具体的に書きます。エージェントはこれを読んで、いつこのナレッジベースを呼ぶか判断します。共同で担当する人がいれば **ナレッジベース管理者** に追加します。

**4. 確認して作成**

すべて確認して作成すると、処理とインデックス化が始まります。

**ファイルごとに自動** パイプラインの処理内容：

| ファイル形式 | 処理方法 |
| - | - |
| DOCX | 見出しで分割 |
| PDF | テキストを直接抽出。スキャンの場合は自動で OCR |
| XLSX / CSV | 行単位で分割し、列見出しを保持 |
| HTML | メニューを除去し本文のみ保持 |

良い説明の例：

> *「2026 年の社内経理手順：支払、仮払、精算、証憑。手続き、提出書類、処理期限について質問されたときにこのナレッジベースを呼び出す。」*

### ナレッジベースの監視と調整

| タブ | 用途 |
| - | - |
| ドキュメント | 各ドキュメントの状態（*処理済み*、*処理エラー*）を確認。**範囲を編集** でソースから取り込む範囲を変更 |
| 要レビュー | 対応待ち：取り込み失敗、必須メタデータ不足、ユーザーからの誤り報告、ソースとの競合 |
| 設定 | パイプライン、検索方式、Top-K、スコア閾値、フィルターに使うメタデータ項目の変更 |
| 接続 | MCP / REST URL、ツール名、API キー、許可済みアプリ、呼び出しログ |

質問の種類に応じて検索方式を選びます。

| 方式 | 向いているケース |
| - | - |
| ベクトルのみ | 自由な表現の質問。最速 |
| 全文検索（BM25） | 文書番号、固有名詞、コードを含む質問 |
| ハイブリッド＋リランク | 両方を組み合わせて再順位付け。既定は 70% ベクトル・30% BM25 |

ドキュメントの種類によって検討したい 3 つの設定：**親チャンクへ拡張**（小さな単位で探し、条文全体を返す）、**有効な文書のみ返す**、**メタデータ自動フィルター**（質問から部署や期間を推定）。

## ステップ 3：エージェントに渡す前に検索をテストする

誤答の原因はモデルよりも、エージェントが誤った箇所を受け取っていることがほとんどです。**検索テスト** で、エージェントが受け取る内容をそのまま確認できます。

**1. ナレッジベースと方式を選ぶ**

**検索テスト** を開き、**ナレッジベース** と **検索方式** を選択します。

**2. 必要ならフィルターを設定**

**メタデータフィルター** は `;` で区切って複数条件を指定でき、演算子は `=`、`!=`、`~`（含む）。例：`muc_do_mat=1;ten_tep~Luat`。

**3. 実際の質問で試す**

実際のユーザーが聞く質問を入力し、**Top-K** と **類似度の閾値** を調整して **検索** をクリックします。

**4. 診断を読む**

返されたチャンクと自動 **診断** を確認します。

## ステップ 4：エージェントを接続する

ナレッジベースごとに **接続** タブに専用のエンドポイントがあるため、各エージェントに必要なナレッジベースだけを渡し、個別に取り消せます。

| 項目 | 形式 |
| - | - |
| MCP URL | `https://<domain>/api/mcp/kb/<kb-id>` |
| REST URL | `https://<domain>/api/v1/kb/<kb-id>/retrieve` |
| MCP ツール名 | ナレッジベース名から自動生成（例：`search_accounting_procedures`） |
| 公開ツール | `search_…`（検索）、`get_document`（全文取得）、`submit_feedback`（エージェントによる評価） |

**OAuth（推奨）**

キーは不要です。MCP URL を MCP 対応クライアントに貼り付けると、初回接続時にブラウザが開くので、ログインして **許可** をクリックします。エージェントはそのユーザー自身の権限で読み取り、**許可済みのアプリ** からいつでも取り消せます。

```json theme={null}
{
  "mcpServers": {
    "search_accounting_procedures": {
      "type": "http",
      "url": "https://<domain>/api/mcp/kb/<kb-id>"
    }
  }
}
```

**API キー**

**このナレッジベース用の新しいキーを発行** をクリックし、`Authorization: Bearer <キー>` または `X-API-Key: <キー>` で送信します。エージェントにログインを必須にしたい場合は **MCP は OAuth のみ受け付ける** をオンにします（REST は引き続きキーを使用可能）。

**REST API**

```http theme={null}
POST https://<domain>/api/v1/kb/<kb-id>/retrieve
Authorization: Bearer <キー>
Content-Type: application/json

{
  "query": "仮払金の精算に必要な書類は",
  "top_k": 6,
  "rerank": true,
  "include_citations": true
}
```

**接続** タブには Claude Code、VS Code、Cursor 向けの設定例があり、**コピー** するだけで使えます。

## 品質を監視する

**品質評価** で重要な質問を **ゴールデン質問セット** に追加してナレッジベースを定期的に確認し、**実運用の品質** タブで、エージェントが質問しているのにナレッジベースがまだ答えられない内容を把握します。詳しくは [品質評価](https://docs-eos.fpt.ai/ja/screens/evaluation.md) をご覧ください。

## 管理

| 項目 | 用途 |
| - | - |
| データガバナンス | ワークスペースのメタデータスキーマを定義。JSON でエクスポート／インポート。変更履歴を確認 |
| メンバーとロール | メンバー招待、ロール変更、**管理権限を移譲** |

メタデータスキーマには 2 種類の項目があります：常に存在し読み取り専用の *システム項目*（ソース、パス、ファイル名、形式、サイズ、アップロード者、アップロード日、ページ数など）と、自分で作成する *ワークスペース項目*（例：*muc\_do\_mat*（選択リスト）、*ngay\_hieu\_luc*（日付・必須））。

## 現在の制限

| 項目 | 制限 |
| - | - |
| ファイル形式 | PDF、DOCX、XLSX、PPTX、TXT、MD、HTML |
| 容量 | 1 ファイル最大 200 MB、1 回最大 2 GB |
| ゴミ箱 | 30 日間保持後に完全削除。手動で空にする操作はなし |
| ワークスペースのメタデータ項目 | 最大 40 個 |
| MCP ツール名 | 小文字で始まり、小文字・数字・アンダースコアのみ、最大 64 文字。API キー未発行の間のみ変更可能 |
| ソースの削除 | ナレッジベースで使用中の間は不可 |

## 利用上の注意

> [!WARNING]
>
> **注意：** 現在、ドキュメント単位の権限管理はありません。ワークスペースの全メンバーがアップロードされたファイルを閲覧でき、API キーを持つ人はナレッジベース全体を検索できます。機密文書はアップロードしないでください。

> [!NOTE]
>
> **注意：** メタデータの項目コードは作成後に変更できません。表示ラベルは自由に変えられますが、コードは MCP ツールのパラメータや CSV の列に直接使われるため、変更すると稼働中の連携がすべて壊れます。

> [!NOTE]
>
> **注意：** 埋め込みモデルはナレッジベース作成後に固定され、同じナレッジベース内の全ソースで共通です。変更するには全チャンクの再埋め込みが必要です。

> [!TIP]
>
> **注意：** 退職者を削除する前に、その人が管理するソースとナレッジベースを移譲してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.