会話メッセージビルダー
チャット補完メッセージ配列をビジュアルなロールベースの編集で構築・テストします
出力JSON(0 ({count}件のメッセージ))
[]
会話メッセージビルダーとは?
会話メッセージビルダーは、AIチャット補完APIで使用されるメッセージ配列をビジュアルに構築するツールです。OpenAIのChat Completions API、AnthropicのMessages API、GoogleのGemini APIを呼び出す際、ロール(system、user、assistant)とコンテンツを持つメッセージの順序付き配列を送信します。このツールでは、JSONを手書きする代わりにビジュアルインターフェースでそれらの配列を構築できます。
メッセージ配列の手書きは面倒でエラーが発生しやすく、特にマルチターン会話、few-shotプロンプティングの設定、複雑なシステムプロンプトの場合はなおさらです。カンマの欠落、引用符の不一致、ロール名の誤りはデバッグが困難なAPIエラーにつながります。このビルダーはロールベースの色分け、並べ替え、リアルタイムJSON出力を備えたビジュアルインターフェースを提供します。
このツールはOpenAI/Google形式(配列内にシステムメッセージ)とAnthropic形式(メッセージからシステムプロンプトを分離)の両方をサポートしています。ワンクリックで形式を切り替え、すぐに使えるJSONをコードに直接コピーできます。
メッセージビルダーの使い方
メッセージ配列の構築はわずか数クリックです:
- メッセージを追加 — 「+ System」「+ User」「+ Assistant」ボタンをクリックしてメッセージを追加します。各ロールは色分けされています:systemは紫、userは青、assistantは緑。
- コンテンツを入力 — 各テキストエリアにメッセージの内容を入力または貼り付けます。入力に応じてJSON出力が自動的に更新されます。
- メッセージを並べ替え — 上下矢印ボタンでメッセージの順序を変更します。ドロップダウンを使ってメッセージのロールを変更することもできます。
- 出力形式を選択 — 形式ドロップダウンから「OpenAI / Google」または「Anthropic」を選択します。Anthropic形式では、システムメッセージが自動的に独立したフィールドに抽出されます。
- JSONをコピー — 「JSONをコピー」をクリックして、フォーマットされた出力をクリップボードにコピーし、コードやAPIテストツールに貼り付けられます。
メッセージロールの理解
チャット補完配列の各メッセージには、モデルがそれをどう解釈するかを指示する特定のロールがあります:
Systemロール
システムメッセージはAIの全体的な動作と制約を設定します。すべての応答に影響する永続的な指示として機能します。一般的なシステムプロンプトには、ペルソナ定義(「あなたはシニア開発者です」)、出力形式の要件(「常にJSONで応答してください」)、安全性の制約(「医療アドバイスは決して提供しないでください」)、またはドメインコンテキストが含まれます。システムメッセージは通常、配列の最初のメッセージです。
Userロール
ユーザーメッセージは人間のユーザーからの入力を表します。モデルが処理すべき質問、指示、またはデータです。マルチターン会話では、会話履歴を作成するためにユーザーメッセージとアシスタントメッセージが交互に配置されます。
Assistantロール
アシスタントメッセージはAIモデルの過去の応答を表します。配列にアシスタントメッセージを含めることで、会話履歴を提供したり、few-shotプロンプティングを実装したりできます — 実際の質問の前に、望ましい入力/出力ペアのサンプルをモデルに示します。
一般的なユースケース
- Few-shotプロンプティング — ユーザーメッセージで入力例を、アシスタントメッセージで望ましい出力例を示す会話サンプルを構築し、モデルにパターンを教えます。
- システムプロンプトのテスト — さまざまなシステムプロンプトを素早くプロトタイプし、最終的なJSONでユーザーメッセージとどう組み合わされるかを確認します。
- APIテスト — JSON を手動でフォーマットせずに、Postman、curl、APIプレイグラウンドなどのツール用のメッセージ配列を生成します。
- プロバイダー間の移行 — プロバイダーを切り替える際に、OpenAIとAnthropic形式間でメッセージ配列を変換します。
- ドキュメント — APIドキュメントやチームのオンボーディング資料用のサンプル会話を構築します。
よくある質問
チャット補完メッセージ配列とは何ですか?
チャット補完メッセージ配列は、OpenAI、Anthropic、GoogleなどのAI APIで使用される入力形式です。各メッセージが「role」(system、user、assistant)と「content」(メッセージテキスト)を持つ、順序付きのメッセージリストです。モデルはこの会話履歴を使用して、文脈に適した応答を生成します。
OpenAIとAnthropicのメッセージ形式の違いは何ですか?
OpenAIはメッセージ配列内にrole: "system"のシステムメッセージを直接含めます。Anthropicはシステムプロンプトをメッセージ配列の外にある専用の「system」パラメーターに分離し、メッセージ配列には「user」と「assistant」ロールのみを含めます。このビルダーは出力形式を切り替える際にこの変換を自動的に処理します。
システムメッセージは何をしますか?
システムメッセージはAIモデルの動作、性格、制約を設定します。会話の前に処理され、永続的な指示として機能します。一般的な用途として、アシスタントのロール定義(「あなたはカスタマーサポート担当者です」)、出力形式の要件設定、安全ガイドラインの確立などがあります。すべてのAPI呼び出しにシステムメッセージが必要なわけではありませんが、本番アプリケーションでは推奨されます。
メッセージの順序が重要な理由は?
メッセージの順序は会話の流れを定義します。モデルはメッセージを順次処理し、順序がコンテキストの解釈に影響します。システムメッセージを最初に、その後にユーザーとアシスタントのメッセージを交互に配置する必要があります。メッセージを順序通りに配置しない場合(例:アシスタントの応答なしにユーザーメッセージが2つ連続する)、モデルが混乱したり、プロバイダーによってはAPIエラーが発生したりする可能性があります。
このビルダーでマルチターン会話を構築できますか?
はい。ビルダーは無制限のメッセージをサポートしており、マルチターン会話履歴の構築に最適です。ユーザーとアシスタントのメッセージを交互に追加して完全な会話をシミュレーションし、結果のJSONをAPI呼び出しやプロンプトチェーンのテストに使用できます。
関連ツール
AI APIの構築に役立つその他のツールもご覧ください:
- プロンプト形式コンバーター — OpenAI、Anthropic、Googleのプロンプト形式間で変換
- ツール/関数定義リンター — Function Calling用のツール定義を検証
- AI向けJSONスキーマジェネレーター — 構造化出力用のスキーマを生成