@@ -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 は、電話の通話音声の 元 audio を WebSocket サーバーへ送る [ Media Streams API] ( https://www.twilio.com/docs/voice/media-streams ) を提供しています。このセットアップを使うと 、[ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を Twilio に接続できます。既定の Realtime Session transport を ` websocket ` モードで使用して、Twilio から来るイベントを 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
12- セットアップの体験を向上させるため 、Twilio への接続や割り込み処理、音声の転送までを代わりに処理する専用のトランスポート層を用意しました 。
12+ セットアップ体験を改善するために 、Twilio への接続、割り込み処理、音声転送を扱う専用のトランスポートレイヤーを用意しました 。
1313
1414<Aside type = " caution" >
1515 このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります。
16- 問題は [ GitHub issues] ( https://github.com/openai/openai-agents-js/issues )
17- からご報告ください。迅速に修正します。
16+ 問題があれば [ GitHub
17+ issues] ( https://github.com/openai/openai-agents-js/issues )
18+ に報告してください。迅速に修正します。
1819</Aside >
1920
2021## セットアップ
@@ -23,14 +24,14 @@ Twilio は、電話の通話音声の 元 audio を WebSocket サーバーへ送
2324
24251 . ** Twilio アカウントと Twilio の電話番号を用意します。**
2526
26- 2 . ** Twilio からのイベントを受け取れる WebSocket サーバーをセットアップします。**
27+ 2 . ** Twilio からのイベントを受信できる WebSocket サーバーをセットアップします。**
2728
28- ローカルで開発する場合は 、[ ` ngrok ` ] ( https://ngrok.io/ ) や
29+ ローカルで開発している場合は 、[ ` ngrok ` ] ( https://ngrok.io/ ) や
2930 [ Cloudflare Tunnel] ( https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/ )
30- のようなローカルトンネルの設定が必要になり、 Twilio からローカルの サーバー にアクセスできるようにします 。` TwilioRealtimeTransportLayer `
31+ などのローカルトンネルを設定して、ローカルサーバーを Twilio からアクセス可能にする必要があります 。` TwilioRealtimeTransportLayer `
3132 を使って Twilio に接続できます。
3233
33- 3 . ** extensions パッケージをインストールして Twilio アダプターを導入します:**
34+ 3 . ** 拡張パッケージをインストールして Twilio アダプターを導入します:**
3435
3536 ``` bash
3637 npm install @openai/agents-extensions
@@ -54,31 +55,32 @@ Twilio は、電話の通話音声の 元 audio を WebSocket サーバーへ送
5455
5556</Steps >
5657
57- ` RealtimeSession ` に期待されるあらゆるイベントや動作は、ツール呼び出し、ガードレールなどを含め、期待どおりに機能します 。` RealtimeSession ` を音声エージェントで使う方法の詳細は 、[ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を参照してください。
58+ ` RealtimeSession ` から期待されるイベントや動作は、ツール呼び出しやガードレールなどを含めてそのまま機能します 。` RealtimeSession ` を音声エージェントと併用する方法の詳細は 、[ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を参照してください。
5859
5960## ヒントと考慮事項
6061
61- 1 . ** 速度が最重要です 。**
62+ 1 . ** スピードが最優先です 。**
6263
63- Twilio から必要なイベントや音声をすべて受け取るために 、WebSocket 接続の参照を取得したらすぐに
64- ` TwilioRealtimeTransportLayer ` インスタンスを作成し、直後に ` session.connect() ` を呼び出してください。
64+ Twilio から必要なイベントと音声をすべて受け取るには 、WebSocket 接続の参照を取得したらすぐに
65+ ` TwilioRealtimeTransportLayer ` インスタンスを作成し、その直後に ` session.connect() ` を呼び出してください。
6566
66- 2 . ** Twilio の 元 イベントへアクセスします 。**
67+ 2 . ** Twilio の元イベントにアクセスします 。**
6768
68- Twilio から送信される 元 イベントへアクセスしたい場合は、` RealtimeSession ` インスタンスの
69- ` transport_event ` をリッスンします。Twilio のすべてのイベントは ` twilio_message ` という type を持ち、 元 イベントデータを含む ` message ` プロパティがあります。
69+ Twilio が送信する元イベントにアクセスしたい場合は、` RealtimeSession ` インスタンスの
70+ ` transport_event ` イベントをリッスンします。Twilio からのすべてのイベントは ` twilio_message ` の type を持ち、
71+ 元イベントデータが入った ` message ` プロパティを含みます。
7072
71733 . ** デバッグログを確認します。**
7274
73- 何が起きているかの詳細が必要になることがあります 。環境変数 ` DEBUG=openai-agents* ` を使うと Agents SDK のすべてのデバッグログが表示されます。
74- あるいは、` DEBUG=openai-agents:extensions:twilio* ` を使って Twilio アダプターのデバッグログだけを有効化できます 。
75+ 状況の詳細が必要になることがあります 。環境変数 ` DEBUG=openai-agents* ` を使うと Agents SDK のすべてのデバッグログが表示されます。
76+ あるいは、` DEBUG=openai-agents:extensions:twilio* ` を使用して Twilio アダプターのデバッグログのみに絞ることもできます 。
7577
76- ## サーバーのフル例
78+ ## 完全なサーバーの例
7779
78- 以下は、Twilio からのリクエストを受け取り、` RealtimeSession ` に転送する WebSocket サーバーのエンドツーエンドの例です。
80+ 以下は、Twilio からのリクエストを受け取り、それらを ` RealtimeSession ` に転送する WebSocket サーバーのエンドツーエンドの例です。
7981
8082<Code
8183 lang = " typescript"
8284 code = { twilioServerExample }
83- title = " Example server using Fastify"
85+ title = " Fastify を使ったサーバー例 "
8486/>
0 commit comments