Update all translated document pages (#790)

Author: github-actions[bot]

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

@@ -7,31 +7,30 @@ 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)
+  このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題があれば
+  [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 に取り込めます。
 
 ## セットアップ
 
 <Steps>
 
-1. 拡張機能パッケージをインストールして AI SDK アダプターを導入します:
+1. 拡張パッケージをインストールして AI SDK アダプターを導入します:
 
    ```bash
    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';
@@ -48,23 +47,19 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
 
 <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 のセットアップ"
-/>
+<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK Setup" />
 
-## プロバイダー メタデータの受け渡し
+## プロバイダーのメタデータの受け渡し
 
-メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を通して渡します。値は基盤の AI SDK モデルにそのままフォワードされます。例えば、Agents SDK における次の `providerData`
+メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を介して渡します。値は基盤の AI SDK モデルにそのまま転送されます。たとえば、Agents SDK で次の `providerData`
 
 ```ts
 providerData: {
@@ -76,7 +71,7 @@ providerData: {
 }
 ```
 
-は、AI SDK 連携を使用する場合に
+は、AI SDK 連携を使用する場合
 
 ```ts
 providerMetadata: {
@@ -88,4 +83,4 @@ providerMetadata: {
 }
 ```
 
-となります。
+のようになります。

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

@@ -6,13 +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` の有効化をご検討ください。
+  このアダプターはまだベータ版です。まれなケースの問題やバグに遭遇する可能性があります。
+  問題があれば [GitHub
+  issues](https://github.com/openai/openai-agents-js/issues)
+  から報告してください。迅速に修正します。Workers で Node.js 風の API
+  を使う場合は、`nodejs_compat` の有効化を検討してください。
 </Aside>
 
 ## セットアップ
@@ -25,7 +26,7 @@ Cloudflare Workers とその他の workerd ランタイムは、グローバル
    npm install @openai/agents-extensions
    ```
 
-2. **トランスポートを作成し、セッションに関連付けます。**
+2. **トランスポートを作成し、セッションにアタッチします。**
 
    <Code lang="typescript" code={cloudflareBasicExample} />
 
@@ -39,6 +40,6 @@ Cloudflare Workers とその他の workerd ランタイムは、グローバル
 
 ## 注意事項
 
-- Cloudflare トランスポートは内部的に `Upgrade: websocket` を伴う `fetch()` を使用し、ソケットの `open` イベント待ちをスキップします。これは workerd の API に一致します
-- このトランスポート使用時も、すべての `RealtimeSession` 機能（ツール、ガードレールなど）は通常どおり動作します
-- 開発中の詳細ログの確認には `DEBUG=openai-agents*` を使用します
+- Cloudflare トランスポートは内部で `Upgrade: websocket` を伴う `fetch()` を使用し、ソケットの `open` イベント待ちをスキップします。workerd の API と揃えています
+- このトランスポート使用時も、すべての `RealtimeSession` 機能（ツール、ガードレールなど）が通常どおり動作します
+- 開発中の詳細ログ確認には `DEBUG=openai-agents*` を使用してください

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

@@ -7,31 +7,31 @@ 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 に接続できます。デフォルトの Realtime Session のトランスポートを `websocket` モードで使用して、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 に接続できます。`websocket` モードのデフォルトの Realtime Session トランスポートを使って、Twilio から来るイベントを Realtime Session に接続できます。ただし、電話は Web ベースの会話よりもレイテンシーが大きくなりがちなため、適切なオーディオ形式の設定や、割り込みタイミングの調整が必要になります。
 
-セットアップ体験を改善するために、Twilio への接続を処理する専用のトランスポートレイヤーを作成しました。割り込み処理や音声のフォワーディングも含めて対応します。
+セットアップ体験を改善するために、Twilio への接続、割り込み処理、オーディオ転送を代行する専用のトランスポートレイヤーを用意しました。
 
 <Aside type="caution">
-  このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります。
+  このアダプターはまだベータ版です。エッジケースの問題やバグに遭遇する可能性があります。
   問題があれば [GitHub
   issues](https://github.com/openai/openai-agents-js/issues)
-  からご報告ください。迅速に修正します。
+  で報告してください。迅速に修正します。
 </Aside>
 
 ## セットアップ
 
 <Steps>
 
-1. **Twilio アカウントと Twilio の電話番号を用意します。**
+1. **Twilio のアカウントと電話番号を用意します。**
 
 2. **Twilio からのイベントを受け取れる WebSocket サーバーをセットアップします。**
 
-   ローカルで開発する場合は、[`ngrok`](https://ngrok.io/) や
+   ローカル開発の場合、[`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
@@ -55,27 +55,28 @@ 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. **スピードが最重要です。**
 
-   Twilio から必要なイベントと音声をすべて受け取るために、WebSocket 接続の参照を取得したらすぐに
+   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` タイプを持ち、元のイベントデータを含む `message` プロパティがあります。
 
 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"