Skip to content

Commit a94bf2d

Browse files
Update all translated document pages (#576)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 8db6f4d commit a94bf2d

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

75 files changed

+1767
-1773
lines changed

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

Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -9,28 +9,28 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
99
<Aside type="caution">
1010
このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題があれば
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
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
3131
```
3232

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

3535
```typescript
3636
import { openai } from '@ai-sdk/openai';
@@ -46,23 +46,19 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
4646
</Steps>
4747

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

5555
##
5656

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

6359
## プロバイダー メタデータの受け渡し
6460

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

6763
```ts
6864
providerData: {
@@ -74,7 +70,7 @@ providerData: {
7470
}
7571
```
7672

77-
は、AI SDK 連携を使用する場合には
73+
は、AI SDK 連携を使用すると
7874

7975
```ts
8076
providerMetadata: {
@@ -86,4 +82,4 @@ providerMetadata: {
8682
}
8783
```
8884

89-
のようになります
85+
になります

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

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,13 @@ description: Connect your Agents SDK agents from Cloudflare Workers/workerd usin
66
import { Aside, Steps, Code } from '@astrojs/starlight/components';
77
import cloudflareBasicExample from '../../../../../../examples/docs/extensions/cloudflare-basic.ts?raw';
88

9-
Cloudflare Workers とその他の workerd ランタイムでは、グローバルな `WebSocket` コンストラクターを使って外向きの WebSocket を開くことができません。これらの環境から リアルタイムエージェント に接続しやすくするために、extensions パッケージは `fetch()` ベースのアップグレードを内部で実行する専用のトランスポートを提供します。
9+
Cloudflare Workers とその他の workerd ランタイムは、グローバル `WebSocket` コンストラクタを使って外向き WebSocket を開くことができません。これらの環境から リアルタイムエージェント に簡単に接続できるようにするため、extensions パッケージは `fetch()` ベースのアップグレードを内部で実行する専用のトランスポートを提供します。
1010

1111
<Aside type="caution">
12-
このアダプターはまだベータ版です。稀なケースの問題やバグに遭遇する可能性があります。
13-
問題があれば [GitHub
14-
issues](https://github.com/openai/openai-agents-js/issues)
15-
に報告してください。迅速に対応します。Workers で Node.js 風 API
16-
を利用する場合は、`nodejs_compat` の有効化を検討してください。
12+
このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります。
13+
問題は [GitHub issues](https://github.com/openai/openai-agents-js/issues)
14+
から報告してください。迅速に修正します。Workers で Node.js 風の API
15+
を使いたい場合は `nodejs_compat` の有効化を検討してください。
1716
</Aside>
1817

1918
## セットアップ
@@ -26,20 +25,20 @@ Cloudflare Workers とその他の workerd ランタイムでは、グローバ
2625
npm install @openai/agents-extensions
2726
```
2827

29-
2. **トランスポートを作成し、セッションにアタッチします**
28+
2. **トランスポートを作成してセッションにアタッチします**
3029

3130
<Code lang="typescript" code={cloudflareBasicExample} />
3231

33-
3. **`RealtimeSession` に接続します**
32+
3. **`RealtimeSession` を接続します**
3433

3534
```typescript
3635
await session.connect({ apiKey: 'your-openai-ephemeral-or-server-key' });
3736
```
3837

3938
</Steps>
4039

41-
## 注意点
40+
## 注意事項
4241

43-
- Cloudflare トランスポートは内部的に `Upgrade: websocket` を伴う `fetch()` を使用し、ソケットの `open` イベントを待たずに処理を進めます。workerd API に合わせた挙動です
44-
- このトランスポート使用時も、`RealtimeSession` のすべての機能(ツール、ガードレール など)は通常どおり動作します
45-
- 開発中の詳細ログ確認には `DEBUG=openai-agents*` を使用します
42+
- Cloudflare トランスポートは内部的に `fetch()``Upgrade: websocket` を使用し、ソケットの `open` イベント待ちをスキップして workerd API に合わせます
43+
- このトランスポート使用時も、`RealtimeSession` のすべての機能(tools、ガードレール など)は通常どおり動作します
44+
- 開発時の詳細ログ確認には `DEBUG=openai-agents*` を使用します

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

Lines changed: 20 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -7,36 +7,36 @@ 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 に接続できます。デフォルトの 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 に接続できます。デフォルトの Realtime Session トランスポートを `websocket` モードで使い、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-
ローカル開発の場合[`ngrok`](https://ngrok.io/)
28+
ローカル開発の場合は[`ngrok`](https://ngrok.io/)
2929
[Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
30-
のようなローカルトンネルの設定が必要になり、ローカルサーバーを Twilio からアクセス可能にします`TwilioRealtimeTransportLayer`
30+
などのローカルトンネルを設定して、ローカル サーバーを Twilio からアクセス可能にする必要があります`TwilioRealtimeTransportLayer`
3131
を使って Twilio に接続できます。
3232

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

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

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

4141
<Code
4242
lang="typescript"
@@ -46,36 +46,33 @@ Twilio は、電話の通話音声の元オーディオを WebSocket サーバ
4646
)}
4747
/>
4848

49-
5. **`RealtimeSession` を Twilio に接続します:**
49+
5. **`RealtimeSession` を Twilio に接続する**
5050

5151
```typescript
5252
session.connect({ apiKey: 'your-openai-api-key' });
5353
```
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 接続の参照を得たらすぐに
64-
`TwilioRealtimeTransportLayer` インスタンスを作成し、直後に `session.connect()` を呼び出してください。
63+
Twilio から必要なイベントとオーディオをすべて受け取るため、WebSocket 接続の参照を取得したらすぐに `TwilioRealtimeTransportLayer` インスタンスを作成し、その直後に `session.connect()` を呼び出してください。
6564

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

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

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

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

76-
## サーバーのフル例
73+
## フルサーバー例
7774

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

8077
<Code
8178
lang="typescript"

0 commit comments

Comments
 (0)