Fix document build errors

Author: seratch

.github/workflows/update-docs.yml

@@ -36,7 +36,9 @@ jobs:
       - name: Translate docs
         env:
           OPENAI_API_KEY: ${{ secrets.PROD_OPENAI_API_KEY }}
-        run: pnpm docs:translate
+        run: |
+          pnpm docs:translate
+          pnpm docs:build  # to make sure if the generated docs are valid
 
       - name: Commit changes
         id: commit

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

@@ -7,30 +7,31 @@ 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)
-  からご報告ください。迅速に修正します。
+  このアダプターはまだ beta
+  です。一部のモデルプロバイダー、特に小規模なものでは問題が発生する場合があります。問題は
+  [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. extensions パッケージをインストールして AI SDK アダプターを導入します:
 
    ```bash
    npm install @openai/agents-extensions
    ```
 
-2. [Vercel の 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@"^1.0.0"
    ```
 
-3. アダプターとモデルをインポートし、エージェントに接続します:
+3. アダプターとモデルをインポートして、エージェントに接続します:
 
    ```typescript
    import { openai } from '@ai-sdk/openai';
@@ -47,21 +48,17 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
 
 <Aside type="caution">
   Vercel の AI SDK は最近 v2 に移行しましたが、 openai agent extensions はまだ
-  v2 と互換性がありません。 そのため Vercel の AI SDK の v1
-  をインストールする必要があります。
+  v2 と互換性がありません。 そのため Vercel の AI SDK は v1
+  バージョンをインストールする必要があります。
 </Aside>
 
 ## 例
 
-<Code
-  lang="typescript"
-  code={aiSdkSetupExample}
-  title="AI SDK のセットアップ"
-/>
+<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK セットアップ" />
 
-## プロバイダーメタデータの受け渡し
+## プロバイダーのメタデータの受け渡し
 
-メッセージと一緒にプロバイダー固有のオプションを送信する必要がある場合は、`providerMetadata` を通して渡します。値は基盤の AI SDK のモデルにそのまま転送されます。たとえば、 Agents SDK の次の `providerData`
+メッセージにプロバイダー固有のオプションを添えて送信する必要がある場合は、`providerMetadata` を通して渡します。値は基盤の AI SDK モデルにそのまま転送されます。たとえば、Agents SDK で次の `providerData` は
 
 ```ts
 providerData: {
@@ -73,7 +70,7 @@ providerData: {
 }
 ```
 
-は次のようになります
+AI SDK 連携を使用する場合は
 
 ```ts
 providerMetadata: {
@@ -85,4 +82,4 @@ providerMetadata: {
 }
 ```
 
-AI SDK 連携を使用する場合
+になります。

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

@@ -7,40 +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 は、電話の通話からの raw 音声を 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 は [Media Streams API](https://www.twilio.com/docs/voice/media-streams) を提供しており、電話の通話からの元音声を WebSocket サーバーへ送信します。これは、あなたの [音声エージェントの概要](/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>
 
 ## セットアップ
 
 <Steps>
 
-1. **Twilio アカウントと Twilio 電話番号を用意してください。**
+1. ** Twilio のアカウントと Twilio の電話番号を用意します **
 
-2. **Twilio からのイベントを受け取れる WebSocket サーバーをセットアップしてください。**
+2. ** Twilio からのイベントを受け取れる WebSocket サーバーを用意します **
 
-   ローカルで開発している場合、これは [`ngrok`](https://ngrok.io/) や
+   ローカルで開発している場合、これはローカルトンネルの設定が必要になり、
+   これはローカルトンネルの設定が必要になり、[`ngrok`](https://ngrok.io/) や
    [Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
-   のようなローカルトンネルを設定する必要があることを意味します 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 に接続できます。
+   などを使ってローカルサーバーを Twilio からアクセス可能にします。Twilio への接続には
+   `TwilioRealtimeTransportLayer` を使えます。
 
-3. **拡張パッケージをインストールして Twilio アダプターを導入します:**
+3. ** 拡張パッケージをインストールして Twilio アダプターを導入します **
 
    ```bash
    npm install @openai/agents-extensions
    ```
 
-4. **アダプターとモデルをインポートして `RealtimeSession` に接続します:**
+4. ** `RealtimeSession` に接続するためのアダプターとモデルをインポートします **
 
    <Code
      lang="typescript"
@@ -50,41 +47,41 @@ 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. **スピードが命です。**
+1. ** スピードが命です **
 
-   Twilio から必要なすべてのイベントと音声を受け取るため、WebSocket 接続への参照を取得したらすぐに
+   Twilio から必要なすべてのイベントや音声を受け取るため、WebSocket 接続を参照できるようになったらすぐに
    `TwilioRealtimeTransportLayer` インスタンスを作成し、その直後に `session.connect()` を呼び出してください。
 
-2. **raw な Twilio イベントにアクセス。**
+2. ** Twilio の元イベントにアクセスする **
 
-   Twilio が送信する raw イベントにアクセスしたい場合は、`RealtimeSession` インスタンス上の
-   `transport_event` イベントをリッスンできます。Twilio からのすべてのイベントは `twilio_message` という type と、
-   raw なイベントデータを含む `message` プロパティを持ちます。
+   Twilio が送信する元イベントにアクセスしたい場合は、`RealtimeSession` インスタンスで `transport_event`
+   をリッスンします。Twilio からのすべてのイベントは `twilio_message` という type と、元イベントデータを含む
+   `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 サーバーの完全な end-to-end の例です。
 
 <Code
   lang="typescript"
   code={twilioServerExample}
-  title="Fastify を使用したサーバーの例"
+  title="Fastify を使ったサーバー例"
 />