Patter SDKを使用したレストラン予約電話エージェント構築ガイド：動的変数、ガードレール、レイテンシーダッシュボード、評価チェック

このチュートリアルでは、Patter SDKを使用して音声エージェントワークフローを構築し、AI電話アシスタントが実際の会話でどのように動作するかをシミュレートします。レストラン予約のユースケースを扱い、動的呼び出し変数の定義、呼び出し可能なツールの登録、出力ガードレールの適用、音声認識（STT）と音声合成（TTS）のシミュレーション、ライブテレフォニー資格情報を必要とせずに完全なスクリプト化された通話フローの実行を行います。また、利用可能な場合はインストールされたPatter APIを検査し、決定論的エージェントブレインを作成し、モデル化されたレイテンシーとコストメトリクスを追跡し、回帰評価を通じてシステムを検証します。最後に、Patter SDKがエージェントロジック、ツール使用、セーフティチェック、通話シミュレーション、実際のデプロイパターンを単一の構造化された音声エージェントパイプラインに統合する方法を理解します。

まず、Patter SDK、ツール、レストランバックエンドをセットアップします。必要なライブラリをインポートし、オプションでPatter SDKをインストールし、利用可能な場合はインストールされたAPIを検査します。動的呼び出し変数（顧客名、ロイヤルティレベル、レストラン名）を定義し、小さなツールレジストリを作成し、空席確認、予約、営業時間、転送用のインメモリレストランバックエンドを準備します。登録されたコアツールは、check_availability（空席確認）、book_table（予約）、get_hours（営業時間取得）、lookup_reservation（予約検索）、transfer_to_human（人間への転送）です。これらのツールにより、シミュレートされた電話エージェントは基本的なレストラン予約タスクを実行できます。

次に、出力ガードレール層とシミュレートされた音声層を構築します。出力ガードレールは、電話アシスタントを安全で簡潔、かつ予約ユースケースに適したものに保ちます。機密情報（メールアドレス、電話番号）を編集し、内部顧客IDを隠し、不適切な言葉をクリーンにし、話題外のリクエストをブロックし、応答を短く保つことで、より良い電話体験を提供します。5つのガードレール関数を定義します：gr_scope（話題制限）、gr_hide_internal_ids（内部ID非表示）、gr_redact_pii（PII編集）、gr_profanity（不適切な言葉のフィルタリング）、gr_concise（簡潔保持）。次に、STTとTTSの動作をシミュレートし、システムプロンプト（動的変数を含む）を定義し、軽量な解析関数（parse_party、parse_date、parse_slot、parse_name、parse_code）を追加して、ユーザー入力から重要な情報を抽出します。

エージェントブレイン（agent_brain関数）を構築します。これはワークフローの核心であり、履歴、ユーザーテキスト、コンテキストを処理し、ユーザー入力に基づいてどのツールを呼び出すか、または直接応答するかを決定します。たとえば、ユーザーが人間を要求した場合はtransfer_to_humanを呼び出し、空席確認が必要な場合はcheck_availabilityを呼び出します。予約フローは人数、日付、時間帯、名前を段階的に収集し、空席を確認して予約を完了します。fold_tool_result関数も実装し、ツールの生の結果を自然な音声応答に変換します。

最後に、決定論的評価ハーネスを使用してエージェントを検証します。予約、空席確認、営業時間、予約検索、人間への転送などのシナリオをカバーする複数のテストケースを作成し、エージェントが異なる入力に対して一貫して正しく動作することを確認します。評価ハーネスはリセットされたバックエンド状態を使用し、実行ごとに再現可能な結果を保証します。次に、同じエージェントロジックをTwilioとOpenAI Realtimeを使用した実際のデプロイにマッピングして、実際の音声通信を実現する方法について説明します。チュートリアル全体を通じて、Patter SDKがシミュレーションから本番までAI電話エージェントの開発をいかに簡素化し、完全なツールチェーンを提供するかを示します。