Your AI Connector Docs

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は、プラットフォームで実際に実行されるセールスおよびサポートの会話のために構築されています。Proの価格の数分の一（アクションあたり0.25クレジット）で利用でき、低コストモデルでは精度が落ちるような場面でも正確性を維持します。

Maxは設定不要です。モデルの選択、プロバイダーアカウントの作成、キーの入力などは一切必要ありません。これは当社が提供するモデルの中で最も正確であり、貴社のビジネス上の発言内容を忠実に守ることに最も長けています。MaxとClaude、および顧客からよく問い合わせを受ける低コストのサードパーティモデルとの比較については、Maxが最高の価値である理由をご覧ください。

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

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

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

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

独自のAnthropicキー（BYOK）を接続しても、Maxが表示されるかどうかには一切関係ありません。両者は並行して機能します。キーを接続している場合のMaxエージェントの課金方法については、Setting Up BYOK（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機能（エージェントの最適化（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をクリックします。
  1. Anthropicカードの Add key をクリックします。Secret key フィールドが表示されます（プレースホルダー sk-ant-…）。
  1. Anthropic APIキーをフィールドに貼り付け、Save key をクリックします。

有効にすると、Pro AI品質ティアのエージェントは返答に独自のキーを使用するようになり、その利用分はプラットフォームのクレジットを消費する代わりに、Anthropicへ直接支払うことになります。MaxまたはMiniティアのエージェントは独自のキーを使用せず、引き続きクレジットを消費します（以下の例外を参照）。チャネルインフラストラクチャ（WhatsApp Webサーバー、電話番号など）は、通常通りクレジットを使用します。

1つの例外 — Maxティアについて。 エージェントのAI品質がMaxティアに設定されている場合、BYOK（独自のキー）を接続していても、そのエージェントはアクションごとに0.25クレジットが課金されます。Maxは決してAnthropicキーを使用しません。（利用可能な場合のMiniも同様で、アクションごとに0.15クレジットが課金され、キーは使用されません。）返答を自身のAnthropicアカウントに請求するには、エージェントをProティアに維持してください。ティアはMax、Pro、Miniの3種類であり、個別のStandardティアはありません。AI品質の選択項目は、各エージェントのAI指示タブにあります。BYOK APIキー設定ページには、キーが登録されているにもかかわらず1つ以上のエージェントがMaxティアで実行されている場合に通知が表示され、該当するエージェントがリストアップされます。これにより、なぜクレジットが消費され続けているのかを一目で確認できます。

コストに関する注意: 独自のキーを持ち込む（BYOK）ことは、もはや安価な選択肢ではありません。キーを接続すると、エージェントはClaudeで実行され、Anthropicの従量課金レートが直接適用されます（Anthropicは実際の使用量に基づいて、公共料金のように請求します）。独自のキーを使用しているアカウントで測定したところ、AIの1回の返信にかかるコストは、Maxでの同じ返信の約3倍、Miniでのコストの5倍以上になります。これは、返信によってトリガーされるバックグラウンド作業（ナレッジベースの検索、スパムチェック、名前とメールアドレスの抽出、チャット評価、タグ付け）を考慮に入れた場合です。これらすべてがMaxとMiniの定額料金に含まれていますが、独自のキーを使用する場合はトークンごとに課金されます。MaxとMiniの方が圧倒的に安価であり、さらにMaxは当社が提供する中で最も正確なモデルです。BYOKは、コスト削減のためではなく、AIの使用料を自身のAnthropicアカウントに直接請求したい場合にのみ使用してください。

会話の最初の返信が、それ以降の返信よりもはるかに高額になる理由。 キャッシュ機能は、会話のコンテキストを初回送信時にAnthropic側に保存し、その後再利用することで機能します。書き込みには通常の要求よりもコストがかかりますが、それを再利用する各返信のコストは約20分の1になります。そのため、最初の返信は驚くほど高額に見えますが、それ以降の返信は非常に安価になります。会話に含まれるデータが大きいほど、最初の返信のコストは増大します。特に訪問者がアップロードするドキュメントが主な要因です。24ページのPDFの場合、各ページがテキストと画像の両方として送信され、それが会話内に保持されるため、返信のたびに再送信（および再キャッシュ）されることになり、約70,000トークンに達します。会話が1時間以上途絶えると保存されたコピーは期限切れとなり、次の返信で再び書き込みコストが発生します。

ドキュメントを多用するサービス（契約書の解説、マニュアルの検索、ファイルのアップロードを伴うものなど）を構築している場合、通常は Max ティアの方が適しています。ドキュメントのサイズに関係なく1返信あたり0.25クレジットの固定料金であるため、最初のメッセージでの急激なコスト増はなく、トークン単位のコスト変動も一切ありません。品質とコストの比較については、Maxが最も価値がある理由をご覧ください。

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

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

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

よくある質問

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

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

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

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

参照：Maxが最適な理由 · AIボットのセットアップ · AIエージェント