コース目次
アカデミーモジュール 5 · エージェントの作業と承認
ケースファイルで調査資料を整理
このレッスンで学ぶこと
- 会話のピン留め、エンティティページ、または新規作成からケースを作成できる
- 中心となる問いでケースの範囲を定め、継続的な調査ログを残せる
- ピン留めしたエンティティの集合を追加・整理し、グラフキャンバスやエンティティテーブルに表示できる
- 新しいエビデンスのストリップで、前回以降の変化を確認できる
- 目的に応じてケースとコレクションを使い分けられる
取引先の選定や繰り返す不具合の調査では、同じ質問を数週間にわたって検討することがあります。根拠となる情報は、チャット、ノート、グラフのエンティティに分かれているかもしれません。
ケースファイルにそれらの参照をまとめると、資料を探し直さずに調査を再開できます。
Consilience の ケース は、1 つの調査を継続して扱うための場所です。ケースには、中心となる 1 つの問い、手動でピン留めしたナレッジグラフのエンティティ、紐付けた会話、自由記述のログが含まれます。次に戻ったときには、不在中に新しいエビデンスが加わったピン留め済みエンティティも分かります。
ケースに含まれるもの
| 項目 | 内容 |
|---|---|
| 名前 | ピン留めした会話のタイトルが使われます。会話がなければ「無題のケース」になります。その場で編集し、Enter を押すか別の場所をクリックすると保存されます。 |
| 中心となる問い | 任意の自由記述欄です。プレースホルダーには「このケースで調べることは何ですか？」と表示されます。 |
| ピン留めしたエンティティ | ナレッジグラフのエンティティです。それぞれがグラフ上の実際のエンティティノードを参照し、ピン留めした時点の表示ラベルを保持します。 |
| 会話 | ケースに紐付けたチャットです。ケースが保持するのは参照だけなので、チャット自体は通常のチャット履歴に残ります。 |
| 調査ログ | 継続的に記録する自由記述のノートです。入力欄からフォーカスを外すと保存され、セッションをまたいで残ります。 |
- ケース
- 継続して使える調査のコンテナ。1 つの中心となる問い、ピン留めしたエンティティ、紐付けた会話、継続的なログで構成される。
- ピン留めしたエンティティ
- グラフ上の実際のエンティティノードへの参照。ラベルはピン留めした時点の表示内容で保存される。
- 紐付けた会話
- ケースに属するチャット。ケースが保持するのは参照のみで、チャットは通常の履歴に残る。
- 中心となる問い
- ケースの範囲を定める任意の 1 行。「このケースで調べることは何ですか？」に答える内容。
- 調査ログ
- 入力欄からフォーカスを外すと保存され、セッションをまたいで蓄積される自由記述のノート。
- 新しいエビデンスのストリップ
- ケースを再度開いたときに実行される確認。前回以降に新しいグラフ上のエビデンスを得た、ピン留め済みエンティティを一覧表示する。
ケースを始める 3 つの方法
一般的な方法：会話をピン留めする
- 会話する
普段どおりにトピックについてチャットします。
@でエンティティにメンションするか、アシスタントに回答内で[[entities]]を引用させます。ピン留めは、後からこの記録を読み取ります。 - ピン留めする
サイドバーのセッション一覧でチャットを右クリックするか、「…」ボタンをクリックし、「ケースとしてピン留め…」 を選びます。
- 通知を確認する
「新しいケースにピン留めしました」 という通知に、ピン留めしたエンティティ数が表示されます。ケースが開き、チャットがすでに紐付けられ、認識されたすべてのエンティティがピン留めされ、チャットのタイトルがケース名として使われます。
- エンティティページから：ヘッダーの「グラフで開く」の隣にある 「ケースに追加」 メニューを開きます。「このエンティティから新しいケースを作成」 を選ぶと、そのエンティティ名を使い、あらかじめピン留めされたケースができます。区切り線の下には既存ケースが並び、そこへ追加することもできます。「{label} をケースに追加しました」 という通知で完了を確認できます。
- 最初から作成：ケース（⌘⇧K）を開き、「新しいケース」 をクリックします。エンティティも会話もまだない、空の「無題のケース」が作成されます。
ピン留めは決定的な処理で、AI を使用しません
「ケースとしてピン留め…」では、会話で扱われたエンティティをモデルに判断させません。トランスクリプトにすでに含まれる、利用者が入力した @ メンションのトークンと、アシスタントが埋め込んだ [[…]] の引用（旧形式のトランスクリプトでは [@name]）を読み取り、各ラベルを現在のナレッジグラフと照合します。
エンティティノードに一致しないラベル、たとえば通常のノートを指す [[note]] の引用は除外されます。同じエンティティの別名はどちらも同じグラフノードに到達するため、1 つのチップに統合されます。モデルは呼び出されず、データが端末外へ出ることもありません。
ケースの更新と調査の再開
ケースは、「ケース」 という 1 つのタブで扱います。このタブはケース一覧と各ケースの詳細の両方に使われ、別のケースを開くと同じタブの対象が切り替わります。グラフとエンティティテーブルのタブも同じように動作します。ケース内では、必要なものを 1 つの画面で確認できます。
| 操作 | 動作 |
|---|---|
| 「このケースで続ける」 | 新しいチャットを開いてケースに紐付け、ピン留めしたすべてのエンティティを実際の @ メンションチップとしてコンポーザーへ入力します。不要なチップは送信前に削除できます。 |
| 「キャンバスに表示」 | ピン留めした集合だけをグラフキャンバスへ配置し、種類ごとに色分けします。エンティティを 1 件以上ピン留めすると利用できます。 |
| 「テーブルで開く」 | このケースに絞ったエンティティテーブルを開きます（名前／種類／つながり／ノート、フィルターと並べ替えに対応）。ピン留めしたエンティティが 1 件以上あると利用できます。 |
| エンティティチップ | クリックすると、そのエンティティのプロフィールページを開きます。ポインターを合わせて ✕（「削除」）をクリックするとピン留めを解除します。 |
| 「調査ログ」 | ケースの継続的なノートです。プレースホルダーには、これまでに分かったことや発見事項の記録を促す文が表示されます。入力欄からフォーカスが外れると保存されます。 |
| 「ケースを削除」 | 確認ダイアログの後、ケースというコンテナだけを削除します。ダイアログには「ノートと会話は保持されます」と表示されます。 |
ケースをもう一度見つける
ケースには固定のサイドバーアイコンがありません。ワークスペース内のどこからでも ⌘⇧K（Windows は Ctrl+Shift+K。設定 → ショートカット → ナビゲーションで変更可能）を押すか、グローバルパレット（⌘⇧F）から開けます。
各ケースも、パレット上で個別の項目として表示されます。タイトルはケース名、サブタイトルは「N 件をピン留め」です。ケース名を入力するのが、目的のケースへ直接移動する最短の方法です。
会話をケースにする
- チャットで関心のあるトピックを検討し、
@で少なくとも 2 件のエンティティにメンションします。または、アシスタントが[[entities]]を引用した既存チャットを選びます。 - サイドバーのセッション一覧でその会話を右クリックし、「ケースとしてピン留め…」を選びます。
- エンティティ数を含む「新しいケースにピン留めしました」という通知を確認します。
- その場でケース名を変更し、「このケースで調べることは何ですか？」に中心となる問いを入力します。
- 「キャンバスに表示」をクリックし、ピン留めした集合だけをグラフで確認します。
「ケース」タブで新しいケースが開きます。「会話」にはチャットが、「ピン留めしたエンティティ」にはメンションしたエンティティがチップで表示されます。グラフキャンバスには、そのエンティティだけが種類ごとに色分けされて表示されます。
追加された根拠を確認
しばらくしてからケースを開くと、Consilience はケースを 前回 開いた時刻を確認します。そのうえで、その時刻より後に新しい事実が加わったピン留め済みエンティティをナレッジグラフへ問い合わせます。該当するものがあれば、「前回以降、ピン留めした N 件のエンティティに新しいエビデンスがあります：」 というストリップにラベルが表示されます。
確認を終えたら ✕（「閉じる」）をクリックします。閉じた状態はそのセッション中維持され、確認はケースを開くたびに 1 回実行されます。
コルクボードを拡張する
ソフトウェアが登場する前から、捜査担当者は写真やカードをコルクボードに留めていました。1 人の記憶だけで調査全体を保持することはできないからです。デジタルのケースには、紙にはなかった変更フィードがあります。新しい事実には時刻が伴うため、「前回見た後に何が追加されたか」という明確な問いに答えられます。
ケースとコレクションの使い分け
ケースと保存済みエンティティのコレクションは、同じ方法でグラフを参照します。「キャンバスに表示」と「テーブルで開く」は、コレクションでも同じビューです。データを複製するのではなく、どちらも 1 つのグラフを見るためのレンズです。では、どちらを選ぶべきでしょうか。
| 目的 | 選ぶもの |
|---|---|
| 閲覧、並べ替え、フィルターに繰り返し使えるエンティティ集合 | コレクション |
| 1 つの問いと、それに関するチャット、継続ノート、エビデンスの経路 | ケース |
| 手動で選んだ集合に対する「前回以降に何が変わったか」の確認 | 新しいエビデンスのストリップを備えたケース |
| エンティティテーブルの参照元切り替えに表示される集合 | コレクション。テーブルの切り替えメニューで「すべてのエンティティ」「種類」と並んで表示される |
ケースは変化し続ける参照集合
目的を持って整理してください。ピンはグラフ上のエンティティ自体を参照するため、その後エンティティの名前や形が変わってもチップは維持されます。ケースは利用者が選んだ集合を正確に保ちます。エンティティページの 「ケースに追加」 から増やし、チップの ✕ で整理できます。
情報を蓄積してください。発見事項を 「調査ログ」 に追加し、「このケースで続ける」 から新しいスレッドを開きます。数週間後には、ケースが問い全体を記憶する唯一の場所になります。
ケースは、アプリ内でも負担が少なく安全な構造です。各ケースはワークスペース単位でローカルに保存されます。Markdown へ書き込まれることも、モデルへ送信されることもありません。「ケースを削除」しても、ノート、エンティティ、チャットはすべて保持されます。
問いが 1 つのチャットに収まらなくなったら、ケースを作成してください。次は別の種類の記録を扱います。組み込みの Git パネルには、ファイルに加えられたすべての変更履歴が残ります。