会話メッセージビルダー

チャット補完メッセージ配列をビジュアルなロールベースの編集で構築・テストします

~/message-builder
追加:
#1
#2

出力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をコードに直接コピーできます。

メッセージビルダーの使い方

メッセージ配列の構築はわずか数クリックです:

  1. メッセージを追加 — 「+ System」「+ User」「+ Assistant」ボタンをクリックしてメッセージを追加します。各ロールは色分けされています:systemは紫、userは青、assistantは緑。
  2. コンテンツを入力 — 各テキストエリアにメッセージの内容を入力または貼り付けます。入力に応じてJSON出力が自動的に更新されます。
  3. メッセージを並べ替え — 上下矢印ボタンでメッセージの順序を変更します。ドロップダウンを使ってメッセージのロールを変更することもできます。
  4. 出力形式を選択 — 形式ドロップダウンから「OpenAI / Google」または「Anthropic」を選択します。Anthropic形式では、システムメッセージが自動的に独立したフィールドに抽出されます。
  5. 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の構築に役立つその他のツールもご覧ください:

関連ツール