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

# ツール

ツールは、Stockwork Agent が持つ基本能力です。ユーザーの質問や指示に応じて、AI が適切なツールを自動的に選択・実行します。

## ツール早見表

| カテゴリ  | ツール名               | できること               |
| ----- | ------------------ | ------------------- |
| 検索    | [データ検索](#search)   | 商談ログ・取引などを条件で検索     |
| 閲覧    | [データ閲覧](#read)     | 特定データの詳細情報を表示       |
| 書き込み  | [データ書き込み](#write)  | 分析結果をシステムに保存（承認制）   |
| タスク   | [タスク管理](#todo)     | 複数ステップの作業進捗を自動管理    |
| ノート   | [ノート](#note)       | 提案書やレポートの作成・編集      |
| マニュアル | [マニュアル参照](#manual) | 操作手順をこのマニュアルから調べて案内 |

### ツール実行インジケーター

AI がツールを実行する際、メッセージエリアに **ツール実行インジケーター** が表示されます。

| 表示要素      | 説明                                         |
| --------- | ------------------------------------------ |
| **ツール名**  | Search（検索）/ Read（閲覧）/ Skill Guide（スキル読み込み） |
| **対象**    | 操作対象のデータ種別（取引、商談ログ、メモなど）                   |
| **ステータス** | 実行中（スピナー）/ 完了（件数表示）/ エラー                   |

インジケーターをクリックすると、検索条件やフィルタ内容などの詳細を確認できます。

***

<h2 id="search">
  データ検索
</h2>

商談ログ・取引・分析結果などのデータを、条件を指定して検索します。

### 対応データ

| データ種別       | 説明                                                |
| ----------- | ------------------------------------------------- |
| **商談ログ**    | 音声記録の文字起こし、AI 要約                                  |
| **取引**      | 会社名、金額、ステージ、カスタムプロパティ                             |
| **取引分析**    | AI による取引の分析結果                                     |
| **取引メモ**    | ユーザーが入力したテキストメモ                                   |
| **取引スコア**   | AI による成約可能性スコア                                    |
| **ライブラリ資料** | [ライブラリ](/guide/library) の社内資料。ファイル名と AI サマリを検索します |

### いつ使われるか

以下のような質問・指示を送ると、検索ツールが実行されます。

* 「直近の商談ログを見せて」
* 「ABC商事の取引を検索して」
* 「今月スコアが高い案件は？」
* 「SQLステージの取引一覧を取得して」

会社名、取引名、日付範囲、ステージなどの条件で絞り込みが可能です。組織独自のカスタムプロパティでのフィルタリングにも対応しています。

### 検索のリトライ

AI は検索結果が 0 件の場合でも、すぐに「見つかりませんでした」とは回答しません。以下のような戦略を自動的に実行します。

* 類似するフィールド名での再検索
* フィルタ条件の段階的な緩和
* フィルタなしでの全件取得による手動絞り込み

すべての戦略を試しても見つからない場合に限り、試した検索条件を明示したうえで「見つかりませんでした」と回答します。

<Tip>
  **ヒント**

  検索結果が期待と異なる場合は、条件を変えて再度質問してみてください。日付範囲を広げたり、キーワードを変えると見つかることがあります。
</Tip>

***

<h2 id="read">
  データ閲覧
</h2>

検索で見つけたデータや、指定した ID のデータの詳細情報を表示します。

### 対応データ

データ検索と同じデータ種別（商談ログ / 取引 / 取引分析 / 取引メモ / 取引スコア / ライブラリ資料）に対応しています。ライブラリ資料は本文の読み込みに加えて、@メンションで PDF・画像の原本ごと読ませることもできます（[ライブラリを AI から活用する](/guide/library-ai-usage#strix-agent)）。

### いつ使われるか

* 「その商談の詳細を教えて」
* 「この議事録の内容を見せて」
* 「取引のスコアを詳しく教えて」

検索結果の一覧から、特定のデータを深掘りする際に使われます。[ページコンテキスト](./index#ページコンテキスト) を活用すると、「この取引の～」のように ID を指定せずに閲覧できます。

<Tip>
  **ヒント**

  商談ログの文字起こし全文は非常に長くなることがあるため、通常は AI 要約のみが取得されます。全文が必要な場合は「文字起こし全文を見せて」のように明示的に指示してください。
</Tip>

***

<h2 id="write">
  データ書き込み
</h2>

エージェントが生成した分析結果をシステムに保存します。書き込み前には必ずユーザーの承認を求めます。

### 対応データ

現在、書き込みに対応しているデータ種別は以下の通りです。

* **議事録分析結果**: 商談ログの AI 分析結果

### 承認フロー

データの書き込みは、必ず以下の承認フローを経て実行されます。

1. AI が書き込み内容の **プレビュー** を表示する
2. ユーザーが内容を確認する
3. **承認** → データが保存される / **却下** → 操作がキャンセルされる

### いつ使われるか

* 「この商談ログを分析して保存して」
* 「分析結果を登録して」

<Tip>
  **ヒント**

  却下した場合でも、修正点を伝えて再生成を依頼できます。「もっと簡潔にまとめて」のように指示すると、内容を修正して再度承認を求めます。
</Tip>

***

<h2 id="todo">
  タスク管理
</h2>

複数ステップが必要な指示を出すと、AI がタスクリストを自動で作成し、進捗をパネルで表示します。

### いつ使われるか

3 ステップ以上の作業を依頼したとき、エージェントが自動的にタスクを作成します。ユーザーが明示的に指示する必要はありません。

**例**: 「今月の商談ログをすべて分析して」→ 各商談ログの分析がタスクとして一覧化される

### 画面の見方

| 表示要素           | 説明                                    |
| -------------- | ------------------------------------- |
| **プログレスバー**    | 全タスクの完了率を視覚的に表示                       |
| **完了数**        | 「X/Y 完了」の形式で進捗を数値表示                   |
| **各タスクのステータス** | 未着手（空の円）/ 進行中（回転アニメーション）/ 完了（チェックマーク） |

進行中のタスクにはアクティブな作業内容（例: 「商談ログを検索中...」）が表示されます。

<Tip>
  **ヒント**

  途中で方針を変えたい場合は、その旨を伝えてください。AI が残りのタスクを調整します。
</Tip>

***

<h2 id="note">
  ノート
</h2>

提案書やレポートなどの長文コンテンツを、チャットウィンドウの **サイドパネル** に作成・編集します。

### いつ使われるか

* 「提案書を作成して」→ ノートとしてサイドパネルに出力
* 「レポートにまとめて」
* 「分析結果をドキュメントにして」

チャットの応答として出力するには長すぎるコンテンツを生成する際に使われます。

### 操作の種類

| 操作       | 説明                    |
| -------- | --------------------- |
| **新規作成** | 新しいノートをサイドパネルに作成      |
| **全体更新** | ノート全体を新しい内容で書き直す      |
| **部分編集** | 追記、先頭挿入、セクション置換、文字列置換 |

### 編集の指示例

* 「背景のセクションをもっと具体的に書き直して」（セクション置換）
* 「最後に参考資料のセクションを追加して」（追記）
* 「○○を△△に変更して」（文字列置換）

<Tip>
  **ヒント**

  ノートはバージョン管理されており、編集のたびに新しいバージョンが保存されます。
</Tip>

***

<h2 id="manual">
  マニュアル参照
</h2>

Stockwork の操作方法や設定項目について質問すると、AI がこのマニュアルを検索して該当ページを読み、
手順を要約したうえで参照したページの URL を回答に添えます。

### いつ使われるか

* 「取引を CSV でインポートするには？」
* 「ボット録音の設定はどこ？」
* 「ダッシュボードの計算フィールドで何ができるの？」
* 「Salesforce 連携の手順を教えて」

### 回答の性質

| 状況               | AI の振る舞い                            |
| ---------------- | ----------------------------------- |
| **マニュアルに記載がある**  | 記載どおりの手順を要約し、参照ページの URL を添えます       |
| **マニュアルに記載がない**  | 推測で手順を作らず、記載がない旨とマニュアルのトップページを案内します |
| **顧客データについての質問** | マニュアルではなく [データ検索](#search) を使います    |

<Tip>
  **ヒント**

  AI が参照するのは公開済みのマニュアル（このサイト）です。マニュアルを更新すると、
  サイトの再デプロイ後に AI の回答にも反映されます。
</Tip>