WhatsApp で Claude Agent SDK のエージェントを動かす方法（MonoChat を使用）

Claude Agent SDK は Anthropic のエージェントハーネスです。Claude Code を支えるのと同じ、推論、ツールの利用、自己チェックのループを、開発者が自分のエージェントを構築できるようにパッケージ化したものです。これを WhatsApp で動かすには、さらに 3 つのものが必要です。WhatsApp Business Platform への接続、エージェントに自社の業務ツールを渡す手段、そしてエージェントが止まるべきときに担当者へ安全につなぐ経路です。MonoChat の Agent Harness では、Claude Agent SDK を AI ハーネスとして追加し、フローに AI エージェントノードを配置し、WhatsApp 番号を接続してテストするだけです。運用するサーバーは不要です。

このガイドでは、Claude Agent SDK がお客様との会話にもたらすもの、MonoChat での設定の流れ、そしてお客様が書き込み始める前に押さえておくべきことを説明します。

Claude Agent SDK とは（そしてサポートに適している理由）

現在の WhatsApp 上の AI の多くは、単一のモデル呼び出しです。メッセージが届き、モデルが返信を書いて、終わりです。「営業時間は？」であれば問題ありません。しかし「注文した商品が届かず、金曜日に旅行に出ます」という問い合わせには対応できません。

ハーネスは、モデルをループで実行します。モデルが次の行動を決め、ハーネスがそのステップ（何かを調べる、ツールを呼び出す、ファイルを読む）を実行し、結果を戻して、タスクが完了するか担当者が必要になるまで繰り返します。Claude Agent SDK は、そのループの Anthropic 版です。Claude Code の土台であり、ツールの利用、MCP のサポート、サブエージェント、長いセッション向けのコンテキスト管理、権限制御など、開発者が頼りにする構成要素が備わっています。

カスタマーメッセージングでは、このループが回答を解決へと変えます。

• 約束する前に確認します。 在庫、配送状況、予約枠、返金ルールは、推測ではなく、回答する時点で調べます。
• 案件を複数のステップで処理します。 注文を探し、配送業者を確認し、荷物が止まっていることを確認し、代替品を提案するところまでを、1 つの会話で行います。
• 止まるべきときを知っています。 優れたハーネスは、許可された範囲の限界に達したとき、アドリブで対応せずに、案件を担当者に引き継ぎます。

ハーネスと通常の推論の違いについては、エージェントハーネスとは何か、WhatsApp サポートに必要な理由をご覧ください。

MonoChat で Claude エージェントを使う 3 つの方法

MonoChat は、Claude を搭載したエージェントに至る 3 つの経路をサポートしています。いずれも、同じ AI エージェントノード、同じチャネル、同じ引き継ぎを使用します。

オプション	実行場所	必要なもの
Claude Agent SDK	MonoChat のエージェントランナー。各実行は Claude Code 方式の独立したエージェントプロセス	追加は不要。MonoChat のゲートウェイ経由でお客様の AI モデルを使用
Claude Managed Agents	Anthropic のクラウド	お客様の Anthropic API キー
カスタム（独自の Claude Agent SDK サービス）	自社サーバー	エンドポイント URL と共有シークレット

ほとんどのチームには、1 つ目のオプションが最適な出発点です。何もデプロイや保守をせずに、Claude Agent SDK ハーネスを利用できます。すでに Anthropic のホスト型エージェントで構築していて、そのまま使い続けたい場合は Claude Managed Agents を選びます。開発者が SDK で独自のエージェントを構築・テスト済みで、自社のインフラで運用し続けたい場合はカスタムを選びます。その方法は、独自の AI エージェントを WhatsApp に接続するガイドで説明しています。

ステップごとの手順：WhatsApp で Claude Agent SDK のエージェントを動かす

1. AI ハーネスを追加する

MonoChat では、AI ハーネスは一度追加して繰り返し使えるサービス定義です。ハーネスを追加し、プロバイダーとして Claude Agent SDK を選択します。プロバイダー自体に設定するものはほかにありません。MonoChat のエージェントランナー上で動作し、MonoChat のゲートウェイ経由でお客様の AI モデルを利用します。

2. フローに AI エージェントノードを追加する

受信した会話を処理するフローを開くか、新しく作成し、AI エージェントノードを追加します。作成したハーネスを選択します。ここでエージェントに役割を与えます。誰に対応するのか、何をしてよいのか、いつ引き継ぐ必要があるのかを説明する指示を書いてください。

3. メイン、フォールバック、高速の各モデルを選択する

AI エージェントノードごとに、3 つのモデルの役割があります。

• メインモデル： 推論、判断、返信の作成を行います。
• フォールバックモデル： ソフトリミットの後、またはメインモデルが失敗したときに引き継ぎ、お客様に回答が届くようにします。
• 高速モデル： バックグラウンド処理を担当します。

実行ごとの予算上限も設定してください。お客様との会話で長い連鎖的なステップが必要になることはまれで、予算があれば、通常と異なるケースが高額になることを防げます。ペアの選び方は、お客様対応のエージェントにフォールバックモデルが必要な理由の記事で説明しています。

4. エージェントにツールを渡す

ツールのないエージェントは、話すことしかできません。MonoChat では、エージェントは次を利用できます。

• AI 関数ツール：構造化された入力で自社の API を呼び出します。たとえば「注文状況を取得」や「返品を作成」です。
• MCP サーバー：MCP に対応する任意のシステムのツールを取り込みます。
• AI ナレッジベース：自社のポリシーやドキュメントに基づいた回答に使用します。
• カスタム機能：会話の中で実行されるビジネスロジックに使用します。

まず、最も多いリクエストをカバーする 2、3 のツールから始めてください。ツールを追加するたびに、エージェントができることが 1 つ増え、テストすべきことも 1 つ増えます。

5. WhatsApp とその他のチャネルを接続する

まだの場合は、WhatsApp Business 番号を MonoChat に接続します（MonoChat は Meta 公認の Meta Business Partner であり、公式の WhatsApp Business Platform を使用します）。エージェントはフロー内にあるため、何も作り直さずに、同じフローを Instagram、Messenger、TikTok、Telegram、Webチャット、SMS、音声に割り当てられます。

6. テストして、公開する

お客様が実際に送るメッセージをエージェントに送ってみてください。短いもの、誤字のあるもの、複数の言語のもの、1 通に 3 つの質問が入ったものなどです。適切なツールを使い、ルールの範囲内にとどまり、適切なタイミングで引き継ぐかを確認します。その後、実際のトラフィックに向けてフローを有効にします。

WhatsApp エージェントの指示の書き方

Claude Agent SDK はコーディングの分野で育ったため、長く詳細な回答が歓迎されます。WhatsApp はその逆です。いくつかのルールで大きな差が生まれます。

• 返信は短く。 1 通につき 2、3 文、質問は一度に 1 つ。お客様はスマートフォンで読みます。
• 実行する前に確認する。 お金がかかる、または元に戻せない操作の前には、「注文 4821 をキャンセルして €39 を返金できます。進めてよろしいですか？」のように確認します。
• 引き継ぎルールを明示する。 たとえば、「スタッフへの苦情、法的な脅し、€100 を超える返金、お客様が担当者を希望した場合は、担当者に引き継ぐ」。
• 自社のビジネスの範囲にとどまる。 2026 年 1 月 15 日以降、WhatsApp の規約により、汎用の AI アシスタントはプラットフォームから排除されています。自社のお客様に対応するエージェントは問題ありませんが、あらゆるトピックで小論文を書くようなものは認められません。このルールは、WhatsApp AI チャットボットのポリシーガイドで説明しています。
• 24 時間ウィンドウを守る。 自由形式の返信は、お客様の最後のメッセージから 24 時間以内に限り許可されます。それ以降は、承認済みのテンプレートが必要です。

引き継ぎ：信頼を左右する部分

お客様は、「担当者に代わります」と言うエージェントは許してくれますが、堂々巡りするエージェントは許してくれません。MonoChat では、エージェントは全履歴とともに、共有受信トレイでチームに会話を引き継ぎます。お客様が尋ねたこと、エージェントが調べたこと、すでに試したことがすべて渡されます。引き継ぐ担当者が、お客様に最初からやり直してもらう必要はありません。

ツールを計画する前に、引き継ぎのルールを計画してください。エージェントが単独では決して対応すべきでない案件、その案件を受け取る担当者、そして待っている間にエージェントがお客様に何を伝えるかを決めておきます。

コストと管理

エージェントでは、MonoChat のプランに加えて、AI モデルの利用料と Meta の WhatsApp 料金という 2 つの費用が発生します。2026 年 10 月 1 日から、Meta はビジネス番号ごとに毎月最初の 1,000 件を超えるサービス返信に課金します。詳細は、WhatsApp API 料金ガイドをご覧ください。

AI 側では、ご自身のプロバイダーキーを使う場合、MonoChat は上乗せしません。実行ごとの予算上限、適切なフォールバックモデル、バックグラウンド処理用の高速モデルにより、利用量が増えても利用状況を予測しやすく保てます。

別のハーネスを選ぶべきとき

Claude Agent SDK は、複数のステップにわたって推論する必要があるエージェントに適した、有力な標準の選択肢です。ただし Agent Harness は、特定の製品に縛られないように作られています。チームがすでに OpenAI Agents SDK、Pi、ホスト型の OpenAI または Anthropic のエージェント、あるいは独自のフレームワークを使っている場合は、別の AI ハーネスを追加して AI エージェントノードを切り替えるだけで、チャネル、ツール、引き継ぎには手を加えずに済みます。すべてのオプションは、Agent Harness のページでご覧いただけます。