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

動画で見たい方へ。これらの動画で手順を順番に説明しています。 ナレーションは英語で、英語字幕付きです。

1:36ヘルプページをAtlasに学習させるウェブサイトをソースとして追加し、読み込みを承認し、独自の回答を加えて、チケットでAtlasを試します。0:17あなたの知識をAtlasにウェブサイト、ドキュメント、チャンネルを読み込んでナレッジベースにします。

Atlasが取り込めるもの

ソースはダッシュボードのナレッジベース設定から追加します。ウェブサイトソースは、Pro では1ソースにつき最大 100 ページ、Enterprise では最大 500 ページをクロールできます。この上限は URL ベースのソースに適用され、Discord、GitHub、ファイルのソースにはそれぞれのルールがあります。ソースは4種類あります：

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

AtlasはQ&Aエントリからも回答します。回答を追加で自分で書いたエントリ、ファイルから作られたエントリ、スタッフがクローズしたチケットから学習したエントリ、そしてスタッフが回答に低評価を付けるときに入力する修正です。これらはスタッフQ&Aタブで確認、編集、削除できます。

エントリの構成

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

スタッフから学ぶ

学習を有効にすると、Atlasはクローズしたチケット内の対象となるスタッフの回答を、再利用できるQ&Aに変換します。「自動で追加」では、確信度の高いエントリを1日の上限内で公開します。不確かなエントリや個人情報を含む可能性があると判定されたエントリはレビュー待ちになります。「先に確認する」では、新しいエントリをすべて承認待ちにします。新しいナレッジベースの初期設定は「自動で追加」です。保存済みの「オフ」設定は変わりません。

入れてはいけないもの

• シークレット、パスワード、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キー、機密情報、顧客データをナレッジベースに保存しないでください。