kintone Plugin Guide
kintone GPT Plugin（OpenAI Responses API 対応）
kintone のレコード画面に「AIに問い合わせ」ボタンを追加し、フィールドに入力した内容を OpenAI の AI に送信、その返答を別のフィールドへ自動で書き込むプラグインです。PC・モバイルの両方に対応しています。
できること
- フィールドに入力した文章をワンクリックで AI に送信し、返答を自動で受け取れます
- AI の役割や口調、出力ルールをあらかじめ固定できるため、毎回同じ指示を書く必要がありません
- 思考の深さ（Reasoning）を調整でき、用途に応じて回答の精度とスピードのバランスを変えられます
事前準備（kintone アプリ側）
プラグインを使う前に、kintone アプリのフォームで以下の 3 つを用意してください。
- 入力用フィールド — AI に送りたい文章を入力するフィールド（例: 複数行テキスト、フィールドコード
CONTENT） - 返信用フィールド — AI の返答が書き込まれるフィールド（例: 複数行テキスト、フィールドコード
REPLY） - スペース（要素ID付き） — 「AIに問い合わせ」ボタンを表示する場所です。フォームに「スペース」部品を配置し、要素ID を設定してください（例:
gpt_space）
補足: ここでいう「スペース」は、フォーム上に配置するスペース部品のことです。kintone の「スペース」機能（コミュニケーション用）とは別物ですのでご注意ください。
プラグインの設定項目
| 設定項目 | 内容 |
|---|---|
| APIキー | OpenAI の API キー（sk- で始まる文字列） |
| モデル | 使用する AI モデル（gpt-5.2（推奨）/ gpt-5.2-pro / gpt-5.1 など） |
| Thinking/Reasoning | 任意設定。none / low / medium / high / xhigh から選択。高いほど深く考えますが、応答に時間がかかります |
| システムプロンプト | AI への事前指示（出力形式、禁止事項、口調など）。未入力の場合は既定の指示が適用されます |
| 入力フィールドコード | AI に送信する内容が入っているフィールドのフィールドコード |
| 出力フィールドコード | AI の返答を書き込むフィールドのフィールドコード |
| スペースID | ボタンを表示するスペース部品の要素ID |
キーの管理: API Key は必要最小限の権限で発行し、定期的にOpenAIのダッシュボードからAPIの利用状況を管理することを推奨します。不要になったキーは OpenAI のダッシュボードから速やかに無効化してください。
使い方
- レコードの 新規作成 または 編集 画面を開く（PC / モバイル）
- フォーム上に表示される 「AIに問い合わせ」 ボタンを押す
- 入力フィールドの内容が AI に送信され、返答が返信フィールドに自動入力されます
ご注意ください
- 情報の取り扱い: 入力した内容は OpenAI のサーバーに送信されます。機密情報や個人情報を送信してよいか、社内のルール・規定を必ず確認してください。
- 利用料金: OpenAI API は従量課金制です。利用量に応じて費用が発生します。
- 設定ミスにご注意: スペースの要素ID やフィールドコードが間違っていると、ボタンが表示されない・書き込みエラーになるなどの不具合が起きます。
- 対応画面: レコードの新規作成・編集画面のみ対応です。レコード詳細（閲覧）画面では動作しません。