Update all translated document pages (#548)

Author: github-actions[bot]

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

@@ -9,10 +9,10 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
 <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 は標準で Responses API または Chat Completions API を通じて OpenAI モデルと連携します。別のモデルを使用したい場合は、[Vercel の AI SDK](https://sdk.vercel.ai/) が提供する幅広い対応モデルを、このアダプターを介して Agents SDK に取り込むことができます。
 
 ## セットアップ
 
@@ -24,7 +24,7 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
    npm install @openai/agents-extensions
    ```
 
-2. [Vercel の AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) から使用したいモデルパッケージを選び、インストールします:
+2. [Vercel の AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) から使用したいモデルのパッケージを選び、インストールします:
 
    ```bash
    npm install @ai-sdk/openai
@@ -37,7 +37,7 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
    import { aisdk } from '@openai/agents-extensions';
    ```
 
-4. エージェントで使用するモデルのインスタンスを初期化します:
+4. エージェントが使用するモデルのインスタンスを初期化します:
 
    ```typescript
    const model = aisdk(openai('gpt-5-mini'));
@@ -46,19 +46,19 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
 </Steps>
 
 <Aside type="caution">
-  現在、ai-sdk のモデルプロバイダー v2 モジュールに対応しており、これは Vercel
-  AI SDK v5 と互換性があります。特別な理由で v1
-  のモデルプロバイダーを使い続ける必要がある場合は、[examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/tree/main/examples/ai-sdk-v1)
+  現在は ai-sdk の model provider v2 モジュールのみをサポートしており、これは
+  Vercel 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: {
@@ -81,5 +81,3 @@ providerMetadata: {
   }
 }
 ```
-
-となります。

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

@@ -6,14 +6,14 @@ description: Connect your Agents SDK agents from Cloudflare Workers/workerd usin
 import { Aside, Steps, Code } from '@astrojs/starlight/components';
 import cloudflareBasicExample from '../../../../../../examples/docs/extensions/cloudflare-basic.ts?raw';
 
-Cloudflare Workers と他の workerd ランタイムでは、グローバル `WebSocket` コンストラクタを使って外向きの WebSocket を開くことはできません。これらの環境から Realtime Agents への接続を簡素化するために、extensions パッケージは内部で `fetch()` ベースのアップグレードを行う専用のトランスポートを提供します。
+Cloudflare Workers およびその他の workerd ランタイムでは、グローバルな `WebSocket` コンストラクターを使った外向きの WebSocket を開くことができません。これらの環境から リアルタイムエージェント に簡単に接続できるよう、extensions パッケージは内部で `fetch()` ベースのアップグレードを行う専用のトランスポートを提供します。
 
 <Aside type="caution">
-  このアダプターはまだベータ版です。まれなケースの問題やバグが発生する可能性があります。
+  このアダプターはまだベータ版です。稀なケースで問題やバグに遭遇する可能性があります。
   問題があれば [GitHub
   issues](https://github.com/openai/openai-agents-js/issues)
-  からご報告ください。迅速に対応します。Workers 内で Node.js 風の API
-  を利用したい場合は、`nodejs_compat` の有効化を検討してください。
+  に報告してください。迅速に対応します。Workers で Node.js 風 API
+  を利用する場合は、`nodejs_compat` の有効化を検討してください。
 </Aside>
 
 ## セットアップ
@@ -30,7 +30,7 @@ Cloudflare Workers と他の workerd ランタイムでは、グローバル `We
 
    <Code lang="typescript" code={cloudflareBasicExample} />
 
-3. **`RealtimeSession` に接続します。**
+3. **`RealtimeSession` を接続します。**
 
    ```typescript
    await session.connect({ apiKey: 'your-openai-ephemeral-or-server-key' });
@@ -40,6 +40,6 @@ Cloudflare Workers と他の workerd ランタイムでは、グローバル `We
 
 ## 注意事項
 
-- Cloudflare 用トランスポートは内部的に `Upgrade: websocket` を付与した `fetch()` を使用し、ソケットの `open` イベントを待たずに進みます。これは workerd の API に合わせています
+- Cloudflare トランスポートは内部で `Upgrade: websocket` を伴う `fetch()` を使用し、ソケットの `open` イベントを待たずに進みます。workerd の API に合わせた動作です
 - このトランスポート使用時も、すべての `RealtimeSession` 機能（tools、ガードレール など）は通常どおり動作します
-- 開発時の詳細ログを確認するには `DEBUG=openai-agents*` を使用します
+- 開発中の詳細ログ確認には `DEBUG=openai-agents*` を使用します

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

@@ -7,14 +7,14 @@ 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 サーバーに送信します。この構成を使って、あなたの [音声エージェントの概要](/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 トランスポートを使用できます。ただし、通話は 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>
 
 ## セットアップ
@@ -23,14 +23,12 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
 
 1. **Twilio アカウントと Twilio の電話番号を用意します。**
 
-2. **Twilio からのイベントを受け取れる WebSocket サーバーをセットアップします。**
+2. **Twilio からのイベントを受信できる WebSocket サーバーをセットアップします。**
 
-   ローカル開発の場合、ローカル トンネルの構成が必要です。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`
-   を使って Twilio に接続できます。
+   ローカルで開発する場合は、[`ngrok`](https://ngrok.io/) や
+   [Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/) のようなローカルトンネルを設定して、ローカル サーバーを Twilio から到達可能にする必要があります。Twilio に接続するには `TwilioRealtimeTransportLayer` を使用できます。
 
-3. **extensions パッケージをインストールして Twilio アダプターを導入します:**
+3. **拡張パッケージをインストールして Twilio アダプターを導入します:**
 
    ```bash
    npm install @openai/agents-extensions
@@ -54,28 +52,30 @@ 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 の 元 イベントにアクセスします。**
 
-   Twilio が送信する 元 イベントにアクセスしたい場合は、`RealtimeSession` インスタンスで `transport_event` をリッスンします。Twilio からのすべてのイベントは `twilio_message` という type と、 元 イベント データを含む `message` プロパティを持ちます。
+   Twilio から送信される 元 イベントにアクセスしたい場合は、`RealtimeSession` インスタンスの
+   `transport_event` イベントをリッスンします。Twilio のすべてのイベントは `twilio_message` という type と、 元 イベントデータを含む `message` プロパティを持ちます。
 
 3. **デバッグログを確認します。**
 
-   状況を詳しく知りたい問題に遭遇することがあります。環境変数 `DEBUG=openai-agents*` を使うと Agents SDK のすべてのデバッグログが表示されます。あるいは、`DEBUG=openai-agents:extensions:twilio*` を使って Twilio アダプターのデバッグログだけを有効にできます。
+   何が起きているかの詳細が必要になる場合があります。環境変数 `DEBUG=openai-agents*` を使用すると、Agents SDK のすべてのデバッグログが表示されます。あるいは、`DEBUG=openai-agents:extensions:twilio*` を使用して Twilio アダプターのデバッグログのみに限定できます。
 
-## サーバーの完全なコード例
+## サーバーの完全な例
 
 以下は、Twilio からのリクエストを受け取り、それを `RealtimeSession` に転送する WebSocket サーバーのエンドツーエンドの例です。
 
 <Code
   lang="typescript"
   code={twilioServerExample}
-  title="Fastify を使ったサーバー例"
+  title="Fastify を使用したサーバーの例"
 />