Skip to content

Commit 2f2f6c6

Browse files
github-actions[bot]github-actions[bot]
authored
Update all translated document pages (#384)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 9182e35 commit 2f2f6c6

24 files changed

+593
-581
lines changed

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

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,37 +7,37 @@ 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)
1212
から報告してください。迅速に修正します。
1313
</Aside>
1414

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

1717
## セットアップ
1818

1919
<Steps>
2020

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

2323
```bash
2424
npm install @openai/agents-extensions
2525
```
2626

27-
2. [Vercel's AI SDK](https://sdk.vercel.ai/docs/models/overview) の一覧から目的のモデルパッケージを選び、インストールします:
27+
2. [Vercel's AI SDK](https://sdk.vercel.ai/docs/models/overview) から使用したいモデルパッケージを選び、インストールします:
2828

2929
```bash
3030
npm install @ai-sdk/openai@"^1.0.0"
3131
```
3232

33-
3. アダプターとモデルをインポートしてエージェントに接続します:
33+
3. アダプターとモデルをインポートし、エージェントに接続します:
3434

3535
```typescript
3636
import { openai } from '@ai-sdk/openai';
3737
import { aisdk } from '@openai/agents-extensions';
3838
```
3939

40-
4. エージェントが使用するモデルのインスタンスを初期化します:
40+
4. エージェントで使用するモデルのインスタンスを初期化します:
4141

4242
```typescript
4343
const model = aisdk(openai('o4-mini'));
@@ -47,17 +47,21 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
4747

4848
<Aside type="caution">
4949
Vercel's AI SDK は最近 v2 に移行しましたが、openai agent extensions はまだ v2
50-
と互換性がありません。 そのため Vercel's AI SDK は v1
50+
と互換性がありません。 したがって、Vercel's AI SDK の v1
5151
をインストールする必要があります。
5252
</Aside>
5353

5454
## 例
5555

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

5862
## プロバイダーのメタデータの受け渡し
5963

60-
メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を通して渡します。値は基盤の AI SDK モデルにそのままフォワードされます。たとえば Agents SDK で以下の `providerData`
64+
メッセージにプロバイダー固有のオプションを含める必要がある場合は、`providerMetadata` を通して渡します。値は基盤の AI SDK モデルにそのまま転送されます。たとえば、Agents SDK で次の `providerData` は
6165

6266
```ts
6367
providerData: {
@@ -69,7 +73,7 @@ providerData: {
6973
}
7074
```
7175

72-
は、AI SDK 連携を使用する場合、次のようになります
76+
次のようになります
7377

7478
```ts
7579
providerMetadata: {
@@ -80,3 +84,5 @@ providerMetadata: {
8084
}
8185
}
8286
```
87+
88+
AI SDK 連携を使用する場合

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

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -7,37 +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 は [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 ベースの会話より電話では遅延が大きくなりやすいため、割り込みのタイミングを調整する必要があります。
10+
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 ベースの会話よりも通話は自然とレイテンシが大きくなるため、適切な音声フォーマットを設定し、割り込みタイミングを調整する必要があります。
1111

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

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

2020
## セットアップ
2121

2222
<Steps>
2323

24-
1. **Twilio アカウントと Twilio の電話番号を用意していることを確認してください。**
24+
1. ** Twilio アカウントと Twilio の電話番号を用意してください。**
2525

26-
2. **Twilio からのイベントを受信できる WebSocket サーバーをセットアップします。**
26+
2. ** Twilio からのイベントを受け取れる WebSocket サーバーを設定してください。**
2727

28-
ローカルで開発している場合、Twilio からローカルのサーバーにアクセスできるようにするため、
29-
[`ngrok`](https://ngrok.io/) や
28+
ローカルで開発している場合、これは [`ngrok`](https://ngrok.io/) や
3029
[Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
31-
のようなローカルトンネルの設定が必要になります。このためにはローカルトンネルの設定が必要になります。`TwilioRealtimeTransportLayer`
32-
を使って Twilio に接続できます。
30+
のようなローカルトンネルを構成する必要があり、これはローカルトンネル（[`ngrok`](https://ngrok.io/) や
31+
[Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/) など）を構成する必要があることを意味します。これによりローカルの サーバー を Twilio からアクセス可能にします。`TwilioRealtimeTransportLayer`
32+
を使用して Twilio に接続できます。
3333

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

3636
```bash
3737
npm install @openai/agents-extensions
3838
```
3939

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

4242
<Code
4343
lang="typescript"
@@ -47,41 +47,41 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
4747
)}
4848
/>
4949

50-
5. **あなたの `RealtimeSession` を Twilio に接続します:**
50+
5. ** `RealtimeSession` を Twilio に接続します:**
5151

5252
```typescript
5353
session.connect({ apiKey: 'your-openai-api-key' });
5454
```
5555

5656
</Steps>
5757

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

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

62-
1. **速度が最重要です。**
62+
1. ** スピードが命です。**
6363

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

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

6969
Twilio から送信される 元 のイベントにアクセスしたい場合は、`RealtimeSession` インスタンスで
70-
`transport_event` イベントをリッスンします。Twilio からのすべてのイベントは type が
71-
`twilio_message` で、 元 のイベントデータを含む `message` プロパティを持ちます。
70+
`transport_event` イベントをリッスンできます。Twilio からのすべてのイベントには、型が
71+
`twilio_message`、元のイベントデータを含む `message` プロパティがあります。
7272

73-
3. **デバッグログを確認します。**
73+
3. ** デバッグログを確認する。**
7474

75-
状況をより詳しく知りたい問題に遭遇することがあります。環境変数 `DEBUG=openai-agents*` を使用すると、
76-
Agents SDK からのすべてのデバッグログが表示されます。もしくは、
77-
`DEBUG=openai-agents:extensions:twilio*` を使って Twilio アダプターのデバッグログだけを有効にできます。
75+
状況を詳しく知りたい問題に遭遇することがあります。`DEBUG=openai-agents*` 環境変数を使うと、
76+
Agents SDK からのすべてのデバッグログが表示されます。あるいは、`DEBUG=openai-agents:extensions:twilio*`
77+
を使って Twilio アダプターのデバッグログだけを有効にできます。
7878

7979
## 完全なサンプルサーバー
8080

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

8383
<Code
8484
lang="typescript"
8585
code={twilioServerExample}
86-
title="Fastify を使ったサンプルサーバー"
86+
title="Fastify を使用したサーバーのサンプル"
8787
/>

0 commit comments

Comments
 (0)