OpenAI Agents SDK で WhatsApp エージェントを構築する方法

OpenAI Agents SDK は、エージェントを構築するための OpenAI のオープンソースフレームワークです。指示を持つモデル、呼び出せるツール、他のエージェントへのハンドオフ、入出力を守るガードレールが、タスクが完了するまでループで実行されます。エージェントを構築するうえで優れた手段ですが、それだけでは、WhatsApp 番号、チーム受信トレイ、テンプレートメッセージ、担当者が引き継ぐ手段は手に入りません。MonoChat の Agent Harness では、OpenAI Agents SDK を AI ハーネスとして選択し、フローに AI エージェントノードを配置し、WhatsApp を接続してテストするだけで、残りは MonoChat が担当します。

このガイドでは、SDK が提供するもの、MonoChat で OpenAI エージェントを使う 3 つの方法、ステップごとの設定手順、そしてお客様がエージェントを信頼できるかどうかを左右する WhatsApp 特有の細部を説明します。

OpenAI Agents SDK が提供するもの

SDK は、いくつかの基本的な考え方を軸に作られています。

• エージェント： モデルと、その役割を説明する指示。
• ツール： 「注文を照会」や「時間枠を確認」など、エージェントが呼び出せる関数と MCP サーバー。
• ハンドオフ： あるエージェントが、専門のエージェントにタスクを渡すこと。たとえば、一般的なサポートエージェントから返品担当のエージェントへ。
• ガードレール： エージェントと並行して実行され、望ましくない入力や出力を止めるチェック。
• セッションとトレース： ターンをまたぐメモリと、エージェントが行ったことのステップごとの記録。

これらが組み合わさったものがエージェントハーネスです。モデルが一度答えて終わるのではなく、行動し、結果を確認し、続行できるようにするループです。カスタマーメッセージングでは、返品ポリシーを説明するだけで終わるか、実際に返品を作成するかの違いになります。

WhatsApp が加える課題

エージェントを構築するのは、仕事の半分です。WhatsApp でお客様の前に出すには、次のことへの対応が必要です。

• WhatsApp Business Platform。 公式 API の接続、認証済みのビジネス、承認済みの番号。
• 24 時間ウィンドウ。 自由形式の返信は、お客様の最後のメッセージから 24 時間以内に許可されます。それ以降は、承認済みのテンプレートが必要です。
• ポリシー。 2026 年 1 月 15 日以降、WhatsApp は汎用の AI アシスタントをプラットフォームから排除しています。自社のお客様に対応するエージェントは許可されており、自動返信の場合は担当者への明確な経路が求められます。
• 担当者。 一部の会話は、履歴を保ったまま、チームがすでに使っているツールの中で担当者に回す必要があります。
• その他のチャネル。 Instagram、Messenger、Webサイトで書き込むお客様も、同じ回答を期待しています。

MonoChat がこれらをエージェントの周囲で処理するため、お客様の作業はエージェント自体に集中できます。

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

オプション	実行場所	必要なもの
OpenAI Agents SDK	MonoChat 内	追加は不要。お客様の AI モデルを使用
OpenAI Agents API（OpenAI がホスト）	OpenAI のクラウド	お客様の OpenAI API キー
カスタム（独自の Agents SDK サービス）	自社サーバー	エンドポイント URL と共有シークレット

何もデプロイせずに OpenAI 方式のエージェントを使いたい場合は、OpenAI Agents SDK ハーネスから始めてください。 エージェントがすでに OpenAI のホスト型プラットフォーム上にある場合は、OpenAI Agents API を選びます。 開発者が SDK で独自のツール、ハンドオフ、テストを備えた独自のエージェントを書いており、そのコードを使い続けたい場合は、カスタムを選びます。 詳しくは、独自の AI エージェントを WhatsApp に接続する方法をご覧ください。

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

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

MonoChat で AI ハーネスを追加し、プロバイダーとして OpenAI Agents SDK を選択します。MonoChat 内で実行され、すでに設定済みの AI モデルを使用するため、この手順で追加のキーやサーバーは不要です。

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

WhatsApp の会話を受け付けるフローに、AI エージェントノードを追加し、ハーネスを選択します。エージェントの指示を書きます。誰に対応するのか、何ができるのか、何を絶対にしてはいけないのか、いつ引き継ぐのかを記述してください。

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

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

• メインモデルは、推論と返信の作成を行います。
• フォールバックモデルは、ソフトリミットや障害の後に引き継ぎます。
• 高速モデルは、バックグラウンド処理を担当します。

実行ごとの予算上限も追加し、1 つの通常と異なる会話で高額な請求が発生しないようにします。フォールバックの選び方が分からない場合は、お客様対応の AI エージェントにフォールバックモデルが必要な理由をお読みください。

4. ツールを接続する

最も頻繁なリクエストに合ったツールをエージェントに渡します。

• AI 関数ツール：構造化された入力で自社の API を呼び出します。
• MCP 連携：MCP に対応するシステムのツールを使用します。
• AI ナレッジベース：ドキュメントやポリシーに基づいた回答に使用します。
• カスタム機能：会話の中で実行されるロジックに使用します。

十分にテストされていない 15 個より、優れた 3 個のツールのほうが役に立ちます。実際の会話を確認してから、追加してください。

5. WhatsApp（とその他すべて）を接続する

Meta 公認の Meta Business Partner である MonoChat を通じて、WhatsApp Business 番号を接続します。同じフローを Instagram、Messenger、TikTok、Telegram、Webチャット、SMS、音声でも実行できるため、1 つのエージェントですべてのチャネルをカバーできます。

6. 実際のメッセージでテストする

先月の会話をテストセットとして使用してください。怒っているお客様、曖昧な質問、1 通に複数のリクエストが含まれるもの、すぐに担当者を希望するお客様など、難しいものも含めます。ツール呼び出し、トーン、引き継ぎを確認し、その後、公開します。

WhatsApp でうまくいくパターン

1 通につき 1 つの質問。 Web 上のチャット向けに作られたエージェントは、長いリストで答えがちです。スマートフォンでは、短いメッセージで一度に 1 つの明確な質問をするほうが、お客様から良い返答が得られます。

取り消せない操作の前に確認する。 キャンセル、返金、予約変更の前に、エージェントが提案し、お客様が確認するようにします。

専門エージェントへはハンドオフ、担当者へは受信トレイ。 SDK のハンドオフは、エージェント間（営業、サポート、返品）のルーティングに最適です。担当者への引き継ぎは、会話が全履歴とともに届く MonoChat の共有チーム受信トレイで行います。

制限を明示する指示。 「€50 までの返金は承認してよい。それを超える場合は請求チームに引き継ぐ」。曖昧なルールより、明確な数値のほうが有効です。

自社のビジネスの範囲にとどめる。 お客様を支援するエージェントは WhatsApp で許可されています。何にでも答えるものは、WhatsApp の 2026 年のルールに違反するおそれがあります。その線引きは、WhatsApp AI チャットボットのポリシーガイドで説明しています。

コスト

次の 3 つが加算されます。MonoChat のプラン、AI モデルの利用料、Meta の WhatsApp メッセージ料金です。2026 年 10 月 1 日から、Meta はビジネス番号ごとに毎月最初の 1,000 件を超えるサービス返信に課金します。WhatsApp API 料金ガイドをご覧ください。

AI 側では、ご自身のプロバイダーキーを使う場合、MonoChat は上乗せしません。実行ごとの予算、バックグラウンド処理用の低コストな高速モデル、信頼できるフォールバックにより、請求額を予測しやすく保てます。

特定の製品に縛られません

Agent Harness では、モデルだけでなくフレームワークも選べます。後から Claude Agent SDK、Pi、Claude Managed Agents、あるいは独自のフレームワークを試したくなった場合は、別の AI ハーネスを追加し、AI エージェントノードをそちらに向けるだけです。チャネル、ツール、引き継ぎはそのまま残ります。すべてのプロバイダーは、Agent Harness のページで比較できます。