# Atlasをナレッジベースで学習させる

> 情報源の設定、回答の精度維持、Claude CodeまたはCodexを使ったTicketCordナレッジベースの安全な検索と管理について説明します。

## Atlasが取り込めるもの

ソースはダッシュボードのナレッジベース設定から追加します。3種類あります：

- **単一ページ。**AtlasにURLを指定すると、そのページ（および設定可能な深さまでの数階層）をクロールします。すでに自社サイトで運用しているヘルプドキュメント、FAQ、製品ページに最適です。
- **Discordチャンネル。**Discordチャンネルのメッセージ履歴をインポートします。サポートチームがすでに公開の場で同じ質問に答えている場合、それらの回答からAtlasに学ばせたいときに便利です。
- **GitHubリポジトリ。**リポジトリと任意のパスをリンクすると、Atlasはそこで見つかったすべてのMarkdownファイル（`.md`、`.mdx`）をインデックスします。コードと同じ場所にドキュメントを置いているエンジニアリングチームに適しています。

## エントリの構成

巨大な1ページよりも、小さく焦点の絞られたソースのほうが効果的です。トピックごとに記事が分かれたヘルプセンター（「返金ポリシー」「キャンセル」「地域の対応状況」）は、「知っておくべきすべて」という巨大なドキュメント1つよりも、Atlasがきれいな回答を引き出しやすくなります。Atlasは返信で使用したソースを引用するため、細かく分かれたソースは引用の有用性も高めます。

## スタッフによるインラインの教育

スタッフが送信前にAtlasの下書きを修正すると、その修正はQ&Aエントリとして取り込まれ、ナレッジベースに追加されます。次に似た質問が来たとき、他のソースと関連性やコミュニティ投票によるランキングで競い合うため、良い修正は時間とともに自然に上位へ上がっていきます。再学習のジョブを回す必要はなく、新しいエントリはすぐに検索可能になります。

## 入れてはいけないもの

- シークレット、パスワード、APIキー、顧客データ。
- 古くなったポリシー。Atlasはすべてのエントリを最新の情報として扱います。
- 長引くインシデントのメモ。それには代わりに定型応答を使ってください。

## 品質チェック

ダッシュボードのナレッジベース一覧を定期的に開いて、古いエントリがないかざっと確認しましょう。回答内容が変わった場合（料金、ポリシー、対応地域）は、Atlasが古いバージョンを引用しないようエントリを編集または削除してください。ドキュメントを大きく変更した後は、URLベースのエントリを再クロールして、インデックスが顧客の実際に目にするサイトの内容を反映するようにしましょう。

## AIツールでナレッジベースを管理する

**MCP**は、安全にログインしてアクセスを許可した後、Claude CodeまたはCodexからTicketCordのナレッジベースを操作できる仕組みです。ダッシュボードの各画面を開かなくても、普段の言葉で依頼できます。

## 接続する前の確認

- TicketCordアカウントの所有者である必要があります。ダッシュボードのスタッフはMCP接続を作成できません。
- 利用中のプランにナレッジベースへのアクセスが含まれている必要があります。
- Claude CodeまたはCodex CLIをインストールし、TicketCordにログインできることを確認してください。
- 1つの接続で、現在所有しているサーバーと今後追加するサーバーのすべてにアクセスできます。ただし、各リクエストでは1つのBotとサーバーを明示し、TicketCordが毎回所有権とプランを再確認します。

## Claude CodeまたはCodexを接続する

1. ダッシュボードでBotとサーバーを選び、**ナレッジベース > 設定**を開いて、**AIツールを接続**を探します。
2. Claude Codeの場合は、`claude mcp add --transport http ticketcord https://ticketcord.com/api/mcp --scope user`を実行し、続けて`claude mcp login ticketcord`を実行します。
3. Codexの場合は、`codex mcp add ticketcord --url https://ticketcord.com/api/mcp`を実行し、続けて`codex mcp login ticketcord`を実行します。
4. ブラウザでTicketCordが開きます。ログインし、アカウント全体へのアクセスに関する注意と、要求される読み取り、書き込み、削除の権限を確認して、**アクセスを許可**または**拒否**を選びます。
5. **認証が完了しました**と表示されたらタブを閉じ、AIツールに戻ります。最初に`TicketCordのナレッジベースを一覧表示して。`と依頼してみてください。

## 依頼できること

- ナレッジベースの一覧を表示し、設定、情報源、インデックス状況、エントリを確認する。
- 意味に基づいて検索し、情報源名と信頼度が付いた短い関連箇所を表示する。
- Webページ、Discordチャンネル、接続済みGitHubリポジトリの情報源を追加、編集、有効化、無効化、再インデックス、削除する。
- エントリを作成、編集し、保留中のエントリを確認して承認、却下、削除する。
- 製品情報、トリガー、表示、品質、更新、動作、フィードバック、チケット学習、Auto Supportなど、ダッシュボードで編集できる設定を更新する。

## 便利な依頼例

- `ナレッジベースを一覧表示し、準備完了の情報源がないものを教えて。`
- `返金ポリシーを検索し、情報源名を付けて要約して。`
- `古い料金に触れているエントリを探して。変更せず、最初に一覧を見せて。`
- `https://docs.example.comをドキュメント情報源として追加し、インデックスを開始して。`
- `保留中のエントリを表示し、変更前に承認か却下かを提案して。`
- `現在のパスワード再設定の回答を見せてから、更新を手伝って。`

## 権限、安全性、アクセス

- 読み取り権限では情報の表示と検索、書き込み権限では設定、情報源、エントリの変更、削除権限では情報源とエントリの完全な削除ができます。
- リスクのある変更では、実行前に見つかった内容と予定している操作をAIツールに表示させてください。
- 削除は元に戻せません。接続を承認した後も、TicketCordはリクエストごとに権限を再確認します。
- プランの期限切れや変更でナレッジベースを利用できなくなると、接続は一時停止します。接続を取り消しておらず、更新用アクセスが期限切れでなければ、対象プランへの変更後に再び利用できます。
- ナレッジベース設定の**AIツールを接続**カードから、接続をすぐに取り消せます。
- GitHubアカウントの接続と切断は引き続きダッシュボードでのみ行えます。パスワード、APIキー、機密情報、顧客データをナレッジベースに保存しないでください。

## 機械可読リソース

- [正規の HTML](https://ticketcord.com/ja/help/ai/knowledge-base)
- [TicketCord llms.txt](https://ticketcord.com/llms.txt)
- [AI ページインデックス](https://ticketcord.com/api/ai/pages)