Skip to content

Commit 6dff1b8

Browse files
Update all translated document pages (#431)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 34c4b8d commit 6dff1b8

24 files changed

+558
-560
lines changed

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

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,18 +7,18 @@ import { Aside, Steps, Code } from '@astrojs/starlight/components';
77
import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk-setup.ts?raw';
88

99
<Aside type="caution">
10-
このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題があれば
10+
このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題が発生した場合は
1111
[GitHub issues](https://github.com/openai/openai-agents-js/issues)
12-
までご報告ください。迅速に修正します。
12+
からご報告ください。迅速に修正します。
1313
</Aside>
1414

15-
Agents SDK は標準で Responses API または Chat Completions API を通じて OpenAI モデルで動作します。別のモデルを使用したい場合は、[Vercel の AI SDK](https://sdk.vercel.ai/) が幅広い対応モデルを提供しており、このアダプターを介して Agents SDK に組み込むことができます
15+
Agents SDK は標準で Responses API または Chat Completions API を通じて OpenAI モデルと連携します。別のモデルを使用したい場合は、[Vercel の AI SDK](https://sdk.vercel.ai/) が提供する多様な対応モデルを、このアダプター経由で Agents SDK に組み込めます
1616

1717
## セットアップ
1818

1919
<Steps>
2020

21-
1. 拡張パッケージをインストールして AI SDK アダプターを導入します:
21+
1. extensions パッケージをインストールして AI SDK アダプターを導入します:
2222

2323
```bash
2424
npm install @openai/agents-extensions
@@ -46,11 +46,10 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
4646
</Steps>
4747

4848
<Aside type="caution">
49-
現在、ai-sdk のモデルプロバイダー v2 モジュールをサポートしており、Vercel AI
50-
SDK v5 と互換性があります。特別な理由で v1
51-
のモデルプロバイダーを使い続けたい場合は、
52-
[examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/tree/main/examples/ai-sdk-v1)
53-
からモジュールをコピーしてプロジェクトに含めてください。
49+
現在は ai-sdk の model provider v2 モジュールに対応しており、Vercel AI SDK v5
50+
と互換性があります。特別な理由で v1 の model provider
51+
を使い続けたい場合は、[examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/tree/main/examples/ai-sdk-v1)
52+
からモジュールをコピーして、プロジェクトに含めてください。
5453
</Aside>
5554

5655
##
@@ -59,7 +58,7 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
5958

6059
## プロバイダー メタデータの受け渡し
6160

62-
メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を通して渡します。値は基盤となる AI SDK のモデルにそのまま転送されます。例えば、Agents SDK で次の `providerData`
61+
メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を介して渡します。値は基盤となる AI SDK モデルへそのまま転送されます。例えば、Agents SDK で次の `providerData`
6362

6463
```ts
6564
providerData: {
@@ -71,7 +70,7 @@ providerData: {
7170
}
7271
```
7372

74-
は、AI SDK 連携を使用すると次のようになります
73+
は、AI SDK 連携を使用すると
7574

7675
```ts
7776
providerMetadata: {
@@ -82,3 +81,5 @@ providerMetadata: {
8281
}
8382
}
8483
```
84+
85+
になります。

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

Lines changed: 23 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,36 +7,37 @@ import { Aside, Steps, Code } from '@astrojs/starlight/components';
77
import twilioBasicExample from '../../../../../../examples/docs/extensions/twilio-basic.ts?raw';
88
import twilioServerExample from '../../../../../../examples/realtime-twilio/index.ts?raw';
99

10-
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 ベースの会話よりも通話のほうが遅延が大きくなりがちであることを踏まえた割り込みタイミングの調整が必要です
10+
Twilio は、通話のaudio を 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 ベースの会話よりも遅延が大きくなるため、適切な audio フォーマットの設定と、独自の割り込みタイミングの調整が必要です
1111

12-
セットアップをより簡単にするため、Twilio への接続、割り込み処理、音声転送などを代わりに処理する専用のトランスポートレイヤーを用意しました
12+
セットアップの体験を向上させるため、Twilio への接続、割り込み処理、audio 転送を含めて処理する専用のトランスポートレイヤーを用意しました
1313

1414
<Aside type="caution">
15-
このアダプターはまだベータ版です。まれにエッジケースの問題やバグに遭遇する可能性があります
15+
このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります
1616
問題があれば [GitHub
1717
issues](https://github.com/openai/openai-agents-js/issues)
18-
に報告してください。迅速に対応します。
18+
から報告してください。迅速に対応します。
1919
</Aside>
2020

2121
## セットアップ
2222

2323
<Steps>
2424

25-
1. **Twilio アカウントと Twilio 電話番号を用意します**
25+
1. **Twilio アカウントと Twilio の電話番号を用意します**
2626

2727
2. **Twilio からのイベントを受け取れる WebSocket サーバーをセットアップします。**
2828

29-
ローカル開発の場合は[`ngrok`](https://ngrok.io/)
29+
ローカル開発の場合[`ngrok`](https://ngrok.io/)
3030
[Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
31-
のようなローカルトンネルを設定して、ローカル サーバーを Twilio からアクセス可能にする必要があります。Twilio への接続には `TwilioRealtimeTransportLayer` を使用できます。
31+
のようなローカルトンネルの設定が必要になり、ローカルサーバーを Twilio から到達可能にします。`TwilioRealtimeTransportLayer`
32+
を使って Twilio に接続できます。
3233

33-
3. **拡張パッケージをインストールして Twilio アダプターを導入します:**
34+
3. **extensions パッケージをインストールして Twilio アダプターを導入します:**
3435

3536
```bash
3637
npm install @openai/agents-extensions
3738
```
3839

39-
4. **アダプターとモデルをインポートして `RealtimeSession` に接続します:**
40+
4. **アダプターと model をインポートして `RealtimeSession` に接続します:**
4041

4142
<Code
4243
lang="typescript"
@@ -54,28 +55,31 @@ Twilio は、電話の通話音声の 元 オーディオを WebSocket サーバ
5455

5556
</Steps>
5657

57-
`RealtimeSession` で期待できるあらゆるイベントや挙動は、ツール呼び出し、ガードレールなどを含めてそのまま動作します`RealtimeSession` を音声エージェントで使う方法については、[音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents) を参照してください。
58+
`RealtimeSession` に期待されるあらゆるイベントや挙動は、ツール呼び出し、ガードレールなどを含めて、そのまま機能します`RealtimeSession` を音声エージェントで使う方法については、[音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents) を参照してください。
5859

5960
## ヒントと考慮事項
6061

61-
1. **スピードが重要です**
62+
1. **スピードが最重要です**
6263

63-
Twilio から必要なすべてのイベントと音声を受け取るため、WebSocket 接続の参照を取得したらすぐに `TwilioRealtimeTransportLayer` インスタンスを作成し、続けて直ちに `session.connect()` を呼び出してください。
64+
Twilio から必要なイベントと audio をすべて受け取るため、WebSocket 接続の参照を取得したらすぐに
65+
`TwilioRealtimeTransportLayer` インスタンスを作成し、直ちに `session.connect()` を呼び出してください。
6466

65-
2. **Twilio の 元 イベントにアクセスする**
67+
2. **Twilio の 元 イベントにアクセスします**
6668

67-
Twilio から送られてくる 元 のイベントにアクセスしたい場合は、`RealtimeSession` インスタンス上の `transport_event` をリッスンします。Twilio からのすべてのイベントは `twilio_message` タイプになり、 元 のイベントデータを含む `message` プロパティを持ちます。
69+
Twilio から送信される 元 イベントにアクセスしたい場合は、`RealtimeSession` インスタンスの `transport_event`
70+
をリッスンします。Twilio からのすべてのイベントは `twilio_message` という type と、元イベントデータを含む `message` プロパティを持ちます。
6871

69-
3. **デバッグログを確認する**
72+
3. **デバッグログを確認します**
7073

71-
状況把握のために詳細な情報が必要になることがあります。環境変数 `DEBUG=openai-agents*` を使うと Agents SDK のすべてのデバッグログが表示されます。あるいは、Twilio アダプターだけのデバッグログを有効にするには `DEBUG=openai-agents:extensions:twilio*` を使用します。
74+
事象の詳細が必要になる場合があります。環境変数 `DEBUG=openai-agents*` を使うと Agents SDK のすべてのデバッグログが表示されます。
75+
もしくは、Twilio アダプターのデバッグログのみを有効化するには `DEBUG=openai-agents:extensions:twilio*` を使用します。
7276

73-
## フル機能のサンプルサーバー
77+
## フルサンプルサーバー
7478

75-
以下は、Twilio からのリクエストを受け取り、`RealtimeSession` に転送する WebSocket サーバーのエンドツーエンドのサンプルです。
79+
以下は、Twilio からのリクエストを受け取り、それを `RealtimeSession` に転送する WebSocket サーバーのエンドツーエンドのサンプルです。
7680

7781
<Code
7882
lang="typescript"
7983
code={twilioServerExample}
80-
title="Fastify を使ったサーバー例"
84+
title="Fastify を使用したサーバー例"
8185
/>

0 commit comments

Comments
 (0)