> ## 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

Stockwork Agent は、Stockwork に組み込まれた AI アシスタントです。チャット形式で質問や指示を送ると、取引・商談ログ・分析結果などの CRM データを検索・閲覧し、分析や提案書の作成を支援します。

**アクセス方法**: 画面右下の **チャットアイコン**（吹き出しマーク）をクリック

## できること

Stockwork Agent は **ツール** と **スキル** の 2 つの仕組みで構成されています。

| 種類                  | 説明                             | 具体例                           |
| ------------------- | ------------------------------ | ----------------------------- |
| **[ツール](./tools)**  | データの検索・閲覧・書き込みなど、エージェントが持つ基本能力 | データ検索、データ閲覧、データ書き込み、タスク管理、ノート |
| **[スキル](./skills)** | ツールを組み合わせた業務ワークフロー             | 提案書作成                         |

<Tip>
  **ヒント**

  ツール名やスキル名を覚える必要はありません。自然な日本語で質問や指示を送るだけで、AI が適切なツールやスキルを自動的に選択して実行します。
</Tip>

***

## クイックスタート

### 1. チャットウィンドウを開く

画面右下の **チャットアイコン** をクリックすると、チャットウィンドウが表示されます。

### 2. 質問を送る

テキスト入力欄にメッセージを入力し、**Enter** キーまたは送信ボタンで送信します。

まずは以下のような質問を試してみてください。

* 「ABC商事のキーマンは誰？」
* 「今週の商談ログをまとめて分析して」
* 「ひふみ工業の次回商談の提案骨子を作成して」
* 「SQLステージの取引一覧を取得し、共通する顧客課題を抽出して」

<Tip>
  **サンプルメッセージ**

  会話が空の状態では、上記のようなサンプルメッセージがバッジとして表示されます。クリックすると入力欄にセットされます。
</Tip>

### 3. 結果を確認する

AI の応答中、**ツール実行インジケーター**（Search / Read など）が表示されます。これは AI がデータを検索・閲覧していることを示しています。インジケーターをクリックすると検索条件などの詳細を確認できます。

<Info>
  **エラー表示について**

  ツール実行でエラーが表示されることがありますが、AI は自動的に検索条件を変えてリトライします。これは AI の試行錯誤の一部であり、最終的な回答が正しければ問題ありません。
</Info>

***

## チャットウィンドウ

### ウィンドウの構成

| 要素           | 説明                                                |
| ------------ | ------------------------------------------------- |
| **ヘッダー**     | 左に履歴ボタン、中央に「Stockwork Agent」タイトル、右に新規会話ボタンと閉じるボタン |
| **メッセージエリア** | 会話のやり取りが表示される領域。上方向へのスクロールで過去のメッセージを読み込み可能        |
| **入力エリア**    | テキスト入力欄と送信ボタン。ストリーミング中は停止ボタンに切り替わる                |

### ヘッダーボタン

| ボタン               | 説明                                   |
| ----------------- | ------------------------------------ |
| **履歴**（パネルアイコン）   | 過去の会話一覧サイドバーを開閉。サイドバーを開くとウィンドウが横に広がる |
| **新しい会話**（+ アイコン） | 現在のセッションを終了し、新しい会話を開始                |
| **閉じる**（X アイコン）   | チャットウィンドウを閉じる                        |

### メッセージの送信

| 操作                | 説明           |
| ----------------- | ------------ |
| **Enter**         | メッセージを送信     |
| **Shift + Enter** | 改行を挿入        |
| **Escape**        | ストリーミング応答を停止 |

<Info>
  **メッセージの文字数制限**

  1 回のメッセージは最大 4,000 文字まで入力できます。上限に近づくと残り文字数が表示されます。
</Info>

### メッセージの表示

* **ユーザーのメッセージ**: 右寄せのカラーバブルで表示
* **AI の応答**: 左寄せのプレーンテキストで表示（Markdown 形式に対応）
* 各メッセージにはホバー時にコピーボタンが表示されます

***

## ページコンテキスト

Stockwork Agent は、ユーザーが現在閲覧しているページの情報を自動的に認識します。これにより、「この取引の商談ログを見せて」のように、具体的な ID を指定しなくても文脈に沿った操作が可能です。

| ページ         | 認識される情報  |
| ----------- | -------- |
| **取引詳細**    | 取引 ID    |
| **商談ログ詳細**  | 商談ログ ID  |
| **会社詳細**    | 会社 ID    |
| **コンタクト詳細** | コンタクト ID |
| **タスク詳細**   | タスク ID   |

<Tip>
  **ヒント**

  取引の詳細ページで「この取引の提案書を作って」と指示すると、AI が自動的にその取引の情報を取得して提案書の作成を開始します。
</Tip>

***

## セッション管理

Stockwork Agent との会話は **セッション** 単位で管理されます。

### 会話の履歴

ヘッダーの **履歴ボタン** をクリックすると、画面左側にサイドバーが表示されます。

| 表示項目           | 説明                               |
| -------------- | -------------------------------- |
| **セッションタイトル**  | 会話のタイトル（未設定の場合は「無題の会話」）          |
| **メッセージプレビュー** | 最新メッセージの冒頭部分                     |
| **日時**         | 最終メッセージの日時（今日は時刻、今週内は曜日、それ以前は日付） |

### セッションの操作

| 操作           | 方法                                |
| ------------ | --------------------------------- |
| **過去の会話を再開** | サイドバーのセッションをクリック                  |
| **新しい会話を開始** | サイドバーの「新しいチャット」ボタン、またはヘッダーの + ボタン |

<Info>
  AI の応答中（ストリーミング中）は、セッションの切り替えや新規作成はできません。応答が完了するか、停止ボタンで中断してから操作してください。
</Info>

***

## 注意事項

* Stockwork Agent はデータ取得にツールを使用し、推測による回答を避けます。データが見つからない場合はその旨を明示します
* 商談ログの文字起こし全文は非常に長くなることがあるため、通常は AI 要約のみが取得されます。全文が必要な場合は明示的に指示してください
* 複雑な指示には AI がタスクリストを作成して段階的に処理します。途中で方針を変えたい場合はその旨を伝えてください
* 現在のセッションを閉じても会話履歴は保持されます。サイドバーからいつでも過去の会話を再開できます

***

## 関連機能

* [商談ログ AI 要約](/guide/ai/meeting-summary) -- Agent が商談ログの分析に利用するデータ
* [取引分析](/guide/ai/deal-analysis) -- Agent が取引の分析結果を参照する機能
* [取引スコア](/guide/ai/deal-score) -- Agent が成約可能性スコアを参照する機能
* [要約プロンプトの設定](/guide/ai/summary-prompts) -- Agent が利用する要約タイプの管理