Skip to content

Commit 32f2381

Browse files
Update all translated document pages (#409)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 64d6386 commit 32f2381

24 files changed

+537
-534
lines changed

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

Lines changed: 13 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
88

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

15-
Agents SDK は標準で OpenAI のモデルを Responses API または Chat Completions API 経由で利用できます。ですが、他のモデルを使いたい場合は、このアダプターを通じて [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

@@ -24,7 +24,7 @@ Agents SDK は標準で OpenAI のモデルを Responses API または Chat Comp
2424
npm install @openai/agents-extensions
2525
```
2626

27-
2. [Vercel の AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) から目的のモデル用パッケージを選び、インストールします:
27+
2. [Vercel の AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) から目的のモデルパッケージを選び、インストールします:
2828

2929
```bash
3030
npm install @ai-sdk/openai
@@ -46,23 +46,20 @@ Agents SDK は標準で OpenAI のモデルを Responses API または Chat Comp
4646
</Steps>
4747

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

55-
## サンプル
56+
##
5657

57-
<Code
58-
lang="typescript"
59-
code={aiSdkSetupExample}
60-
title="AI SDK のセットアップ"
61-
/>
58+
<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK Setup" />
6259

6360
## プロバイダー メタデータの受け渡し
6461

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

6764
```ts
6865
providerData: {
@@ -74,7 +71,7 @@ providerData: {
7471
}
7572
```
7673

77-
AI SDK 連携を使う場合、次のようになります
74+
は、AI SDK 連携を使用すると次のようになります
7875

7976
```ts
8077
providerMetadata: {

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

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,13 @@ 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 は、電話の通話音声の 元 オーディオを 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 ベースの会話よりも通話のほうが遅延が大きくなりがちであることを踏まえた割り込みタイミングの調整が必要です
1111

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

1414
<Aside type="caution">
15-
このアダプターはまだベータ版です。レアケースの問題やバグが発生する可能性があります
16-
何か問題があれば [GitHub
15+
このアダプターはまだベータ版です。まれにエッジケースの問題やバグに遭遇する可能性があります
16+
問題があれば [GitHub
1717
issues](https://github.com/openai/openai-agents-js/issues)
1818
に報告してください。迅速に対応します。
1919
</Aside>
@@ -22,15 +22,15 @@ Twilio は、電話通話の元音声を WebSocket サーバーへ送信する [
2222

2323
<Steps>
2424

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

27-
2. **Twilio からのイベントを受信できる WebSocket サーバーをセットアップします。**
27+
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 からアクセス可能にする必要があります。Twilio への接続には `TwilioRealtimeTransportLayer` を使用できます。
3232

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

3535
```bash
3636
npm install @openai/agents-extensions
@@ -54,28 +54,28 @@ Twilio は、電話通話の元音声を WebSocket サーバーへ送信する [
5454

5555
</Steps>
5656

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

5959
## ヒントと考慮事項
6060

61-
1. **速度が最重要です**
61+
1. **スピードが重要です**
6262

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

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

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

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

71-
状況を詳しく知りたい問題に遭遇することがあります。環境変数 `DEBUG=openai-agents*` を使うと Agents SDK のすべてのデバッグログが表示されます。あるいは、`DEBUG=openai-agents:extensions:twilio*` を使って Twilio アダプターのデバッグログだけを有効にできます
71+
状況把握のために詳細な情報が必要になることがあります。環境変数 `DEBUG=openai-agents*` を使うと Agents SDK のすべてのデバッグログが表示されます。あるいは、Twilio アダプターだけのデバッグログを有効にするには `DEBUG=openai-agents:extensions:twilio*` を使用します
7272

73-
## 完全なサーバー例
73+
## フル機能のサンプルサーバー
7474

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

7777
<Code
7878
lang="typescript"
7979
code={twilioServerExample}
80-
title="Fastify を使用したサーバー例"
80+
title="Fastify を使ったサーバー例"
8181
/>

0 commit comments

Comments
 (0)