Update Japanese docs to reflect the latest changes (#197)

Author: seratch

docs/src/content/docs/guides/release.mdx

@@ -3,8 +3,6 @@ title: Release process
 description: Learn how we version and release the SDK and recent changes.
 ---
 
-import { Content as AgentsSdkChangelog } from '../../../../../packages/agents/CHANGELOG.md';
-
 ## Versioning
 
 The project follows a slightly modified version of semantic versioning using the form `0.Y.Z`. The leading `0` indicates the SDK is still evolving rapidly. Increment the components as follows:

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

@@ -7,30 +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's 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. extensions パッケージをインストールして AI SDK アダプターを追加します:
 
    ```bash
    npm install @openai/agents-extensions
    ```
 
-2. [Vercel's AI SDK](https://sdk.vercel.ai/docs/models/overview) から使用したいモデルパッケージを選択してインストールします:
+2. [Vercel の AI SDK](https://sdk.vercel.ai/docs/models/overview) から目的のモデル パッケージを選択してインストールします:
 
    ```bash
    npm install @ai-sdk/openai
    ```
 
-3. エージェントに接続するため、アダプターとモデルをインポートします:
+3. アダプターとモデルをインポートし、エージェントに接続します:
 
    ```typescript
    import { openai } from '@ai-sdk/openai';
@@ -49,9 +49,9 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
 
 <Code lang="typescript" code={aiSdkSetupExample} title="AI SDK Setup" />
 
-## プロバイダーメタデータの渡し方
+## プロバイダー メタデータの渡し方
 
-メッセージにプロバイダー固有のオプションを設定したい場合は、`providerMetadata` にその値を直接指定します。例えば Agents SDK で
+メッセージと一緒にプロバイダー固有のオプションを送信する必要がある場合は、`providerMetadata` に渡してください。値はそのまま基盤となる AI SDK モデルに転送されます。たとえば Agents SDK で次の `providerData` を指定すると
 
 ```ts
 providerData: {
@@ -63,7 +63,7 @@ providerData: {
 }
 ```
 
-と指定していた場合、AI SDK 連携では次のようになります。
+AI SDK 連携使用時には
 
 ```ts
 providerMetadata: {
@@ -74,3 +74,5 @@ providerMetadata: {
   }
 }
 ```
+
+のようになります。

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

@@ -7,35 +7,33 @@ 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 transport を使って、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 に接続できます。デフォルトの Realtime Session トランスポートを `websocket` モードで使用し、Twilio から届くイベントを 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>
 
 ## セットアップ
 
 <Steps>
 
-1. **Twilio アカウントと Twilio 電話番号を用意します。**
+1. **Twilio アカウントと Twilio 電話番号を所有していることを確認します。**
 
-2. **Twilio からのイベントを受信できる WebSocket サーバーを設定します。**
+2. **Twilio からのイベントを受信できる WebSocket サーバーをセットアップします。**
 
-   ローカル開発の場合、Twilio からアクセスできるように [`ngrok`](https://ngrok.io/) や  
-   [Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/) などでローカルトンネルを構成する必要があります。`TwilioRealtimeTransportLayer` を使用して Twilio に接続できます。
+   ローカルで開発している場合は、[`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"
@@ -53,25 +51,28 @@ Twilio は、電話通話の元音声を WebSocket サーバーへ送信する [
 
 </Steps>
 
-`RealtimeSession` から期待できるイベントや動作は、ツール呼び出しやガードレールなどを含め、すべてそのまま利用できます。`RealtimeSession` を音声エージェントで使用する方法については、[音声エージェント](/openai-agents-js/ja/guides/voice-agents) ガイドを参照してください。
+`RealtimeSession` から期待されるすべてのイベントや動作（ツール呼び出し、ガードレールなど）がそのまま利用できます。`RealtimeSession` を音声エージェントで使う方法については [音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents) を参照してください。
 
 ## ヒントと考慮事項
 
-1. **速度が最重要です。**  
-   Twilio から必要なすべてのイベントとオーディオを受け取るために、WebSocket 接続の参照を取得したらすぐに `TwilioRealtimeTransportLayer` インスタンスを作成し、その直後に `session.connect()` を呼び出すようにしてください。
+1. **スピードが鍵です。**
 
-2. **Twilio の元イベントへアクセスする。**  
-   Twilio から送信される生のイベントにアクセスしたい場合、`RealtimeSession` インスタンスの `transport_event` をリッスンできます。Twilio のすべてのイベントは `twilio_message` タイプと、生のイベントデータを含む `message` プロパティを持っています。
+   Twilio から必要なすべてのイベントと音声を受け取るには、WebSocket 接続への参照を取得したらすぐに `TwilioRealtimeTransportLayer` インスタンスを作成し、直ちに `session.connect()` を呼び出してください。
 
-3. **デバッグログを確認する。**  
-   何が起こっているかを詳しく知りたい場合があります。環境変数 `DEBUG=openai-agents*` を使用すると、Agents SDK のすべてのデバッグログが表示されます。あるいは `DEBUG=openai-agents:extensions:twilio*` を使って Twilio アダプターのデバッグログだけを有効にできます。
+2. **Twilio の元イベントにアクセスします。**
 
-## 完全なサーバー例
+   Twilio から送信される元イベントにアクセスしたい場合は、`RealtimeSession` インスタンスの `transport_event` をリッスンできます。Twilio からの各イベントは `twilio_message` という type と、生のイベントデータが入った `message` プロパティを持ちます。
 
-以下は、Twilio からのリクエストを受け取り、それを `RealtimeSession` に転送する WebSocket サーバーのエンドツーエンド例です。
+3. **デバッグログを確認します。**
+
+   詳細を確認したい場合は、`DEBUG=openai-agents*` 環境変数を使用すると Agents SDK のすべてのデバッグログを表示できます。あるいは `DEBUG=openai-agents:extensions:twilio*` を使って Twilio アダプターのログのみに絞ることも可能です。
+
+## フルサーバー例
+
+以下は、Twilio からのリクエストを受け取り `RealtimeSession` に転送する WebSocket サーバーのエンドツーエンド例です。
 
 <Code
   lang="typescript"
   code={twilioServerExample}
-  title="Fastify を使用した例示サーバー"
+  title="Example server using Fastify"
 />