WaveformにはAIアシスタントが搭載されています。これはEditサイドバーに常駐するチャットパネルで、普通の言葉でAIと会話し、プロジェクトの手助けを依頼できます。Waveformの使い方を質問したり、MIDIを生成させたり、制作のヒントをもらったり、さらにはマクロの作成やキーボードショートカットの割り当てなどの操作を代わりに実行させたりできます。セッションをまたいでメモリを保持するため、使い続けるうちにあなたの作業の好みを覚えていきます。

このアシスタントは、ご自身のコンピューター上で動作するのではなく、クラウドAIサービス（OpenAI または Anthropic）によって動作します。これには使い始める前に理解しておくべき2つの重要な影響があり、詳細は後述します。アシスタントはあなたのメッセージとプロジェクトに関する情報をインターネット経由でそのサービスに送信し、またあなた自身のAPIキーに対して課金されます。どちらも隠されてはいませんが、頼る前に目を通しておく価値があります。

📝 メモ：AIアシスタントはWaveform 14の機能です。また、有効化する必要があり、応答するにはAPIキーが必要です。下記の「セットアップ」を参照してください。

セットアップ（Getting set up）

アシスタントが何かを行う前に、2つのことが必要です：

• アシスタントを有効にする。Settingsタブを開き、左のリストから AI を選び、Enable AI Assistant をオンにします。これによりEditサイドバーにAssistantパネルが表示されます。
• APIキーを登録する。同じ Settings > AI ページで AI Provider（OpenAI または Anthropic）を選び、そのプロバイダーのAPIキーを貼り付けます。キーはアシスタントがサービスと通信するためのものであり、プロバイダーが課金に使うものです。

AI設定ページの完全な詳細（プロバイダーの選択、キーの入手先、アシスタントのファイルを開くボタン）は「Reference: Settings > AI」で解説します。この章は、セットアップ後のアシスタントの使い方についてです。

すべての準備が整う前にAssistantパネルを開くと、パネルが不足しているものを教えてくれます：

• 「API key missing, please enter on the settings page」 — まだキーを入力していません。
• 「Validating API Key」 — 入力したキーをWaveformが検証中です。
• 「Invalid API key, please check on the settings page」 — キーが拒否されました。設定ページで確認してください。

パネルを開く（Opening the panel）

有効にすると、アシスタントはEditサイドバーにAssistantタブとして表示されます。クリックしてチャットパネルを開きます。専用のキーボードショートカットはなく、他のサイドパネルと同じようにサイドバーから開きます。

アシスタントとのチャット（Chatting with the assistant）

パネルは一般的なチャットと同じように動作します。下部のメッセージボックスにリクエストを入力して送信します。アシスタントは上の会話欄で、回答をストリーミングしながら返信します。

• メッセージを送る — リクエストを入力して送信します。質問（「trackをfreezeするには？」）も、アクションの依頼（「4小節のドラムパターンを作って」）もできます。
• 応答をキャンセルする — 長い応答の途中で十分だと思ったら、完了を待たずに途中でキャンセルできます。
• 新しいスレッドを開始する — 話題を変えて前の文脈を引き継がないようにしたいときは、新しい会話を始めます。（/clear スラッシュコマンドでも同じことができます。）
• 保存された会話 — チャットは自動的に保存され、会話リストから以前のものを開き直して続きから再開したり、アシスタントの回答を見返したりできます。

どのAIモデルに回答させるかも選べます。モデルセレクターには、メッセージごとに適切なモデルをWaveformが自動で選ぶ auto オプションがあり、応答の調整用にtemperatureやreasoning effortなどのコントロールもあります。

スラッシュコマンド（Slash commands）

メッセージの先頭で / を入力すると、よく使うリクエストのショートカットであるスラッシュコマンドが表示されます。組み込みコマンドは次のとおりです：

• /help — アシスタントが手伝える内容を説明させます。
• /info <topic> — 特定のトピックについて詳細な情報を得ます。
• /clear — 新しい会話を始めます。
• /generate_midi <description> — 与えた説明からMIDIシーケンスを生成します。
• /production_tips <topic> — トピックに関する制作のヒントを得ます。

独自のコマンドを追加することもできます。カスタムコマンドフォルダー（Settings > AI からアクセス可能）に入れたものは、組み込みコマンドと並んでアシスタントが認識するスラッシュコマンドになります。

結果を活用する（Working with the results）

アシスタントがプロジェクトで使えるもの（MIDIシーケンス、プラグインプリセット、ループやサンプル）を生成すると、会話内にドラッグ可能な結果チップとして現れます。チップをチャットから直接ドラッグし、ブラウザーからアイテムをドラッグするのと同じようにトラックにドロップします。たとえば生成されたMIDIシーケンスは、新しいMIDIクリップとしてトラックにドロップされます。

アシスタントがスクリプトを生成した場合、チップからその場で実行するか、あとで使うためにライブラリに保存するかを選べます。

アシスタントにできること（What the assistant can do）

質問に答えるだけでなく、アシスタントはWaveformやプロジェクトに対して代わりに操作を行えます。できることの一例：

• ユーザーマニュアルを検索して「どうやって…」の質問に答える。
• 説明からMIDIシーケンスを生成する。
• 制作のヒントを提供する。
• マクロの作成・実行（Macrosの章で説明するJavaScriptマクロと同じもの）。
• キーボードショートカットの割り当てと削除。
• ライブラリからプリセット、ループ、サンプルを検索する。
• 自身のスラッシュコマンドやSkills（アシスタントに与えられる再利用可能な能力）を管理する。
• 永続メモリファイルを読み書きして、セッションをまたいで情報を覚える。

アシスタントが見えているもの（What the assistant can see）

実際に行っている作業に即した支援をできるように、アシスタントにはメッセージごとにプロジェクトのコンテキストが与えられます。これには通常、テンポと拍子、キーとスケール、Chord Trackの進行、アレンジャーセクション、現在選択しているクリップやプラグイン、Project Infoフィールドの内容などが含まれます。だからこそ、「これは何のキー？」といった質問に答えたり、すべてを明示せずに「選択したクリップ」に作用したりできるのです。

この同じコンテキストがクラウドプロバイダーに送信される内容の一部であることに注意してください（下記の「プライバシーとコスト」を参照）。

永続メモリ（Persistent memory）

アシスタントは、会話の間で覚えておく価値があると判断したメモを保存するメモリファイルをディスク上に保持します。これにより、あるセッションから次のセッションへ文脈を引き継げます。Settings > AI の Show Memory ボタンから、覚えている内容を自分で開いて確認・編集・消去できます。

プライバシーとコスト（Privacy and cost）

アシスタントはローカルではなくサードパーティのクラウドサービスによって動作するため、常に次の2点が当てはまり、心に留めておく価値があります：

⚠️ プライバシー：メッセージを送信するたびに、あなたのメッセージと上記のプロジェクトコンテキスト（選択クリップのメモ、プラグイン情報、アシスタントのメモリの内容を含むことがある）が、選んだAIプロバイダー（OpenAI または Anthropic）にインターネット経由で送信されます。このデータはあなたのコンピューターを離れます。そのプロバイダーに送信しても問題ないと思えない内容は、チャットやアシスタントが読める場所に入れないでください。

⚠️ コスト：アシスタントはあなた自身のOpenAIまたはAnthropicのAPIキーを使用し、これらのプロバイダーは使用量（通常は処理したテキスト量単位）に応じて直接課金します。Waveformは独自の共有AIサービスを運営せず、このコストを肩代わりしません。使用量はプロバイダーがあなたのアカウントに課金します。

⚡ 注意すべき点（Things to Watch Out For）

• アシスタントは、有効化されかつ有効なキーがあるまで応答しません。Enable AI Assistant をオンにするのは半分だけで、Settings > AI ページでプロバイダーと有効なAPIキーも必要です。パネルが不足部分を教えてくれます。
• Waveform 14の機能です。AssistantパネルはWaveform 14にのみ表示されます。
• あなたのメッセージとプロジェクトコンテキストはマシンを離れます。アシスタントはクラウドサービスです。チャットは第三者に送信するものとして扱い、機密情報に注意してください。
• 使用分の料金はあなたが支払います。使用量はあなた自身のAPIキーに対してプロバイダーが課金するため、多用すると実際のコストがかかります。
• メモリはセッションをまたいで永続します。アシスタントはディスク上のファイルに覚えておきます。忘れさせたい場合は、Settings > AI からそのファイルを開いて編集できます。

参照元情報：Waveform User Manual
https://tracktion.github.io/waveform_manual/ai-assistant/