
# AIモデルとBYOK

このページでは、ボットを動かすAIモデル、**BYOK (Bring Your Own Key)** で1つのプロバイダーのみがサポートされている理由、およびプランに含まれている場合に独自のキーを設定する方法について説明します。


---

## ボットを動かすAIモデル

当プラットフォームでは、ボットの主要モデルとして **Anthropic Claude** を採用しています。Claudeが選ばれた理由は、市場に出回っているすべての主要なフロンティアモデル（現在利用可能な最も高度なAIモデルを指す業界用語）を広範囲にわたってテストした結果、本番環境でのメッセージング量を確実に処理できる唯一のモデルであったためです。

モデルを選択する必要はありません。プラットフォームがタスクごとに最適なモデルを自動的に選択し、その使用方法を舞台裏で最適化します（これには、会話あたりのコストを劇的に削減する高度なプロンプトキャッシングも含まれます）。

---

## なぜBYOKはAnthropicのみなのか

OpenAI、Google Gemini、OpenRouter、あるいはBYOK（Bring Your Own Key）向けのオープンソースモデルへの対応予定について、お客様からよくお問い合わせをいただきます。正直に申し上げますと、それらのモデルをそのまま未最適化の状態で使用しても、本番環境のトラフィック量には耐えられません。

**小規模なプロジェクトであれば、AIの成功率が10回中9回でも問題ありません。** しかし、実際の顧客との会話を大規模に運用する場合、10%の失敗率は、予約の不成立、誤った回答、フォローアップの漏れ、そして売上の損失を意味します。これは、他社のトップティアのフロンティアモデルでも見られる水準（意図的に難しくしたテスト質問などのアドバーサリアルなエッジケースにおいて、およそ6〜10%の失敗率）であり、安価なモデルを検討する以前の問題です。

問題は主に3つのカテゴリーに分類されます。

- **エッジケースで予測不能な不具合が発生する。** モデルは何百ものチャットでは完璧に動作しても、突然ツール呼び出しでハルシネーション（幻覚）を起こしたり、実行していないことを実行したと主張したり、会話の途中で指示を忘れたりすることがあります。
- **長いコンテキストの処理が不十分。** ボットの1回の応答には、チャット履歴、FAQ、フォローアップロジック、ツール呼び出し、推論が含まれます。ほとんどのモデルはこの情報量で処理が滞り、出力の品質が低下します。
- **「安価」であることは稀。** トークンあたりの表示価格が安くても、再試行回数の増加、出力トークンの増加、コンバージョン率の低下によって相殺されてしまいます。成功した会話あたりの実質コストは、最終的に高くなってしまいます。

100種類のモデルをサポートすることは、実用的な機能というよりもマーケティング上の謳い文句に近いものです。私たちは、それぞれが異なる方法で壊れる5つのプロバイダーよりも、確実に動作する1つのプロバイダーを提供したいと考えています。

---

## 独自モデル：Max

私たちは独自の社内モデル「**Max**」を構築しました。これは社内モデルにマルチパス最適化スタックを組み合わせたもので、プラットフォーム上の実際の会話データに基づいて改良されています。その目標は、Claudeよりも大幅にコスト効率が高く、かつプラットフォームで実際に発生する会話パターンにおいて信頼性を維持できるモデルを作ることでした。Maxはまさにそれを実現しており、Pro価格の数分の一（1アクションあたり0.25クレジット）でありながら、一般的な低コストモデルでは精度が落ちるような場面でも正確さを維持できるように調整されています。

Maxはセットアップ不要です。モデルの選択やプロバイダーのアカウント、キーなどは一切必要ありません。すべて当社のインフラストラクチャ上で実行され、当社が提供するモデルの中で最も高い精度を誇ります。独自のベンチマークでは、ビジネス上の実際の記述を最も忠実に守るという結果が出ています。MaxとClaude、そしてお客様からよくお問い合わせいただく低価格なサードパーティ製モデルとの比較（テストでそれらのモデルが実際にどのような誤りをしたかを含む）については、[Maxが最高の価値である理由](ai-model-comparison.md)をご覧ください。

### Maxティアが表示されるユーザー

エージェントの**AI Instructions（AI指示）**タブにある**AI Quality（AI品質）**ピッカーに**Pro**と**Economy**しか表示されない場合、ログイン中のアカウントでMaxが有効になっていません。Maxを有効にするには、以下の2点を確認してください。

- **対象となるライフタイムプランのアカウント**は、自動的にMaxが適用されます。
- **その他のアカウント**は、明示的にMaxを有効にする必要があります。


> **代理店から提供されたアカウントの場合、プロバイダーがモデルを選択している可能性があります。** AI品質ピッカーにカードが1枚しか表示されず、切り替え先がない場合は、アカウント上の意図的な設定であり、障害ではありません。アカウントの提供元に変更を依頼してください。カードが表示されているにもかかわらず「利用不可」という注記がある場合は、エージェントがプロバイダーによって削除されたモデルを使用していることを意味します。その場合でも応答は継続されますが、プロバイダーが許可している別のモデルで動作しているため、ピッカーの設定を実際に実行されているモデルと一致させるには、許可されているモデルのいずれかを選択してください。

> 独自のAnthropicキー（BYOK）を接続しても、Maxが表示されるかどうかには**一切関係ありません**。両者は並行して機能します。キーを接続している場合のMaxエージェントの課金方法については、[Setting Up BYOK（BYOKの設定）](#setting-up-byok)の例外に関する注記を参照してください。APIキーを削除してもMaxが表示されるようになることはありません。

### Miniティア

Maxをご利用いただける場合は、**Mini**も**1アクションあたり0.15クレジット**でご利用いただけます。MiniはMaxと同じAIを低価格で提供するものですが、以下の2つのトレードオフがあります。

- **ミスの可能性が高まります。** Miniは2つのモデルのうち軽量なモデルです。Maxは当社が提供する最も精度の高いモデルであり、貴社の実際の情報に忠実であるよう厳密に調整されています。一方、Miniは回答に小さなミスやハルシネーション（もっともらしい嘘）が混入する可能性がわずかに高くなります。
- **メモリ負荷が低減されます。** 長時間の会話において、Miniは過去のメッセージの記憶保持数が少なく、回答ごとに参照するナレッジベースの断片も少なくなります。

予約、価格に関する質問、重要なサポートなど、誤った詳細が売上の損失につながる可能性がある場合には、引き続きMaxが推奨されます。Miniは、精度を極限まで追求するよりも、スピードとコストが重視される大量の会話に適しています。

MiniはMaxと同様に、Maxを利用可能なすべてのアカウントのAI品質ピッカー内に表示されます。Maxと同様に、Miniは完全に当社のインフラストラクチャ上で実行され、BYOKキーを使用することはありません。そのため、エージェントがMiniを使用している間、接続されたAnthropicキーは使用されず（課金もされません）。

**0.15 Miniレートの対象範囲。** Miniの料金は、ライブ会話内で発生するすべての処理に適用されます。AIによる返信、AIツール呼び出し（予約や人間への通知など）、チャット評価（会話を無視するか終了するかを判断）、割り込み処理（ボットが返信を作成中に連絡先から新しいメッセージが送信された場合）、チャットの要約、AIによる自動タグ付けなどが含まれます。会話外の単発のAI機能（キャンペーンの最適化、ナレッジベースの生成、API経由で行われるタグ付けなど）については、MaxとMiniの両方で0.25クレジットの固定レートが適用されます。そのため、すべてのエージェントがMiniに設定されている場合でも、クレジット履歴に0.25の項目が表示されることがあります。これはそれらの機能によるものであり、Maxモデルがチャットに応答しているわけではありません。

---

## BYOKの設定

BYOKは、**Agency**プランおよび**Agency Unlimited**プラン、ならびにAppSumoのライフタイムティアの**Plan 2**以上で利用可能です。Businessプランには含まれていません。ご利用のプランに含まれている場合、独自のAnthropic APIキー（Anthropicアカウントから発行されるプライベートコードで、プラットフォームのクレジットを使用する代わりに、AI利用料を直接あなたに請求できるようにするもの）を接続できます。

> **公式のAnthropicキーのみが有効です。** 有効なキーは、console.anthropic.comのあなたのアカウントから取得したもので、常に`sk-ant-`で始まります。リセラー、プロキシ、または「割引されたClaude API」サイト（多くの場合、異なるプレフィックスで始まります）からのキーはサポートされておらず、保存できません。Anthropic自身の価格を大幅に下回る安価なClaudeトークンのオファーには注意してください。Anthropicが請求する価格を下回る価格でClaudeへのアクセスを正当に再販できる業者は存在しません。そのようなオファーは、盗まれたキーに基づいているか、支払い情報をフィッシングするために設定された詐欺である可能性がほとんどです。

> **スマートフォンをご利用ですか？** 左側のサイドバーが非表示になっている場合があります。まずメニューアイコン（**☰**）をタップし、次に **Settings** をタップしてください。

> **Advanced（詳細）グループにBYOK API Keysが表示されませんか？** このセクションは、BYOKが含まれるプランでのみ表示されます。アカウントがプロバイダーによって管理されている場合、プロバイダーがそのアカウントに対して**Bring Your Own API Key（独自のAPIキーを使用）**を有効にした場合にのみ表示されます。


1. 左側のメインサイドバーで、**Settings**（下部付近にある歯車アイコン）をクリックします。
2. Settingsページ左側のメニューで、**Advanced**グループまでスクロールします。
3. **BYOK API Keys**をクリックします。


4. Anthropicカードの **Add key** をクリックします。**Secret key** フィールドが表示されます（プレースホルダー `sk-ant-…`）。


5. Anthropic APIキーをフィールドに貼り付け、**Save key** をクリックします。

有効にすると、ボットはAI呼び出しに独自のキーを使用するようになります。その際、AI応答に対してプラットフォームのクレジットを消費する代わりに、Anthropicへ直接料金を支払うことになります。チャネルインフラストラクチャ（WhatsApp Webサーバー、電話番号など）は、これまで通りクレジットを使用します。

> **1つの例外：Maxティア。** エージェントのAI品質が**Max**ティアに設定されている場合、そのエージェントは完全に当社の社内インフラストラクチャ上で実行され、BYOKを接続していても1アクションあたり0.25クレジットが課金されます。MaxはAnthropicキーを使用しません。（利用可能な場合は**Mini**も同様で、1アクションあたり0.15クレジットが課金され、キーは使用されません。）返信を自身のAnthropicアカウントに課金するには、エージェントを**Pro**（標準）ティアのままにしてください。**AI Quality（AI品質）**ピッカーは、各エージェントの**AI Instructions（AI指示）**タブにあります。**BYOK API Keys**設定ページには、キーが登録されているにもかかわらず1つ以上のエージェントがMaxティアで実行されている場合に通知が表示され、対象のエージェントがリストアップされます。そのため、なぜクレジットが消費されているのかを一目で確認できます。


**コストに関する注意:** 独自のAPIキーを使用することは、もはや安価な選択肢ではありません。独自のキーを接続すると、エージェントはClaude上で動作し、Anthropicの従量課金レートが直接適用されます（Anthropicは、公共料金の請求書と同様に、実際の使用量に基づいて請求を行います）。独自のキーを使用しているアカウントで測定した場合、AIの1回の返信にかかるコストは、Maxプランでの同じ返信コストの約3倍、Miniプランの5倍以上になります。これは、返信によってトリガーされるバックグラウンド処理（ナレッジベースの検索、スパムチェック、名前とメールアドレスの抽出、チャット評価、タグ付け）を考慮に入れた場合です。これらの処理はすべてMaxおよびMiniの定額料金に含まれていますが、独自のキーを使用する場合はトークンごとに課金されます。プロンプトキャッシングの最適化は独自のキーにも適用されるため、これはキャッシングの差ではありません。MaxとMiniは単に非常に安価なモデルであり、当社のセールス会話ベンチマークでも高いスコアを記録しています。BYOK（独自のキーの使用）は、コストを節約するためではなく、AIの使用料を自身のAnthropicアカウントに直接請求したい場合にのみ使用してください。

> **会話の最初の返信が、それ以降の返信よりもはるかに高額になる理由。** キャッシュ機能は、会話のコンテキストを初回送信時にAnthropic側に保存し、その後再利用することで機能します。書き込みには通常の要求よりもコストがかかりますが、それを再利用する各返信のコストは約20分の1になります。そのため、最初の返信は驚くほど高額に見えますが、それ以降の返信は非常に安価になります。会話に含まれるデータが大きいほど、最初の返信のコストは増大します。特に訪問者がアップロードするドキュメントが主な要因です。24ページのPDFの場合、各ページがテキストと画像の両方として送信され、それが会話内に保持されるため、返信のたびに再送信（および再キャッシュ）されることになり、約70,000トークンに達します。会話が1時間以上途絶えると保存されたコピーは期限切れとなり、次の返信で再び書き込みコストが発生します。
>
> ドキュメントを多用するサービス（契約書の解説、マニュアルの検索、ファイルのアップロードを伴うものなど）を構築している場合、通常は **Max** ティアの方が適しています。ドキュメントのサイズに関係なく1返信あたり0.25クレジットの固定料金であるため、最初のメッセージでの急激なコスト増はなく、トークン単位のコスト変動も一切ありません。品質とコストの比較については、[Maxが最も価値がある理由](ai-model-comparison.md)をご覧ください。

**BYOKキーが失敗した場合（無効、クォータ超過、またはレート制限によりAnthropicが一時的にリクエスト数を制限している場合）、ボットが動作し続けるかどうかは、同じBYOK API Keysページにある「Fallback to credits（クレジットへのフォールバック）」トグルの設定に依存します**。

- **オン:** プラットフォームは一時的にプラットフォームのクレジットを使用するため、ボットは返信を継続します。その間、バックグラウンドでキーの再試行が続けられ、呼び出しが成功した時点で自動的に自身のキーに戻ります。
- **オフ** *(デフォルト)*: キーを修正するまでAIの返信はブロックされます。クレジットが勝手に消費されることはありませんが、ボットの返信も停止します。キーの問題を解決する間もクレジットで動作を継続させたい場合は、あらかじめこのトグルをオンにしておいてください。

いずれの場合も、キーが最初に失敗した時点でメールが送信されます（メッセージごとに送信されるわけではありません）。

---

## よくある質問

**OpenAI、Gemini、またはその他のプロバイダーをBYOKに使用できますか？**
現時点では、他のプロバイダーには対応していません。ほとんどの方にとっての答えはすでにここにあります。**Max**と**Mini**は当社の自社ティアであり、アクションあたりそれぞれ0.25クレジットと0.15クレジットです。

**BYOKキーはすべてに使用されますか？**
独自のAnthropicキー（BYOK）が接続されている場合、ほとんどのAI操作はクレジット料金が無料になります。AI応答、ツール使用、キャンペーン最適化、ナレッジベース生成、Web検索はすべて、お客様のキーで実行されます。キーを接続していてもクレジットが発生するものが4つあります。自社モデルで実行されるため、アクションあたり0.25クレジットのMaxティアと0.15クレジットのMiniティア、メールアドレス1件の検索につき0.25クレジットのLead Finder、そして実行ごとに0.25クレジットとAIステップごとに0.25クレジットがかかるオートメーションです。エージェントを完全に独自のキーで（0クレジットで）運用し続けるには、Proティアのままにしてください。チャネル料金（WhatsApp Webの月額料金、WhatsAppのメッセージごとの配信料およびテンプレート料金）は、どちらの場合もAI使用料とは別に請求されます。キーが本来実行されるはずの呼び出しで失敗した場合、プラットフォームがクレジットにフォールバックするかどうかは、**クレジットへのフォールバック**トグルの設定によって決まります。このページの上部にある「クレジットへのフォールバック」トグルの説明を参照してください。

**AIの返信が0クレジットになるのは正確にはいつですか？**
BYOKはアカウント単位です。AIの返信が0クレジットになるのは、**このアカウント**が**独自**のAnthropicキーを接続している場合のみです。独自のキーがない場合、返信には通常のレートでクレジットが消費されます。

**BYOKはメッセージの配信やチャネルの信頼性に影響しますか？**
いいえ。BYOKはボットのAI呼び出しの課金方法を変更するだけです。メッセージのルーティング、チャネルインフラストラクチャ、フォローアップ、キャンペーン、ブロードキャストなど、その他のすべては全く同じように動作します。

---

参照：[Maxが最適な理由](ai-model-comparison.md) · [AIボットのセットアップ](ai-bot-setup.md) · [AIエージェント](../ai-agents/ai-agents.md)
