@@ -7,14 +7,15 @@ import { Aside, Steps, Code } from '@astrojs/starlight/components';
77import twilioBasicExample from ' ../../../../../../examples/docs/extensions/twilio-basic.ts?raw' ;
88import twilioServerExample from ' ../../../../../../examples/realtime-twilio/index.ts?raw' ;
99
10- Twilio は [ Media Streams API] ( https://www.twilio.com/docs/voice/media-streams ) を提供しており、電話の通話音声の元オーディオを WebSocket サーバーへ送信できます。このセットアップを使って 、[ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を Twilio に接続できます。Twilio から届くイベントを Realtime Session に接続するには、` websocket ` モードのデフォルト Realtime Session トランスポートを使用できます。ただし、電話は Web ベースの会話よりも遅延が大きくなるため、適切なオーディオ形式の設定や、独自の割り込みタイミングの調整が必要になります 。
10+ Twilio は、電話通話の元音声を WebSocket サーバーへ送信する [ Media Streams API] ( https://www.twilio.com/docs/voice/media-streams ) を提供しています。このセットアップを使うと 、[ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を Twilio に接続できます。Twilio から届くイベントを Realtime Session に接続するには、` websocket ` モードのデフォルトの Realtime Session トランスポートを使用できます。ただし、通話は Web ベースの会話よりも遅延が大きくなるため、適切な音声フォーマットの設定と、割り込みタイミングの調整が必要です 。
1111
1212セットアップ体験を向上させるため、Twilio への接続、割り込み処理、音声の転送などを代わりに処理する専用のトランスポートレイヤーを用意しました。
1313
1414<Aside type = " caution" >
15- このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります。
16- 問題は [ GitHub issues] ( https://github.com/openai/openai-agents-js/issues )
17- からご報告ください。迅速に修正します。
15+ このアダプターはまだベータ版です。レアケースの問題やバグが発生する可能性があります。
16+ 何か問題があれば [ GitHub
17+ issues] ( https://github.com/openai/openai-agents-js/issues )
18+ に報告してください。迅速に対応します。
1819</Aside >
1920
2021## セットアップ
@@ -23,14 +24,13 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
2324
24251 . ** Twilio アカウントと Twilio の電話番号を用意します。**
2526
26- 2 . ** Twilio からのイベントを受け取れる WebSocket サーバーを用意します 。**
27+ 2 . ** Twilio からのイベントを受信できる WebSocket サーバーをセットアップします 。**
2728
28- ローカル開発の場合、Twilio からローカルサーバーへアクセスできるよう、
29- this will require you to configure a local tunnel like [ ` ngrok ` ] ( https://ngrok.io/ ) or
29+ ローカル開発を行う場合は、[ ` ngrok ` ] ( https://ngrok.io/ ) や
3030 [ Cloudflare Tunnel] ( https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/ )
31- を設定する必要があります。 ` TwilioRealtimeTransportLayer ` を使って Twilio に接続できます 。
31+ などのローカルトンネルを設定して、ローカルサーバーを Twilio からアクセス可能にする必要があります。Twilio への接続には ` TwilioRealtimeTransportLayer ` を使用できます 。
3232
33- 3 . ** 拡張パッケージをインストールして Twilio アダプターを導入します:**
33+ 3 . ** 拡張機能パッケージをインストールして Twilio アダプターを導入します:**
3434
3535 ``` bash
3636 npm install @openai/agents-extensions
@@ -54,25 +54,25 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
5454
5555</Steps >
5656
57- ` RealtimeSession ` に期待されるイベントや挙動は 、ツール呼び出し、ガードレールなどを含め、想定どおりに動作します 。` RealtimeSession ` を音声エージェントで使う方法については 、[ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を参照してください。
57+ ` RealtimeSession ` に期待されるあらゆるイベントや動作は 、ツール呼び出し、ガードレールなどを含め、期待どおりに機能します 。` RealtimeSession ` を音声エージェントで使用する方法については 、[ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を参照してください。
5858
5959## ヒントと考慮事項
6060
61- 1 . ** スピードがすべてです 。**
61+ 1 . ** 速度が最重要です 。**
6262
63- Twilio から必要なイベントとオーディオをすべて受け取るため 、WebSocket 接続を参照できたらすぐに ` TwilioRealtimeTransportLayer ` インスタンスを作成し、直ちに ` session.connect() ` を呼び出してください。
63+ Twilio から必要なイベントと音声をすべて受け取るために 、WebSocket 接続を参照できるようになったらすぐに ` TwilioRealtimeTransportLayer ` インスタンスを作成し、直後に ` session.connect() ` を呼び出してください。
6464
65652 . ** Twilio の元イベントにアクセスします。**
6666
67- Twilio から送られてくる元イベントにアクセスしたい場合は 、` RealtimeSession ` インスタンスの ` transport_event ` イベントを監視します 。Twilio のすべてのイベントは ` twilio_message ` の type を持ち 、元イベントデータを含む ` message ` プロパティがあります 。
67+ Twilio から送信される元イベントにアクセスしたい場合は 、` RealtimeSession ` インスタンスの ` transport_event ` を監視します 。Twilio からのすべてのイベントは ` twilio_message ` という type と 、元イベントデータを含む ` message ` プロパティを持ちます 。
6868
69693 . ** デバッグログを確認します。**
7070
71- 状況を詳しく知りたい場合があります。 ` DEBUG=openai-agents* ` 環境変数を使うと Agents SDK からのすべてのデバッグログが表示されます 。あるいは、` DEBUG=openai-agents:extensions:twilio* ` を使用して Twilio アダプターのデバッグログだけを有効にできます。
71+ 状況を詳しく知りたい問題に遭遇することがあります。環境変数 ` DEBUG=openai-agents* ` を使うと Agents SDK のすべてのデバッグログが表示されます 。あるいは、` DEBUG=openai-agents:extensions:twilio* ` を使って Twilio アダプターのデバッグログだけを有効にできます。
7272
73- ## 完全なサーバーの例
73+ ## 完全なサーバー例
7474
75- 以下は、Twilio からのリクエストを受け取り、それを ` RealtimeSession ` に転送する WebSocket サーバーのエンドツーエンドの例です 。
75+ 以下は、Twilio からのリクエストを受け取り、それを ` RealtimeSession ` に転送する WebSocket サーバーのエンドツーエンド例です 。
7676
7777<Code
7878 lang = " typescript"
0 commit comments