kintone Plugin Guide
kintone画像解析プラグイン(OpenAI対応版)
kintone のレコードに添付された画像を OpenAI の AI に送信して OCR 解析し、読み取り結果を指定フィールドへ自動で書き込むプラグインです。PC・モバイルの両方に対応しています。
できること
- 添付ファイルフィールド内の画像ファイルをワンクリックで AI に送信し、OCR の読み取り結果を自動で受け取れます
- 画像の内容要約と文字抽出をまとめて行えます。複数画像を添付した場合もまとめて解析できます
- AI の役割や出力ルールをシステムプロンプトで固定できるため、用途に応じた出力形式に合わせやすくなります
- 思考の深さ（Reasoning）を調整でき、用途に応じて回答の精度とスピードのバランスを変えられます
- PC・モバイル両方のレコード詳細画面で利用でき、解析後は編集画面へ移動して出力フィールドに結果を反映できます
事前準備（kintone アプリ側）
プラグインを使う前に、kintone アプリのフォームで以下の 3 つを用意してください。
- 画像添付用フィールド — 画像を添付する「添付ファイル」フィールド（例: フィールドコード
Attachment） - 出力用フィールド — OCR の読み取り結果が書き込まれるフィールド（例: 複数行テキスト、フィールドコード
Answer） - スペース（要素ID付き） — 「AIで画像を処理」ボタンを表示する場所です。フォームに「スペース」部品を配置し、要素ID を設定してください（例:
ai-button）
補足: ここでいう「スペース」は、フォーム上に配置するスペース部品のことです。kintone の「スペース」機能（コミュニケーション用）とは別物ですのでご注意ください。添付ファイル内に画像以外のファイルがある場合はスキップされ、画像ファイルのみを対象に解析します。
プラグインの設定項目
| 設定項目 | 内容 |
|---|---|
| APIキー | OpenAI の API キー（sk- で始まる文字列） |
| モデル | 使用する AI モデル（現状は gpt-5.2 のみ選択可） |
| 思考の強さ | 任意設定。none / low / medium / high / xhigh から選択。高いほど深く考えますが、応答に時間がかかります |
| システムプロンプト | AI への事前指示（画像の読み取り方、出力形式、禁止事項、口調など）。未入力の場合は画像解析向けの既定プロンプトが適用されます |
| 添付ファイルフィールドコード | 画像が添付される「添付ファイル」フィールドのフィールドコード |
| 出力フィールドコード | OCR の読み取り結果を書き込むフィールドのフィールドコード（複数行テキスト推奨） |
| スペースID | ボタンを表示するスペース部品の要素ID |
キーの管理: API Key は必要最小限の権限で発行し、定期的にOpenAIのダッシュボードからAPIの利用状況を管理することを推奨します。不要になったキーは OpenAI のダッシュボードから速やかに無効化してください。
使い方
- レコードに画像を添付して 保存 する（複数画像も可）
- レコードの 詳細画面 を開く（PC / モバイル）
- フォーム上に表示される 「AIで画像を処理」 ボタンを押す
- 添付ファイルから画像のみが抽出され、OpenAI に送信されて解析されます
- 解析完了後、編集画面へ自動遷移 し、出力フィールドに結果が入力されます
- 内容を確認して 保存 する
ご注意ください
- 情報の取り扱い: 添付した画像の内容は OpenAI のサーバーに送信されます。機密情報や個人情報を送信してよいか、社内のルール・規定を必ず確認してください。
- 利用料金: OpenAI API は従量課金制です。利用量に応じて費用が発生します。
- 画質 / 内容: 低解像度・ぼけ・傾きのある画像や、文字が小さい画像は OCR 精度が下がる場合があります。できるだけ鮮明な画像をご利用ください。
- 添付ファイルの種類: 添付ファイルフィールドに画像以外のファイルだけが入っている場合、解析できません。画像ファイルが含まれていることを確認してください。
- 権限: 結果を書き込むため編集画面へ遷移します。利用ユーザーに編集権限がない場合は保存できません。
- 設定ミスにご注意: スペースの要素ID やフィールドコードが間違っていると、ボタンが表示されない・書き込みエラーになるなどの不具合が起きます。
- 対応画面: ボタン表示はレコード詳細画面です。一覧画面では動作しません。