AI アシスタント

レシピの再バランス、置き換えの提案、説明やバーコードからのカスタム材料の自動入力ができる、ジェラートに精通したアシスタント。

Gelato Maestro の AI 機能は、設定で一度接続する外部の AI プロバイダー上で動作します。プロバイダーを設定すると、2 つのアシスタントが利用可能になります。

• レシピの詳細内のレシピアシスタント — ジェラートレシピの設計、バランス調整、ミックスのトラブルシューティングを手伝い、ジェラート作り全般に関する質問に答えます。
• 材料の追加または編集内の材料アシスタント — 新しい材料の追加を手伝い、値の入力プロセスに関する質問（ジェラート材料の理論から、詳細の入力、OpenFoodFacts からのデータ取得まで）に答えます。

AI プロバイダーを設定する

Gelato Maestro 自体は AI モデルを動かしません。頭脳はあなたが用意します。プロバイダーを選び、API キーを貼り付ける（またはサインインする）と、アシスタントが起動します。設定 › AI プロバイダーを開いて始めましょう。

どのプロバイダーを選ぶべき？

同じアドバイスがアプリ内の AI プロバイダー画面にある「AI は初めて？ ここから始めましょう」カードにも表示されます。

• すでに ChatGPT（Plus、Pro、または Team）に課金している → OpenAI サブスクリプションを選びます。既存の ChatGPT アカウントでサインインします。最も簡単な方法で、API キーも別途の請求も不要です。
• ChatGPT のサブスクリプションがない → Google Gemini を API キーで試してみましょう。Gemini には寛大な無料枠があり、使い切っても約 5 ドルのクレジットで長く使えます。
• すでに Anthropic または Mistral を使っている → それを選びます。そうでなければ必要ありません。

対応プロバイダー

ステップごとに：プロバイダーを追加する

1. 設定 › AI プロバイダーを開き、AI プロバイダーを追加をタップします。
2. プロバイダーピッカーからプロバイダーを選びます。下のセットアップパネルが、プロバイダー固有の手順と、ブラウザで適切なページを開くAPI キーを取得リンクに更新されます。
3. API キーを取得をクリックし、プロバイダーのサイトでキーを作成してコピーします。
4. キーを API キーフィールドに貼り付けます。（OpenAI サブスクリプションの場合は、代わりにサインインボタンを使います。）
5. 任意：名前フィールドでソースの名前を変更します（例：「個人用 Gemini」）。複数のプロバイダーを追加する場合に便利です。
6. 任意：詳細を開いて、特定のモデルと推論の労力を選びます。ほとんどのユーザーにはデフォルトで十分です。
7. 追加をタップします。Gelato Maestro はモデル一覧を取得して接続をテストします。成功すると、プロバイダーが一覧に表示されます。

サブスクリプション対 API キー

• サブスクリプション — 既存のアカウントでサインインします（現在は OpenAI のみ）。すでに支払っている定額の月額料金を支払うだけで、Gelato Maestro が追加で請求することはありません。
• API キー — プロバイダーのウェブサイトで作成する秘密のコードです。プロバイダーがリクエストごとに請求します。まず約 5 ドルのクレジットから始め、使用量を見て、必要なときだけ追加してください。レシピ全体の再バランスでも、最新のモデルでは数セントしかかかりません。

レシピアシスタント

プロバイダーを設定すると、レシピの詳細内で AI ボタンが有効になります。アシスタントを開くと、「アシスタントにこのレシピの改善を手伝ってもらいましょう。」のようなプレースホルダーが入ったチャットフィールドが表示されます。

できること

このアシスタントは汎用チャットボットではありません。ジェラート専用の小さなツール群を通じてあなたのレシピに直接アクセスでき、現在の材料と KPI を読み取り、一度に書き換えることができます。実際に頼めることの例：

• 「ピスタチオペーストの比率をたっぷり使った、ディスプレイフリーザーから出してすぐ柔らかくすくえるシチリア風ピスタチオジェラートを設計して。」 — ゼロからレシピ一式を構成し、あなたのすくい心地と食感の目標に合う構造材料と比率を選びます。
• 「このミックスはブラストフリーザーから出すと硬すぎて、ディスプレイで一日経つと氷っぽくなる。風味を変えずに原因を診断して直して。」 — 現在のレシピを調査し、考えられる原因を突き止め、主要な風味材料はそのままに、食感を直すよう再バランスします。
• 「私のチョコレートジェラートは口の中でざらざらしてチョークのよう。作り直して。」 — どの材料が原因の可能性が高いかを突き止め、再バランスを提案し、あなたが学べるよう理由を説明します。
• 「今手元に在庫がある材料だけを使ってヘーゼルナッツジェラートを作って。」 — あなたの材料ライブラリを参照し、在庫がある分の材料を選び、すでにあるものだけでバランスの取れたレシピを構成します。
• 「私のジェラートがべたついて溶けにくいのはなぜ？ ブドウ糖を抜いたら何が変わる？」 — レシピを必ずしも変更せずに、診断や理論の質問に答えます。

会話の進み方

1. あなたがリクエストを書きます。プロンプトが明確であるほど、結果も良くなります。何が欲しいか、何を避けたいか、そして制約（目標重量、保持したい風味、手元にない材料など）を伝えてください。
2. アシスタントは実証的なツールを使って一歩ずつ作業します。当てずっぽうではありません。アプリがあなたに提供しているのと同じバランス調整・分析ツールを使います。レシピを読み、変更を試し、結果を確認し、調整し、もう一度試します。すべてのステップがチャットに表示されるのを見ることができます。
3. いつでも一時停止して方向を修正できます。アシスタントが間違った方向に進んでいる場合は、止めて新しい指示を送ってください — 「やっぱりピスタチオペーストの比率はそのままにして」「粉乳には手を付けないで」「代わりにもっと柔らかい方向にして」など。そこから新しいガイダンスで続行します。
4. 構造化された要約で締めくくります。提案されたレシピ全体 — 各材料とその比率、結果として得られるゲージ、そして何がなぜ変わったかについての短いメモ。
5. あなたが決めます。採用をタップして変更をレシピに確定するか、破棄をタップして変更を捨て、元のレシピをそのまま残します。

良い結果を得るためのコツ

• 具体的に。「もっとピスタチオっぽくして」は曖昧ですが、「ピスタチオペーストの比率を上げて再バランスして」はアシスタントが直接実行できることです。
• まず材料フラグを使う。すでにインクルージョンにバランス計算に使用 = オフを付け、投与上限を設定していれば、アシスタントはそれらの制約を引き継ぎ、それらと闘ってトークンを無駄にしません。
• 1 リクエストにつき 1 つの変更。複合的なリクエスト（「甘さを抑えて、牛乳を入れ替えて、コストを下げて」）も機能しますが、焦点を絞ったリクエストの方がうまくいきやすく、1 つずつ変更を確認できます。

材料アシスタント

レシピアシスタントが、まだライブラリに存在しない材料を必要とするとき — または、あなたが手作業でカスタム材料を作成するとき — Gelato Maestro は組成フィールドを代わりに埋めようとします。これが材料アシスタントです。

新しい材料が必要になったとき何が起こるか

1. OpenFoodFacts 検索。アシスタントは OpenFoodFacts（無料のグローバル製品データベース）を名前で検索します。
2. 明確な一致が 1 つ → その材料が OpenFoodFacts の組成（水、糖類、脂肪、タンパク質、食物繊維、カロリー）で自動的に作成されます。
3. 候補が複数 → 2–3 個の候補（「ヘーゼルナッツペースト — 一般」「ヘーゼルナッツペースト — ブランド X」…）が表示される選択カードが出るので、最も近いものを選びます。選んだものが OpenFoodFacts から作成されます。
4. OpenFoodFacts に一致がない、または OpenFoodFacts に接続できない → AI に対して、分離された呼び出しで組成の推定が求められます。返された値は、材料が作成される前に検証されます（0–100% にクランプされ、合計が確認されます）。
5. AI のフォールバックでも有効な組成を生成できない場合、アシスタントはそれを伝え、レシピを変更せずに残します。

アシスタントが埋める項目

新しいカスタム材料について、アシスタントは、そうでなければ材料の追加または編集で手入力するのと同じフィールドを埋めます。

• 水、総糖類（ショ糖、ブドウ糖、果糖、乳糖）、総脂肪、MSNF、食物繊維、タンパク質。
• 100 g あたりのカロリー。
• 導出される KPI 寄与（PAC、POD） — 糖/脂肪の内訳から計算され、AI から直接得られるものではありません。
• デフォルトの分類（糖、脂肪、乳製品、果実、構造、香料、インクルージョン）。

すべての値は材料の詳細ビューで引き続き編集できます。AI が何かを間違えた場合 — フルーツピューレが 100% 水とされている、乳製品の MSNF が欠けているなど — その場で修正できます。

AI が間違うとき

AI は有能だが誤りを犯すアシスタントとして扱ってください — 真実の源ではありません。モデルは次のことがあります。

• 材料の値を捏造する。OpenFoodFacts にデータがない場合、フォールバックリゾルバに組成の推定が求められます。推定は外れることがあり、時には大きく外れます。AI が埋めた材料については、必ず脂肪と糖の割合を妥当性チェックしてください。
• 誤った OpenFoodFacts 製品を選ぶ。複数の候補が似ている場合、選択カードで選べますが、急いで受け入れると、実際に使っているものではない製品から値を引き継いでしまうことがあります。
• ゲージにはバランスさせるが、味にはバランスさせない。自動バランスと同様に、アシスタントは設定 › ゲージの KPI 範囲に対して最適化します。ソルベに 60% のレモン果汁が入るべきかどうかについては意見を持ちません — 数値が範囲に収まれば、そのレシピを有効と見なします。
• 料理的な上限を誤って判断する。アシスタントは、レモン果汁に妥当な最大値があること、エスプレッソが苦いこと、アルコールがすくいやすさを制限することを常に知っているわけではありません。まずカスタム材料に妥当な投与上限とバランス計算に使用フラグを設定してください — アシスタントはそれらを引き継ぎます。
• 途中で失敗する。レート制限、ネットワークエラー、モデルの問題によって実行が中断されることがあります。エラーは人間が読める原因とともに赤い吹き出しとしてチャットに表示されます。リクエストを再送するか、別の設定済みプロバイダーに切り替えてください。

組み込みの安全策

Gelato Maestro は、AI の間違いを破壊的なものではなく回復可能なものにしようとします。

• 採用 / 破棄の確認。採用をタップするまで、変更はレシピに確定されません。破棄は元のレシピをそのまま残します。
• 曖昧さには選択カード。OpenFoodFacts が複数の候補を返した場合、あなたが選びます — アシスタントが黙って推測することはありません。
• ラウンド上限。アシスタントは、最終的な要約を出す前に、1 リクエストあたり数回しかレシピを調整できません。暴走ループはありません。
• 検証。AI フォールバックが返した組成値は妥当な範囲にクランプされ、整合性のある材料として成立しない場合は拒否されます。
• どこでも編集可能。AI が提供したすべての数値 — 組成、比率、分類 — は後から手作業で編集できます。

プロバイダーの切り替え、削除、編集

追加したプロバイダーはそれぞれ、設定 › AI プロバイダーに行として表示されます。行をタップすると編集画面が開きます — 名前を変更したり、API キーを置き換えたり、別のデフォルトモデルを選んだり、完全に削除したりできます。プロバイダーを削除すると、保存されたキーがデバイスから削除されます。プロバイダーへのリクエストは送信されません。

複数のプロバイダーを同時に設定できます — たとえば、日常の作業には OpenAI サブスクリプション、バックアップには Google Gemini など。設定したすべてのプロバイダーがアシスタントで利用可能になります。