Update all translated document pages (#516)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

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 は標準で Responses API または Chat Completions API を通じて OpenAI のモデルと連携します。別のモデルを使用したい場合は、[Vercel の 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 の 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
    ```
 
-3. アダプターとモデルをインポートしてエージェントに接続します:
+3. アダプターとモデルをインポートし、エージェントに接続します:
 
    ```typescript
    import { openai } from '@ai-sdk/openai';
@@ -46,8 +46,8 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
 </Steps>
 
 <Aside type="caution">
-  現在、ai-sdk の model provider v2 モジュールをサポートしており、これは Vercel
-  AI SDK v5 と互換性があります。特別な理由で v1 の model provider
+  現在、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>
@@ -56,9 +56,9 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
 
 <Code lang="typescript" code={aiSdkSetupExample} title="AI SDK Setup" />
 
-## プロバイダー メタデータの受け渡し
+## プロバイダーのメタデータの受け渡し
 
-メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` に渡します。値は基盤となる AI SDK モデルにそのまま転送されます。たとえば、Agents SDK で次の `providerData`
+メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を通して渡します。値は基盤となる AI SDK のモデルにそのまま転送されます。例えば、Agents SDK で次の `providerData`
 
 ```ts
 providerData: {
@@ -70,7 +70,7 @@ providerData: {
 }
 ```
 
-は、AI SDK 連携を使用すると次のようになります
+は、AI SDK 連携を使う場合は次のようになります
 
 ```ts
 providerMetadata: {
@@ -81,5 +81,3 @@ providerMetadata: {
   }
 }
 ```
-
-となります。

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

@@ -1,19 +1,18 @@
 ---
-title: Cloudflare Workers で Realtime Agent を使う
+title: Cloudflare Workers 用トランスポート
 description: Connect your Agents SDK agents from Cloudflare Workers/workerd using a dedicated transport.
 ---
 
 import { Aside, Steps, Code } from '@astrojs/starlight/components';
 import cloudflareBasicExample from '../../../../../../examples/docs/extensions/cloudflare-basic.ts?raw';
 
-Cloudflare Workers やその他の workerd ランタイムでは、グローバルの `WebSocket` コンストラクターを使ってアウトバウンド WebSocket を開けません。こうした環境から Realtime Agent を簡単に接続できるようにするため、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` の有効化を検討してください。
+  このアダプターはまだベータ版です。エッジケースの問題やバグに遭遇する可能性があります。
+  問題は [GitHub issues](https://github.com/openai/openai-agents-js/issues)
+  からご報告ください。迅速に修正します。Workers で Node.js スタイルの API
+  が必要な場合は、`nodejs_compat` の有効化をご検討ください。
 </Aside>
 
 ## セットアップ
@@ -26,20 +25,20 @@ Cloudflare Workers やその他の workerd ランタイムでは、グローバ
    npm install @openai/agents-extensions
    ```
 
-2. **トランスポートを作成し、セッションに設定します。**
+2. **トランスポートを作成し、セッションにアタッチします。**
 
    <Code lang="typescript" code={cloudflareBasicExample} />
 
-3. **`RealtimeSession` を接続します。**
+3. **`RealtimeSession` に接続します。**
 
    ```typescript
    await session.connect({ apiKey: 'your-openai-ephemeral-or-server-key' });
    ```
 
 </Steps>
 
-## メモ
+## 注意事項
 
-- Cloudflare 用トランスポートは内部で `fetch()` と `Upgrade: websocket` を使用し、ソケットの `open` イベントを待たずに workerd の API に合わせています。
-- このトランスポートを使っても、ツールやガードレールなど `RealtimeSession` の機能は通常どおり動作します。
-- 開発中に詳細なログを確認するには、`DEBUG=openai-agents*` を設定します。
+- Cloudflare トランスポートは内部で `fetch()` と `Upgrade: websocket` を使用し、ソケットの `open` イベントを待たずに処理します。これは workerd APIs に一致します
+- このトランスポートを使用しても、`RealtimeSession` のすべての機能（ツール、ガードレールなど）は通常どおり動作します
+- 開発中の詳細ログを確認するには、`DEBUG=openai-agents*` を使用します

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

@@ -7,37 +7,38 @@ 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 は、電話の **raw** オーディオを 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 は、電話の **元** 音声を 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
+  このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります。
+  問題があれば [GitHub
   issues](https://github.com/openai/openai-agents-js/issues)
-  からご報告ください。迅速に対応します。
+  から報告してください。迅速に修正します。
 </Aside>
 
 ## セットアップ
 
 <Steps>
 
-1. **Twilio アカウントと Twilio の電話番号を用意します。**
+1. **Twilio アカウントと Twilio の電話番号を用意すること。**
 
-2. **Twilio からのイベントを受け取れる WebSocket サーバーを用意します。**
+2. **Twilio からのイベントを受け取れる WebSocket サーバーをセットアップすること。**
 
-   ローカル開発の場合は、[`ngrok`](https://ngrok.io/) や
+   ローカル開発の場合、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`
+   を使って、ローカルサーバーを Twilio からアクセス可能にする必要があります。`TwilioRealtimeTransportLayer`
    を使って Twilio に接続できます。
 
-3. **extensions パッケージをインストールして Twilio アダプターを導入します:**
+3. **拡張パッケージをインストールして Twilio アダプターを導入すること:**
 
    ```bash
    npm install @openai/agents-extensions
    ```
 
-4. **アダプターとモデルをインポートして `RealtimeSession` に接続します:**
+4. **アダプターとモデルをインポートして `RealtimeSession` に接続すること:**
 
    <Code
      lang="typescript"
@@ -47,40 +48,42 @@ Twilio は、電話の **raw** オーディオを 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. **スピードが最重要です。**
 
-   Twilio から必要なイベントとオーディオを受け取るには、WebSocket 接続の参照を取得したらすぐに
+   Twilio から必要なイベントと音声をすべて受け取るために、WebSocket 接続の参照を得たらすぐに
    `TwilioRealtimeTransportLayer` インスタンスを作成し、直ちに `session.connect()` を呼び出してください。
 
-2. **Twilio の raw イベントにアクセスします。**
+2. **Twilio の元イベントにアクセスする。**
 
-   Twilio が送信する **raw** イベントにアクセスしたい場合は、`RealtimeSession` インスタンスの
-   `transport_event` をリッスンします。Twilio からのすべてのイベントは `twilio_message` という type を持ち、
-   **raw** イベントデータを含む `message` プロパティを持ちます。
+   Twilio から送られてくる元イベントにアクセスしたい場合は、`RealtimeSession` インスタンスの
+   `transport_event` をリッスンします。Twilio からのすべてのイベントは `twilio_message` タイプで、
+   元のイベントデータを含む `message` プロパティを持ちます。
 
-3. **デバッグログを確認します。**
+3. **デバッグログを確認する。**
 
-   状況を詳しく把握したい場合は、環境変数 `DEBUG=openai-agents*` を使うと Agents SDK のすべてのデバッグログが表示されます。
-   もしくは、`DEBUG=openai-agents:extensions:twilio*` で Twilio アダプターのデバッグログだけを有効にできます。
+   状況を詳しく知りたい問題に遭遇することがあります。`DEBUG=openai-agents*` 環境変数を使うと、
+   Agents SDK からのすべてのデバッグログが表示されます。あるいは、Twilio アダプターだけのデバッグログを
+   有効にするには `DEBUG=openai-agents:extensions:twilio*` を使用します。
 
-## 完全なサーバー例
+## サーバーの完全な例
 
-以下は、Twilio からのリクエストを受け取り、`RealtimeSession` に転送する WebSocket サーバーのエンドツーエンドのサンプルです。
+以下は、Twilio からのリクエストを受け取り、それを `RealtimeSession` に転送する WebSocket サーバーの
+エンドツーエンドの完全な例です。
 
 <Code
   lang="typescript"
   code={twilioServerExample}
-  title="Fastify を使用したサーバー例"
+  title="Fastify を使ったサーバー例"
 />