Update the translation pipeline script and apply the latest changest to ja docs

Author: seratch

docs/src/content/docs/ja/extensions/ai-sdk.mdx

@@ -7,12 +7,12 @@ import { Aside, Steps, Code } from '@astrojs/starlight/components';
 import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk-setup.ts?raw';
 
 <Aside type="caution">
-  このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題を発見された場合は
+  このアダプターはまだベータ版です。特に規模の小さなモデルプロバイダーでは問題が発生する可能性があります。問題を見つけた場合は
   [GitHub issues](https://github.com/openai/openai-agents-js/issues)
-  からご報告ください。迅速に対応します。
+  でご報告ください。迅速に対応します。
 </Aside>
 
-Agents SDK は、標準で Responses API または Chat Completions API を通じて OpenAI モデルと動作します。別のモデルを使用したい場合は、[Vercel's AI SDK](https://sdk.vercel.ai/) がサポートするさまざまなモデルを、このアダプター経由で Agents SDK に組み込むことができます。
+Agents SDK は標準で OpenAI モデルを Responses API または Chat Completions API 経由で利用できます。しかし、別のモデルを使用したい場合は、[Vercel's AI SDK](https://sdk.vercel.ai/) がサポートしている各種モデルを本アダプター経由で Agents SDK に統合できます。
 
 ## セットアップ
 
@@ -24,13 +24,13 @@ Agents SDK は、標準で Responses API または Chat Completions API を通
    npm install @openai/agents-extensions
    ```
 
-2. [Vercel's AI SDK](https://sdk.vercel.ai/docs/models/overview) から使用したいモデルパッケージを選択してインストールします:
+2. [Vercel's AI SDK](https://sdk.vercel.ai/docs/models/overview) から目的のモデルパッケージを選び、インストールします:
 
    ```bash
    npm install @ai-sdk/openai
    ```
 
-3. エージェントに接続するためにアダプターとモデルをインポートします:
+3. アダプターとモデルをインポートしてエージェントに接続します:
 
    ```typescript
    import { openai } from '@ai-sdk/openai';
@@ -47,4 +47,4 @@ Agents SDK は、標準で Responses API または Chat Completions API を通
 
 ## 例
 
-<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK セットアップ" />
+<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK Setup" />

docs/src/content/docs/ja/extensions/twilio.mdx

@@ -7,15 +7,15 @@ import { Aside, Steps, Code } from '@astrojs/starlight/components';
 import twilioBasicExample from '../../../../../../examples/docs/extensions/twilio-basic.ts?raw';
 import twilioServerExample from '../../../../../../examples/realtime-twilio/index.ts?raw';
 
-Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams) を提供しており、通話の元音声を WebSocket サーバーへ送信できます。これを利用して、あなたの[音声エージェント](../guides/voice-agents) を Twilio に接続できます。`websocket` モードのデフォルト Realtime Session トランスポートを使えば、Twilio からのイベントを Realtime Session に接続できます。しかし、正しいオーディオ形式の設定と、Web ベースの会話よりも遅延が大きい電話通話に合わせた割り込みタイミングの調整が必要になります。
+Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams) を提供しており、電話通話の 元 オーディオを WebSocket サーバーへ送信できます。この構成を利用して、あなたの [音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents) を Twilio に接続できます。`websocket` モードのデフォルト Realtime Session トランスポートを使って、Twilio から送られてくるイベントを Realtime Session に接続することも可能ですが、音声形式を正しく設定し、Web ベースの会話よりも遅延が大きくなる電話通話に合わせて割り込みタイミングを調整する必要があります。
 
-このセットアップを簡単にするために、Twilio への接続、割り込み処理、音声転送を自動で行う専用のトランスポートレイヤーを作成しました。
+セットアップ体験を向上させるために、Twilio への接続、割り込み処理、オーディオ転送を自動で行う専用のトランスポートレイヤーを用意しました。
 
 <Aside type="caution">
-  このアダプターはまだベータ版です。まれに想定外のケースやバグに遭遇する可能性があります。
+  このアダプターはまだベータ版です。まれにエッジケースの問題やバグに遭遇する可能性があります。
   問題が発生した場合は [GitHub
   issues](https://github.com/openai/openai-agents-js/issues)
-  に報告してください。迅速に対応します。
+  でご報告ください。迅速に対応します。
 </Aside>
 
 ## セットアップ
@@ -24,18 +24,19 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
 
 1. **Twilio アカウントと Twilio 電話番号を用意してください。**
 
-2. **Twilio からのイベントを受信できる WebSocket サーバーをセットアップします。**
+2. **Twilio からのイベントを受け取る WebSocket サーバーをセットアップしてください。**
 
-   ローカルで開発する場合は、[`ngrok`](https://ngrok.io/) や
-   [Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/) のようなローカルトンネルを設定し、ローカルサーバーを Twilio からアクセス可能にする必要があります。`TwilioRealtimeTransportLayer` を使って Twilio に接続できます。
+   ローカル開発の場合、これには [`ngrok`](https://ngrok.io/) や
+   [Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
+   のようなローカルトンネルを設定する必要があります。`TwilioRealtimeTransportLayer` を使って Twilio に接続できます。
 
 3. **extensions パッケージをインストールして Twilio アダプターを追加します:**
 
    ```bash
    npm install @openai/agents-extensions
    ```
 
-4. **アダプターとモデルをインポートして `RealtimeSession` に接続します:**
+4. **アダプターとモデルをインポートし、`RealtimeSession` に接続します:**
 
    <Code
      lang="typescript"
@@ -53,28 +54,32 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
 
 </Steps>
 
-`RealtimeSession` で期待できるすべてのイベントや挙動 ― ツール呼び出し、ガードレール など ― がそのまま機能します。`RealtimeSession` を音声エージェントで使用する方法は、[音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents) を参照してください。
+`RealtimeSession` で期待されるツール呼び出しや ガードレール などのイベントや動作はすべてそのまま機能します。`RealtimeSession` を音声エージェントと組み合わせて使う方法については、[音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents) を参照してください。
 
-## ヒントと注意事項
+## ヒントと考慮事項
 
-1. **速度が最重要です。**
+1. **速度がすべてです。**
 
-   必要なイベントと音声を Twilio から受け取るためには、WebSocket 接続を取得したらすぐに `TwilioRealtimeTransportLayer` インスタンスを生成し、直後に `session.connect()` を呼び出してください。
+   必要なイベントとオーディオを Twilio から受け取るために、WebSocket 接続を取得したらすぐ
+   `TwilioRealtimeTransportLayer` インスタンスを作成し、直後に `session.connect()` を呼び出してください。
 
-2. **元の Twilio イベントへアクセスする。**
+2. **元の Twilio イベントにアクセスする。**
 
-   Twilio から送信される生イベントを取得したい場合は、`RealtimeSession` インスタンスで `transport_event` をリッスンしてください。Twilio からの各イベントは `type: twilio_message` を持ち、`message` プロパティに元イベントデータが入っています。
+   Twilio から送られてくる 元 イベントを取得したい場合、`RealtimeSession` インスタンスの
+   `transport_event` をリッスンしてください。Twilio からの各イベントは `twilio_message` タイプと、
+   生のイベントデータが入った `message` プロパティを持ちます。
 
 3. **デバッグログを確認する。**
 
-   状況を詳しく確認したい場合は、環境変数 `DEBUG=openai-agents*` を設定すると Agents SDK のすべてのデバッグログが表示されます。Twilio アダプターのログだけを有効にする場合は `DEBUG=openai-agents:extensions:twilio*` を使用してください。
+   何が起きているか詳細を知りたい場合、環境変数 `DEBUG=openai-agents*` を設定すると Agents SDK のすべてのデバッグログが表示されます。
+   あるいは Twilio アダプターのログだけを見たい場合は `DEBUG=openai-agents:extensions:twilio*` を使用してください。
 
 ## 完全なサーバー例
 
-以下は、Twilio からのリクエストを受け取り、それを `RealtimeSession` に転送する WebSocket サーバーのエンドツーエンド例です。
+以下は Twilio からのリクエストを受け取り、それを `RealtimeSession` に転送する WebSocket サーバーの end-to-end 例です。
 
 <Code
   lang="typescript"
   code={twilioServerExample}
-  title="Fastify を使ったサーバー例"
+  title="Example server using Fastify"
 />