> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# プロンプトのヒント

> 最小限のプロンプトエンジニアリングで、Sonic から自然な出力を得られます。

Sonic 3.5 は、最小限のプロンプトエンジニアリングで自然に聞こえるよう設計されています。ほとんどの場合、原稿をそのまま渡すだけで、正規化・ペース・表現はモデルが処理します。以下のヒントは Sonic ファミリー全体に適用され、Sonic 3.5 と Sonic 3 で異なる点については、該当する箇所でその都度示します。

## 推奨事項

* **自然で句読点が正しく付いたテキストを渡してください。** 通常の大文字小文字と句読点を使った完全な文が、最良のペースとイントネーションを生み出します。各原稿は終止符 (`.`、`?`、`!`) で終えてください。
* **数値、日付、時刻、一般的な略語は、特別な理由がない限り従来の書き言葉の形で渡してください。** 以下のリストは、**原稿に入れる例 (または LLM に出力させる例)** であり、「フォーマットを無視する」ことを示すものではありません。通常のテキスト正規化が有効になっている場合、Sonic はほとんどの入力でこれらのパターンを自然な音声にマッピングします。

  * `1,234,567` のような大きな数値
  * 米国の電話番号: `(415) 555-1212`
  * メールアドレス: `user@example.com`
  * `MM/DD/YYYY` (ロケールに応じて `DD/MM/YYYY`) 形式の日付: `04/20/2025`
  * AM/PM の前にスペースを入れた時刻: `7:00 PM`、`7 PM`、`7:00 P.M.`
  * 一般的な略語 (`NASA`) や頭字語 (`USA`)

  記号は自然に処理されます。`@` は `at` と読まれ (メールアドレス)、`()` は読み上げられません (電話番号)。

  **LLM** がこのテキストを生成する場合は、以下の [**ボイスエージェント (LLM 生成テキスト)**](#voice-agents-llm-authored-text) を参照して、正規化、任意のバイパス設定、システムプロンプトがどう連携するかを確認してください。
* **ボイスを言語に合わせてください。** 各ボイスには最適な主要言語があります。特定の言語のボイスを試すには [プレイグラウンド](https://play.cartesia.ai) を使用してください。
* **プロンプトは自然な書き言葉の形のまま維持してください。** 強力な前処理 (句読点の除去、すべて大文字化など) は一般的に出力品質を下げます。

## ペースとスペリングの制御

確認コード、注文 ID、シリアル番号、スペルアウトされた名前など、1 文字ずつ読み上げる必要があるときや、細かいペース制御が必要なときは、次のいずれかを使用してください。

1. **Spell タグ (推奨)。** 文字列を `<spell>...</spell>` で囲みます。最も信頼性の高い選択肢で、すべてのサポート言語で文字、数字、英数字混在のいずれにも対応します。
   ```
   Your confirmation code is <spell>AB12CD</spell>.
   ```
2. **スペース区切り文字。** タグを使いたくない場合は、各文字を半角スペースで区切ります。
   ```
   Your code is A B C 1 2 3.
   ```
3. **グループ間のポーズにはカンマ。** 人間が自然にポーズする位置にカンマを使用します。
   ```
   Your code is A B C, 1 2 3.
   ```

<Note>
  **Sonic 3 から移行する場合:** Sonic 3.5 では推奨される区切り形式が変更されました。文字間にカンマ、グループ間にピリオドを使う代わりに、**文字間にスペース**、**グループ間にカンマ**を使ってください。古い形式は引き続き `sonic-3` のスナップショットでは動作しますが、今後は推奨されません。
</Note>

| シナリオ             | 旧 (Sonic 3)         | 新 (Sonic 3.5)  |
| ---------------- | ------------------- | -------------- |
| 文字 `HELLO` をスペル  | `H, E, L, L, O`     | `H E L L O`    |
| 数字 `123456` をスペル | `1, 2, 3, 4, 5, 6`  | `1 2 3 4 5 6`  |
| 確認コード `ABC123`   | `A, B, C. 1, 2, 3.` | `A B C, 1 2 3` |

## ボイスエージェント (LLM 生成テキスト)

**言語モデル**が原稿を書く場合 (たとえばボイスエージェント) は、[**ペースとスペリングの制御**](#controlling-pacing-and-spelling) と同じ spell タグおよびスペースルールを適用してください。以下に追加のガイドラインを示します。

* **何を出力するか。** [**推奨事項**](#recommendations) では、Sonic 向け (または LLM に出力させる) **文字どおりのテキスト形**を挙げています。`12%`、一般的な電話やメールのレイアウト、典型的な日付などです。これらの形を**意図的にシステムプロンプト内で繰り返す**ことは普通であり、動作の予測可能性が保たれます。本ドキュメントはあいまいなままにすることを推奨しているわけではありません。
* **正規化と明示性。** **テキスト正規化**が有効な場合 (一般的なデフォルト)、これらの従来形式は **すべてを散文でスペル化することなく** 自然に読み上げられることが多いです (たとえば `12%` を「twelve percent」と書き換えるなど)。一部の統合やベンダーでは、遅延や制御のために**正規化をスキップまたはバイパス**するオプションを公開しています。そのオプションを使う場合は、代わりにより**明示的な発話表現**を計画してください。読み間違いが繰り返される場合は、[カスタム発音](#pronunciation)を追加するか、長い包括的なプロンプトの前に **限定的な** LLM ルールを追加してください。
* **プロンプトのサイズ:** テストに合格する最小のシステムプロンプトを優先してください。パイプライン設定を変更したり、新しいエッジケースが発生したときに拡張します。
* **コードや ID:** クライアントがタグを Sonic に渡せる場合は `<spell>...</spell>` を推奨します。そうでない場合は、文字間にスペース、グループ間にカンマを使用します ([**ペースとスペリングの制御**](#controlling-pacing-and-spelling))。**NATO フォネティック** (`Alpha`、`Bravo`) は、**聞き手**が文字を明確に区別する必要があるときに有効な選択肢です (モデルもうまく扱えることが多いです)。Sonic のペースとタグ動作で最も**決定論的**なのは `<spell>` とスペース形式です。
* **24 時間表記の時刻:** 一部のロケールでは、24 時間表記の時刻 (例: `14:30`) が音声化される際により口語的な 12 時間形式に正規化されることがあります。英語とヒンディー語は他の言語と同じようには動作しません。今後はより厳密な「書かれたとおりに読む」動作などのオプションに向けて進化していく予定です。時刻の数字どおりに音声化したい場合は、ターゲット言語とボイスで検証し、システムプロンプトや[カスタム発音](#pronunciation)を調整してください。
* **マークダウンおよび機械的なテキスト:** 返信がそのまま読み上げられる場合、マークダウン (リスト、`#` ヘッダー、`**太字**`)、生の **JSON**、**絵文字**、TTS が奇妙に読み上げる可能性のある記号や特殊文字は避けてください。ただし、クライアントが Sonic に渡す前にそれらを除去・正規化する場合は除きます。多くのチームは、箇条書き、`*`、発話されない句読点をカバーする 1 つのルールを使用しています。
* **ストリーミング:** トークンを TTS にストリーミングする場合は、下記の **ストリーミング**にあるように[継続](#streaming)を使用してください。

**スタータシステムプロンプト (v1)。** あなたの製品に合わせて貼り付けて削るためのベースラインです。スタックが `<spell>` などのタグを Sonic に渡さない場合は、spell タグの行を省略し、スペース形式のフォールバックのみを使用してください。

```text theme={null}
You are a voice agent. Everything you output will be spoken aloud by Cartesia Sonic text-to-speech.

Goals:
- Sound natural: full sentences, normal capitalization, end with . ? or !
- Prefer conventional written forms when your pipeline keeps text normalization on: numbers, dates, common acronyms, typical US phones like (415) 555-1212, emails like user@example.com, symbols like 12%. You may still spell amounts or symbols in words in the system prompt if you want that behavior every time.
- For confirmation codes, reference numbers, or mixed IDs: use <spell>...</spell> when supported, else Sonic 3.5 spaced style (A B C, 1 2 3). NATO phonetics are fine when listener clarity matters.
- Avoid markdown, raw JSON, emoji, special characters, and other stray symbols in spoken output unless your client strips them; write plain prose.
- For unusual proper nouns or product names that misread, give a short spoken-friendly form or rely on app-level pronunciation settings when available.
```

## ポーズの挿入

Sonic はカンマやピリオドのような自然な句読点を尊重します。より長いポーズや特定の場所でのポーズが必要な場合は、[break タグ](/build-with-cartesia/capability-guides/ssml-tags#pauses-and-breaks)を使用してください。break タグは 1 文字としてカウントされ、前後に空白は不要です。

## 発音

固有名詞、商標、ドメイン固有の用語、あるいは同じスペルを区別したいとき (例: 都市名の *Nice* と形容詞の *nice*) には、[カスタム発音](/build-with-cartesia/capability-guides/custom-pronunciations)を使用してください。

## ストリーミング

連続的に聞こえる必要のある音声チャンクを生成するとき (たとえば LLM のストリーム出力)は、[継続](/build-with-cartesia/capability-guides/stream-inputs-using-continuations)を使用してください。これにより、チャンク境界を越えてもプロソディとボイスの一貫性が保たれます。