Skip to content

Commit bddda90

Browse files
github-actions[bot]github-actions[bot]
authored
Update all translated document pages (#448)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 469cefa commit bddda90

24 files changed

+560
-563
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,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-
このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題が発生した場合は
11-
[GitHub issues](https://github.com/openai/openai-agents-js/issues)
12-
からご報告ください。迅速に修正します。
10+
このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題があれば
11+
[GitHub issues](https://github.com/openai/openai-agents-js/ja/issues)
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. extensions パッケージをインストールして AI SDK アダプターを導入します:
21+
1. 拡張パッケージをインストールして 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';
3737
import { aisdk } from '@openai/agents-extensions';
3838
```
3939

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

4242
```typescript
4343
const model = aisdk(openai('o4-mini'));
@@ -46,19 +46,23 @@ 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
51-
を使い続けたい場合は、[examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/tree/main/examples/ai-sdk-v1)
49+
現在、ai-sdk のモデルプロバイダー v2 モジュール（Vercel AI SDK v5
50+
と互換）に対応しています。特別な理由で v1
51+
のモデルプロバイダーを使い続ける必要がある場合は、[examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/ja/tree/main/examples/ai-sdk-v1)
5252
からモジュールをコピーして、プロジェクトに含めてください。
5353
</Aside>
5454

5555
## 例
5656

57-
<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK Setup" />
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+
は、AI SDK 連携を使用する場合は次のようになります
7478

7579
```ts
7680
providerMetadata: {

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

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,14 @@ 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 は、通話の 元 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 フォーマットの設定と、独自の割り込みタイミングの調整が必要です。
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 への接続、割り込み処理、audio 転送を含めて処理する専用のトランスポートレイヤーを用意しました。
12+
セットアップ体験を改善するため、Twilio への接続、割り込み処理、音声のフォワーディングまで対応する専用のトランスポートレイヤーを用意しました。
1313

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

2120
## セットアップ
@@ -24,11 +23,12 @@ Twilio は、通話の 元 audio を WebSocket サーバーへ送信する [Medi
2423

2524
1. **Twilio アカウントと Twilio の電話番号を用意します。**
2625

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

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

3434
3. **extensions パッケージをインストールして Twilio アダプターを導入します:**
@@ -37,7 +37,7 @@ Twilio は、通話の 元 audio を WebSocket サーバーへ送信する [Medi
3737
npm install @openai/agents-extensions
3838
```
3939

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

4242
<Code
4343
lang="typescript"
@@ -55,31 +55,33 @@ Twilio は、通話の 元 audio を WebSocket サーバーへ送信する [Medi
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

6262
1. **スピードが最重要です。**
6363

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

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

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

7273
3. **デバッグログを確認します。**
7374

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

7779
## フルサンプルサーバー
7880

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

8183
<Code
8284
lang="typescript"
8385
code={twilioServerExample}
84-
title="Fastify を使用したサーバー例"
86+
title="Fastify を使ったサンプルサーバー"
8587
/>

0 commit comments

Comments
 (0)