出力フォーマットとは?
Telvrに話しかけると、2つのことが起こります。まず、あなたの声はWhisper(最も正確な音声認識モデルの1つ)で文字起こしされます。次に、その生のトランスクリプトがAIエンリッチメントステップに渡されて、洗練された構造化テキストに変換されます。
出力フォーマットは、その2番目のステップを管理する指示です。AIが何であるべきか、どのように振る舞うべきか、入力コンテキストが何であるか、最終結果がどのようなものであるべきかを伝えます。技術的には、出力フォーマットはシステムプロンプト——AIがあなたのトランスクリプトを処理する前に読む一連の指示です。
Telvrには、最も一般的なユースケースをカバーする6つの組み込み出力フォーマットが付属しています。
- クリーンアップ — フィラーワードを削除し、文法を修正して、クリーンな文章を生成
- メール — 口述されたコンテンツを件名行と挨拶を含むプロフェッショナルなメールに構造化
- 議事録 — 話された内容を決定事項、アクションアイテム、次のステップに整理
- 要約 — より長いスピーチを2〜3文の要約に圧縮
- プロンプティング — 話されたアイデアを要件と受け入れ基準を含む開発タスクとして構造化
- カスタム — ゼロから書いたあなた自身の出力フォーマット
カスタムモードは、出力フォーマットが強力になる場所です。日常的なスタンドアップアップデート、法務メモの口述、カスタマーサポート応答、ソーシャルメディアキャプション、または定期的に口述するその他のものなど、任意のワークフロー用に独自のテンプレートを定義できます。
4つのテンプレートセクション
すべての出力フォーマットテンプレートは、一貫した4つのセクション構造に従います。各セクションには特定の目的があり、それらは一緒にAIに信頼性の高い、高品質な出力を生成するために必要なすべてを与えます。
Role(役割)
Roleセクションは、このテンプレートのためのAIが誰かを定義します。スペシャリストを雇うことを考えてみてください。どのような専門知識を引き出すべきか、どのペルソナを採用すべきかをAIに伝えています。
# Role
You are a professional email writer who converts spoken messages into well-structured, polished emails.
明確に定義された役割は、全体的な出力を形作ります。「プロフェッショナルなメールライター」と言われたAIは、各ルールの明示的な指示を必要とせずに、適切なトーン、フォーマッティング規則、単語選択をデフォルトで使用します。「簡潔なテクニカルライター」のような役割は、自然に精度と簡潔性を好みます。
役割は1〜2文に保ちましょう。専門分野と平易な言葉でのコアタスクを述べてください。
Instructions(指示)
Instructionsセクションは、ルールを定義する場所です。これは最も重要なセクション——AIが正確に何をするべきか、何を避けるべきか、エッジケースに遭遇したときにどのように振る舞うべきかをAIに伝えます。
指示を箇条書きリストとしてフォーマットしてください。各項目は単一の明確なルールを説明する必要があります。
3つのルールは、目的に関わらず、すべてのテンプレートに属しています。
# Instructions
- [タスク固有のルールをここに入力]
- Respond in the same language as the input text.
- Do not add explanations, headers, or meta-commentary.
- Do not wrap output in markdown code blocks.
最後の3つはユニバーサルデフォルトです。「入力テキストと同じ言語で応答する」は、口述した言語と出力が一致することを保証します。言語を切り替える場合に重要です。「説明やメタコメントを追加しない」は、実際の出力の前に「こちらがあなたのメールです」のようなものを頭に付けられることをAIが防ぎます。「マークダウンコードブロックで出力をラップしない」は、出力が3つのバッククォートで囲まれることを防ぎます。
必要に応じてタスク固有のルールを追加できますが、合計で10個以下に保つようにしてください。それ以上になると、ルール同士が互いに競合し始めます。
Context(コンテキスト)
Contextセクションは、状況に関するバックグラウンド情報を提供します。これはオプション——すべてのテンプレートがそれを必要とするわけではありません——ですが、口述された入力の特異性をAIが処理するのに役立ちます。
# Context
The user dictates messages via push-to-talk. Input may contain filler words, repetitions, and incomplete sentences.
Contextは次の場合に有用です。
- 入力は、AIが説明すべき予測可能な特性を持っている(フィラーワード、不完全な文、ドメイン固有の専門用語)
- 出力は、暗黙的な規約を持つ特定の環境で使用される(会社のSlack、法務ドキュメントシステム)
- AIが話者と意図された受信者の関係を理解する必要がある
ユースケースが簡単で、Instructionsセクションが既にすべてをカバーしている場合は、Contextセクション全体をスキップしてください。
Expected Output(期待される出力)
Expected Outputセクションは、最終結果の形を説明します。AIに出力するフォーマット、長さ、構造を伝えます。
# Expected Output
A professional email with:
- Subject line
- Greeting
- Body (1-3 paragraphs)
- Professional sign-off
このセクションは、品質ターゲットとして機能します。AIは、ここで説明するものに一致するように出力を構造化します。特定のフォーマット——箇条書きリスト、番号付きステップ、特定のヘッディング構造——を望む場合は、ここで明示的に説明してください。
ブランクテンプレート
新しい出力フォーマットの開始点として、これを使用してください。
# Role
[Describe the assistant's expertise and persona.]
# Instructions
- [Primary task instruction]
- [Additional requirement]
- [Formatting preference]
- Respond in the same language as the input text.
- Do not add explanations, headers, or meta-commentary.
- Do not wrap output in markdown code blocks.
# Context
[Optional background information. Remove if not needed.]
# Expected Output
[Describe what the output should look like.]
Download Blank Template
ベストプラクティス
プロンプトエンジニアリングから出力フォーマットテンプレートに直接適用される6つの原則。
1. 数量と制約について具体的であること。 「2〜3文で書く」は「短く保つ」より良いです。「最大5つの箇条書きを使用する」は「簡潔にする」より良いです。あいまいな指示は、AIがあなたの意図と一致しない方法で解釈する余地を残します。
2. 2つの参照ポイントでトーンを定義すること。 「プロフェッショナルだが親しみやすい」は「プロフェッショナル」だけより有用です。これは下限と上限の両方を定義するためです。同様に「フォーマルだが堅苦しくない」または「カジュアルだがふざけていない」は、単一のあいまいなターゲットではなく、AIが作業する範囲を与えます。
3. 期待される出力に例を含めること。 言うだけでなく、見せてください。特定のフォーマットを望む場合は、構造的に説明して、役立つ場合には小さな例を含めてください。「アクション動詞で始まる件名行、例:'Request: Server Access by Friday'」は「良い件名行」より明確です。
4. 「何をしないか」で明示的な境界を設定すること。 3つのユニバーサルデフォルトルールは最も一般的な問題をカバーしていますが、テンプレートは追加の境界が必要な場合があります。口述が接線を含むことが多い場合は、「メインリクエストに無関係なコンテンツを含めないでください」を追加します。フォーマッティング文字なしのクリーンな出力を望む場合は、「箇条書きまたはヘッダーを使用しないでください」を追加します。
5. 各テンプレートを単一のタスクに焦点を当てること。 メールかつ議事録かつ要約を処理しようとするテンプレートは、それぞれを不正に処理します。1つのテンプレート、1つの出力タイプ。複数の異なるユースケースがある場合は、複数のテンプレートを作成して、クリックして切り替えます。
6. シンプルに開始して繰り返すこと。 3〜4つのルールだけで最初のバージョンを書いて、実際の口述に対してテストします。実際に出力の問題に遭遇したときだけルールを追加してください。15のルールで過剰エンジニアリングされたテンプレートは、ルール同士が互いに矛盾し始めるため、5つのリーンテンプレートより悪いパフォーマンスを出すことがよくあります。
例:ブログ投稿ドラフト
# Role
You are a content writer who transforms spoken ideas into blog post drafts.
# Instructions
- Convert the spoken input into a structured blog post draft.
- Add a compelling title.
- Break the content into logical sections with subheadings.
- Maintain a conversational but informative tone.
- Respond in the same language as the input text.
- Do not add explanations, headers, or meta-commentary.
- Do not wrap output in markdown code blocks.
# Expected Output
A blog post draft with:
- Title (H1)
- 2–4 sections with subheadings (H2)
- 200–400 words total
このテンプレートは、思いやりをする必要があります。意識の流れのスタイルで大声でアイデアを話す内容作成者のための便利です。テンプレートはそれらを発行可能なドラフト構造に形作ります。
例:Slackメッセージ
# Role
You are a concise communicator who converts spoken messages into Slack-appropriate messages.
# Instructions
- Keep messages brief and scannable.
- Use emoji sparingly but naturally.
- Break longer messages into short paragraphs.
- If the message contains action items, format them as a checklist.
- Respond in the same language as the input text.
- Do not add explanations, headers, or meta-commentary.
- Do not wrap output in markdown code blocks.
# Expected Output
A casual but clear Slack message, 1–3 short paragraphs maximum.
このテンプレートはSlackコミュニケーション規範を反映しています。短い段落、時折のemojiです。チェックリスト指示は関連がある場合のみアクティブになります——AIはメッセージがタスクを含むときを認識し、それに応じてフォーマットします。
よくある間違い
1. あいまいすぎる 「より良くする」または「テキストを改善する」はAIに方向性を与えません。出力フォーマットは具体的で実行可能な指示を持つときに最も適切に機能します。「より良い」の意味を言葉にできない場合、AIもできません。
2. 多すぎるルール 20の指示を持つテンプレートは内部紛争を作成します。1つのルールが「簡潔に」と言い、別のルールが「完全なコンテキストを含める」と言う場合、AIはどちらが優先されるかを推測する必要があります。ルール数を10以下に保ち、すべての紛争を明示的に解決してください。
3. 言語ルールを見逃す 常に「入力テキストと同じ言語で応答する」を含めてください。これがないと、AIは口述した言語に関わらずEnglishをデフォルトにすることができます。言語によって一句のSlack メッセージをフランス語の同僚に、ドイツ人のクライアントへのメールを切り替える場合に重要です。
4. 期待される出力を忘れる Expected Outputセクションなしでは、AIは構造を推測します。時々推測が正しいです。多くの場合、類似の入力で一貫しない結果を生成します。明示的に目的の出力フォーマットを説明すると、その差異が排除されます。
5. 最初から過剰エンジニアリング 新しいユーザーは、何かをテストする前にすべてのエッジケースを予測しようとすることがあります。意図をキャプチャする最も簡単なバージョンを書き、実際の口述から10回実行して、実際に観察する問題に対してのみルールを追加します。テンプレートは反復的です——使用とともに改善されます。
開始する
下のブランクテンプレートをダウンロードして、Telvrを開いて、カスタムモードテンプレートフィールドに貼り付けます。Roleと少数のInstructionsで始めて、実際の口述から実行してテストします。最も有用なテンプレートは、一握りの繰り返しから生じます。書く、テスト、改良。
ブランクテンプレートはあなたが形作るためのものです。Telvrは残りを処理します。
Download Blank Template