Skip to content

Commit 5119864

Browse files
Update all translated document pages (#338)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 72cef62 commit 5119864

24 files changed

+594
-601
lines changed

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

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,13 @@ 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-
このアダプターはまだ beta
11-
です。一部のモデルプロバイダー、特に小規模なものでは問題が発生する場合があります。問題は
12-
[GitHub issues](https://github.com/openai/openai-agents-js/issues)
13-
から報告してください。迅速に修正します
10+
このアダプターはまだベータ版です。特に小規模なモデル
11+
プロバイダーでは問題が発生する場合があります。問題があれば [GitHub
12+
Issues](https://github.com/openai/openai-agents-js/issues)
13+
から報告してください。迅速に 対応します
1414
</Aside>
1515

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

1818
## セットアップ
1919

@@ -25,13 +25,13 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
2525
npm install @openai/agents-extensions
2626
```
2727

28-
2. [Vercel の AI SDK](https://sdk.vercel.ai/docs/models/overview) から目的のモデルパッケージを選び、インストールします:
28+
2. [Vercel の AI SDK](https://sdk.vercel.ai/docs/models/overview) から目的のモデルパッケージを選んでインストールします:
2929

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

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

3636
```typescript
3737
import { openai } from '@ai-sdk/openai';
@@ -47,18 +47,22 @@ import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk
4747
</Steps>
4848

4949
<Aside type="caution">
50-
Vercel の AI SDK は最近 v2 に移行しましたが、 openai agent extensions はまだ
51-
v2 と互換性がありません。 そのため Vercel の AI SDK は v1
52-
バージョンをインストールする必要があります
50+
Vercel の AI SDK は最近 v2 に移行しましたが、openai agent extensions はまだ v2
51+
に対応していません。 そのため Vercel の AI SDK は v1
52+
をインストールする必要があります
5353
</Aside>
5454

5555
##
5656

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

59-
## プロバイダーのメタデータの受け渡し
63+
## プロバイダー メタデータの受け渡し
6064

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

6367
```ts
6468
providerData: {
@@ -70,7 +74,7 @@ providerData: {
7074
}
7175
```
7276

73-
AI SDK 連携を使用する場合は
77+
次のようになります
7478

7579
```ts
7680
providerMetadata: {
@@ -82,4 +86,4 @@ providerMetadata: {
8286
}
8387
```
8488

85-
になります。
89+
AI SDK 連携を使用する場合

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

Lines changed: 25 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7,37 +7,39 @@ 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 に接続するために利用できます。Twilio から届くイベントを Realtime Session に接続するには、`websocket` モードのデフォルトの Realtime Session トランスポートを使えます。ただし、Web ベースの会話よりも電話では自然とレイテンシが増えるため、適切な音声フォーマットの設定や、割り込みタイミングの調整が必要になります
10+
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 ベースの会話よりも通話では自然とレイテンシが大きくなるため、独自の割り込みタイミングの調整が必要になります
1111

12-
セットアップ体験を向上させるために、割り込み処理や音声転送を含め、Twilio への接続を代わりに処理する専用のトランスポートレイヤーを作成しました
12+
セットアップ体験を改善するために、割り込み処理や音声のフォワーディングも含め、Twilio への接続を処理する専用のトランスポートレイヤーを用意しました
1313

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

2021
## セットアップ
2122

2223
<Steps>
2324

24-
1. ** Twilio のアカウントと Twilio の電話番号を用意します **
25+
1. **Twilio アカウントと Twilio の電話番号を用意してください**
2526

26-
2. ** Twilio からのイベントを受け取れる WebSocket サーバーを用意します **
27+
2. **Twilio からのイベントを受け取れる WebSocket サーバーをセットアップします**
2728

28-
ローカルで開発している場合、これはローカルトンネルの設定が必要になり、
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 への接続には
32-
`TwilioRealtimeTransportLayer` を使えます。
31+
のようなローカルトンネルを設定する必要があり、これは [`ngrok`](https://ngrok.io/)
32+
[Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
33+
のようなローカルトンネルを設定する必要があります。これはローカル サーバーを Twilio からアクセス可能にするためです。Twilio への接続には `TwilioRealtimeTransportLayer`
34+
を使用できます。
3335

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

3638
```bash
3739
npm install @openai/agents-extensions
3840
```
3941

40-
4. ** `RealtimeSession` に接続するためのアダプターとモデルをインポートします **
42+
4. **アダプターとモデルをインポートして `RealtimeSession` に接続します:**
4143

4244
<Code
4345
lang="typescript"
@@ -47,38 +49,33 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
4749
)}
4850
/>
4951

50-
5. ** `RealtimeSession` を Twilio に接続します **
52+
5. **`RealtimeSession` を Twilio に接続します:**
5153

5254
```typescript
5355
session.connect({ apiKey: 'your-openai-api-key' });
5456
```
5557

5658
</Steps>
5759

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

6062
## ヒントと考慮事項
6163

62-
1. ** スピードが命です **
64+
1. **スピードが肝心です。**
6365

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

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

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

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

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

79-
## 完全なサーバー例
76+
## 完全なサーバーの例
8077

81-
以下は、Twilio からのリクエストを受け取り、`RealtimeSession` にフォワードするWebSocket サーバーの完全な end-to-end の例です
78+
以下は、Twilio からのリクエストを受け取り、それを `RealtimeSession` にフォワードする WebSocket サーバーのエンドツーエンドの完全な例です
8279

8380
<Code
8481
lang="typescript"

0 commit comments

Comments
 (0)