Update all translated document pages (#496)

Author: github-actions[bot]

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 の 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,20 +24,20 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
    npm install @openai/agents-extensions
    ```
 
-2. [Vercel の AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) から使用したいモデルのパッケージを選び、インストールします:
+2. [Vercel's AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) から目的のモデルパッケージを選び、インストールします:
 
    ```bash
    npm install @ai-sdk/openai
    ```
 
-3. アダプターとモデルをインポートしてエージェントに接続します:
+3. アダプターとモデルをインポートして、エージェントに接続します:
 
    ```typescript
    import { openai } from '@ai-sdk/openai';
    import { aisdk } from '@openai/agents-extensions';
    ```
 
-4. エージェントで使用するモデルのインスタンスを初期化します:
+4. エージェントが使用するモデルのインスタンスを初期化します:
 
    ```typescript
    const model = aisdk(openai('o4-mini'));
@@ -47,19 +47,23 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
 
 <Aside type="caution">
   現在、ai-sdk の model provider v2 モジュールをサポートしており、これは Vercel
-  AI SDK v5 と互換性があります。特別な理由で v1 の model providers
-  を使い続ける必要がある場合は、
+  AI SDK v5 と互換性があります。特別な理由で v1 の model provider
+  を使い続けたい場合は、
   [examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/tree/main/examples/ai-sdk-v1)
   からモジュールをコピーしてプロジェクトに含めてください。
 </Aside>
 
 ## 例
 
-<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK Setup" />
+<Code
+  lang="typescript"
+  code={aiSdkSetupExample}
+  title="AI SDK のセットアップ"
+/>
 
-## プロバイダーメタデータの受け渡し
+## プロバイダーのメタデータの受け渡し
 
-メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を使用して渡してください。値は基盤の AI SDK モデルにそのまま転送されます。例えば、Agents SDK で次の `providerData`
+メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を通して渡します。値は基盤となる AI SDK モデルへそのまま転送されます。例えば、Agents SDK で次の `providerData`
 
 ```ts
 providerData: {
@@ -82,5 +86,3 @@ providerMetadata: {
   }
 }
 ```
-
-となります。

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

@@ -7,36 +7,37 @@ 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 は、電話の通話音声の元オーディオを WebSocket サーバーに送る [Media Streams API](https://www.twilio.com/docs/voice/media-streams) を提供しています。このセットアップを使って、あなたの[音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents)を Twilio に接続できます。`websocket` モードのデフォルトの Realtime Session トランスポートを使い、Twilio から来るイベントをあなたの Realtime Session に接続できます。ただし、その場合は適切な音声フォーマットの設定と、通話が Web ベースの会話より自然とレイテンシが大きくなるため、独自の割り込みタイミングの調整が必要になります。
+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 transport が使えます。ただし、その場合は適切なオーディオ形式の設定や、Web ベースの会話よりも通話のほうが自然にレイテンシが大きくなるため、割り込みタイミングを自分で調整する必要があります。
 
-セットアップ体験を向上させるために、Twilio への接続、割り込み処理、音声の転送まで行う専用のトランスポートレイヤーを用意しました。
+セットアップ体験を改善するために、Twilio への接続を処理し、割り込み処理や音声転送も行う専用のトランスポートレイヤーを用意しました。
 
 <Aside type="caution">
-  このアダプターはまだベータ版です。まれなケースの問題やバグに遭遇する可能性があります。
-  問題は [GitHub issues](https://github.com/openai/openai-agents-js/issues)
-  から報告してください。迅速に修正します。
+  このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります。
+  問題があれば [GitHub
+  issues](https://github.com/openai/openai-agents-js/issues)
+  に報告してください。すぐに修正します。
 </Aside>
 
 ## セットアップ
 
 <Steps>
 
-1. **Twilio アカウントと Twilio の電話番号を用意します。**
+1. **Twilio アカウントと Twilio の電話番号を用意すること**
 
-2. **Twilio からのイベントを受け取れる WebSocket サーバーを設定します。**
+2. **Twilio からのイベントを受け取れる WebSocket サーバーをセットアップすること**
 
-   ローカル開発の場合は、this will require you to configure a local tunnel like
-   this will require you to configure a local tunnel like [`ngrok`](https://ngrok.io/) や
-   [Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/) を設定して、ローカルサーバーを Twilio からアクセス可能にする必要があります。`TwilioRealtimeTransportLayer`
+   ローカル開発の場合、[`ngrok`](https://ngrok.io/) や
+   [Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
+   のようなローカルトンネルの設定が必要になり、ローカルサーバーを Twilio からアクセス可能にする必要があります。`TwilioRealtimeTransportLayer`
    を使って Twilio に接続できます。
 
-3. **extensions パッケージをインストールして Twilio アダプターを導入します:**
+3. **エクステンションパッケージをインストールして Twilio アダプターを導入すること:**
 
    ```bash
    npm install @openai/agents-extensions
    ```
 
-4. **`RealtimeSession` に接続するためにアダプターとモデルをインポートします:**
+4. **アダプターとモデルをインポートして、`RealtimeSession` に接続すること:**
 
    <Code
      lang="typescript"
@@ -46,37 +47,36 @@ Twilio は、電話の通話音声の元オーディオを WebSocket サーバ
      )}
    />
 
-5. **`RealtimeSession` を Twilio に接続します:**
+5. **`RealtimeSession` を Twilio に接続すること:**
 
    ```typescript
    session.connect({ apiKey: 'your-openai-api-key' });
    ```
 
 </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 からのすべてのイベントは `twilio_message` という type を持ち、元のイベントデータを含む `message` プロパティがあります。
+   Twilio から送られてくる元のイベントにアクセスしたい場合は、`RealtimeSession` インスタンスの
+   `transport_event` をリッスンします。Twilio からのすべてのイベントは `twilio_message` という type を持ち、元のイベントデータを含む `message` プロパティがあります。
 
-3. **デバッグログを確認します。**
+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 サーバーの例です。
 
 <Code
   lang="typescript"