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

# 取引プロパティ自動入力

取引プロパティ自動入力は、[商談ログ](/guide/meeting-logs/overview) の内容から AI が取引プロパティの値を抽出し、自動で反映または承認待ち候補として保留する機能です。次回アクションや決裁プロセスなど、商談後に取引へ転記したい情報を、手入力せずに更新できます。

## 始める前に

* 自動入力の設定変更は **管理者** のみが行えます。
* 候補の確認・承認・却下はすべてのロールで可能です。
* 対象は Stockwork 内で管理している **取引** のプロパティ(標準項目・カスタムプロパティ)のみです。会社・コンタクト・商談音声のプロパティ、および SFA から取り込んだ読み取り専用プロパティは対象外です。
* 対応するデータ型は、テキスト・数値・日付・日時・選択肢・真偽値です。
* 取引の所有者(担当者)は対象外です。

## 動作の仕組み

1. 営業担当が商談ログを保存します。
2. AI が文字起こしを読み取り、自動入力が有効になっている取引プロパティに対して値を抽出します。
3. プロパティごとに設定された **モード** に応じて、抽出結果が処理されます。

<Info>
  自動入力が動くのは **商談ログの保存時のみ** です。録音や文字起こしの完了時、コールログ作成時、取引メモ作成時、取引の直接編集時には実行されません。
</Info>

## プロパティに自動入力を設定する

1. **設定 > 組織設定 > プロパティ** を開きます。
2. **取引** タブを選びます。
3. 自動入力したいプロパティの行をクリックし、編集ダイアログを開きます。

<img src="https://mintcdn.com/medium-3cf2b5dd/dVS8vWQ1A7Pv22Qn/guide/ai/images/property-auto-fill-settings.png?fit=max&auto=format&n=dVS8vWQ1A7Pv22Qn&q=85&s=58096c8ac15a30f7e02cb4f5490e1dcc" alt="取引プロパティ自動入力の設定" width="2048" height="1024" data-path="guide/ai/images/property-auto-fill-settings.png" />

4. **AI自動入力** でモードを選びます(下記参照)。既定値は **オフ** です。
5. 必要に応じて **抽出プロンプト** に AI への具体的な指示を入力します。
6. **保存** をクリックします。
7. 次に保存される商談ログから、そのプロパティに対する自動入力が有効になります。

### モード

| モード         | 動作                                       | 使いどころ                        |
| ----------- | ---------------------------------------- | ---------------------------- |
| オフ          | 自動入力を行いません(既定値)。                         | 手入力で管理したい項目                  |
| 商談ログ時に自動抽出  | 抽出した値を取引へ即座に書き込みます。既存値は上書きされます。          | 次回アクションなど、上書きされてもよい項目        |
| 承認待ち候補として抽出 | 値を候補として保留し、ユーザーが承認したときに反映します。既存値は保持されます。 | 金額・決裁プロセス・競合製品など、レビューを挟みたい項目 |

<Tip>
  金額や成約予定日など誤った値で上書きしたくない項目は「承認待ち候補として抽出」、次回アクションなど AI 任せで十分な項目は「商談ログ時に自動抽出」を選ぶのが目安です。まず「承認待ち候補」で運用を始め、精度が安定してから自動反映に切り替えるのがおすすめです。
</Tip>

## 抽出プロンプトの書き方

抽出プロンプトは空欄でも動作しますが、指示を具体的にすると精度が上がります。

| プロパティ例    | プロンプト例                                            |
| --------- | ------------------------------------------------- |
| ネクストアクション | 営業担当が次に行う具体的な行動を抽出してください。感想や状況描写は含めないでください。       |
| 決裁プロセス    | 決裁者・稟議・承認フローに関する発言を抽出してください。推測は含めないでください。         |
| 競合製品      | 顧客が比較検討している他社製品名だけを抽出してください。複数ある場合はカンマ区切りにしてください。 |

書くときのコツ:

* 抽出範囲を限定する(例: 「決裁プロセスに関する発言のみ」)。
* 良い例と悪い例を並べる。
* 粒度を指定する(例: 「動詞 + 対象で 1 文にまとめる」)。
* 不要な要素を明示する(例: 「相槌や挨拶は除外」)。

## 承認待ち候補を確認する

「承認待ち候補として抽出」を選んだプロパティは、値が即座には反映されず、取引詳細画面のプロパティに **AI 候補あり** のマークが表示されます。

<img src="https://mintcdn.com/medium-3cf2b5dd/dVS8vWQ1A7Pv22Qn/guide/ai/images/property-auto-fill-detail.png?fit=max&auto=format&n=dVS8vWQ1A7Pv22Qn&q=85&s=c6e87dd79d95246af34adffd67a25074" alt="取引詳細でAI候補を確認する画面" width="2048" height="1024" data-path="guide/ai/images/property-auto-fill-detail.png" />

1. マークが付いたプロパティをクリックします。
2. 現在の値・AI が提案する値・提案理由を確認します。
3. 反映する場合は **承認**、反映しない場合は **却下** をクリックします。
4. 承認・却下のどちらを選んでも、その候補は消えます。

<Info>
  未レビューの候補は、同じプロパティに対して新しい候補が生成されるまで残り続けます。古い候補は新しい候補で上書きされます。
</Info>

## 制限と注意点

* **1 商談ログあたりの抽出上限**: 最大 **10 件** のプロパティに対して抽出されます。それ以上に自動入力が有効な場合、自動反映モードのものが優先されます。
* **同じ値の候補は生成されない**: AI が抽出した値が現在の値と同じ場合、候補は表示されません(重複による通知ノイズを防ぐため)。
* **既存値の扱い**: 「商談ログ時に自動抽出」では既存値が上書きされます。「承認待ち候補として抽出」では既存値は保持されます。
* **LLM クレジット**: 自動入力の実行ごとに **取引プロパティ自動入力** カテゴリのクレジットを消費します。利用状況はサイドバーの **利用履歴** で確認できます。

<Tip>
  本当に重要なプロパティに絞って自動入力を有効化すると、抽出上限内で精度と効率を両立できます。すべてのプロパティで有効化すると、ノイズの多い候補が生成されやすくなります。
</Tip>

## トラブルシューティング

| 症状                            | 原因と対処                                                                             |
| ----------------------------- | --------------------------------------------------------------------------------- |
| 候補が生成されない                     | AI が抽出した値が現在の値と同じ、または該当する情報が商談ログ内に見つからない可能性があります。抽出プロンプトを具体化するか、対象の商談ログを確認してください。 |
| SFA から取り込んだプロパティで自動入力を有効化できない | 仕様上、SFA 由来のプロパティは自動入力の対象外です。Stockwork 内で管理するカスタムプロパティを新設して運用してください。               |
| 抽出件数が多い商談で反映されない項目がある         | 1 商談ログあたり最大 10 件までしか抽出されません。優先度の低いプロパティは自動入力を無効にしてください。                           |

## 関連ページ

* [取引](/guide/crm/deals)
* [プロパティ](/guide/crm/properties)
* [商談ログ](/guide/meeting-logs/overview)
* [商談ログ AI 要約](/guide/ai/meeting-summary)