@@ -7,36 +7,36 @@ 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 は、電話の通話音声の元オーディオを WebSocket サーバーに送る [ Media Streams API] ( https://www.twilio.com/docs/voice/media-streams ) を提供しています。この構成を使って、 [ 音声エージェントの概要] ( /openai-agents-js/ja/guides/voice-agents ) を Twilio に接続できます。デフォルトの Realtime Session のトランスポートを ` 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 に接続できます。デフォルトの Realtime Session トランスポートを ` websocket ` モードで使い、Twilio から来るイベントを Realtime Session に接続することも可能です。ただし、その場合は適切なオーディオ形式の設定や 、Web ベースの会話よりも通話では遅延が大きくなるため、割り込みタイミングの調整が必要になります 。
1111
12- セットアップ体験を改善するため、割り込み処理や音声の転送も含め、 Twilio への接続を代わりに処理する専用のトランスポート層を用意しました 。
12+ セットアップ体験を改善するために、 Twilio への接続、割り込み処理、オーディオ転送を代わりに扱う専用のトランスポート層を用意しました 。
1313
1414<Aside type = " caution" >
15- このアダプターはまだベータ版です。稀なケースで問題やバグに遭遇する可能性があります 。
15+ このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります 。
1616 問題は [ GitHub issues] ( https://github.com/openai/openai-agents-js/issues )
17- からご報告ください。迅速に対応します 。
17+ でご報告ください。迅速に修正します 。
1818</Aside >
1919
2020## セットアップ
2121
2222<Steps >
2323
24- 1 . ** Twilio アカウントと Twilio の電話番号を用意します。 **
24+ 1 . ** Twilio アカウントと Twilio の電話番号を用意する **
2525
26- 2 . ** Twilio からのイベントを受け取れる WebSocket サーバーを用意します。 **
26+ 2 . ** Twilio からのイベントを受け取れる WebSocket サーバーを用意する **
2727
28- ローカル開発の場合 、[ ` ngrok ` ] ( https://ngrok.io/ ) や
28+ ローカル開発の場合は 、[ ` ngrok ` ] ( https://ngrok.io/ ) や
2929 [ Cloudflare Tunnel] ( https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/ )
30- のようなローカルトンネルの設定が必要になり、ローカルサーバーを Twilio からアクセス可能にします 。` TwilioRealtimeTransportLayer `
30+ などのローカルトンネルを設定して、ローカル サーバーを Twilio からアクセス可能にする必要があります 。` TwilioRealtimeTransportLayer `
3131 を使って Twilio に接続できます。
3232
33- 3 . ** 拡張パッケージをインストールして Twilio アダプターを導入します: **
33+ 3 . ** 拡張パッケージをインストールして Twilio アダプターを導入する **
3434
3535 ``` bash
3636 npm install @openai/agents-extensions
3737 ```
3838
39- 4 . ** アダプターとモデルをインポートして ` RealtimeSession ` に接続します: **
39+ 4 . ** アダプターとモデルをインポートして ` RealtimeSession ` に接続する **
4040
4141 <Code
4242 lang = " typescript"
@@ -46,36 +46,33 @@ Twilio は、電話の通話音声の元オーディオを WebSocket サーバ
4646 )}
4747 />
4848
49- 5 . ** ` RealtimeSession ` を Twilio に接続します: **
49+ 5 . ** ` RealtimeSession ` を Twilio に接続する **
5050
5151 ``` typescript
5252 session .connect ({ apiKey: ' your-openai-api-key' });
5353 ```
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 接続の参照を得たらすぐに
64- ` TwilioRealtimeTransportLayer ` インスタンスを作成し、直後に ` session.connect() ` を呼び出してください。
63+ Twilio から必要なイベントとオーディオをすべて受け取るため、WebSocket 接続の参照を取得したらすぐに ` TwilioRealtimeTransportLayer ` インスタンスを作成し、その直後に ` session.connect() ` を呼び出してください。
6564
66- 2 . ** Twilio の元イベントにアクセスします。 **
65+ 2 . ** Twilio の 元 イベントへアクセスする **
6766
68- Twilio が送信する元イベントにアクセスしたい場合は、` RealtimeSession ` インスタンスの
69- ` transport_event ` をリッスンします。Twilio からのすべてのイベントは ` twilio_message ` という type と、元のイベントデータを含む ` message ` プロパティを持ちます。
67+ Twilio から送られてくる 元 イベントにアクセスしたい場合は、` RealtimeSession ` インスタンスの ` transport_event ` を購読します。Twilio の各イベントは ` twilio_message ` タイプで、 元 イベントデータを含む ` message ` プロパティを持ちます。
7068
71- 3 . ** デバッグログを確認します。 **
69+ 3 . ** デバッグログを確認する **
7270
73- 状況を詳しく知りたい問題に遭遇することがあります。環境変数 ` DEBUG=openai-agents* ` を使うと Agents SDK のすべてのデバッグログが表示されます。Twilio アダプターのログだけを有効化する場合は
74- ` DEBUG=openai-agents:extensions:twilio* ` を使用します。
71+ 何が起きているかを詳しく知りたい場合があります。環境変数 ` DEBUG=openai-agents* ` を使うと Agents SDK からのすべてのデバッグログが表示されます。あるいは、` DEBUG=openai-agents:extensions:twilio* ` を使って Twilio アダプターのデバッグログだけを有効にできます。
7572
76- ## サーバーのフル例
73+ ## フルサーバー例
7774
78- 以下は、Twilio からリクエストを受け取り 、それを ` RealtimeSession ` に転送する、エンドツーエンドの WebSocket サーバーの例です 。
75+ 以下は、Twilio からのリクエストを受け取り 、それを ` RealtimeSession ` に転送する WebSocket サーバーのエンドツーエンドの例です 。
7976
8077<Code
8178 lang = " typescript"
0 commit comments