Skip to content

Commit 1e6e79c

Browse files
github-actions[bot]github-actions[bot]
authored
Update all translated document pages (#392)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 79a1999 commit 1e6e79c

24 files changed

+593
-597
lines changed

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

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

15-
Agents SDK は標準で Responses API または Chat Completions API を通じて OpenAI モデルと連携します。別のモデルを使用したい場合は、[Vercel's 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 に取り込むことができます。
1617

1718
## セットアップ
1819

1920
<Steps>
2021

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

2324
```bash
2425
npm install @openai/agents-extensions
2526
```
2627

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

2930
```bash
3031
npm install @ai-sdk/openai@"^1.0.0"
3132
```
3233

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

3536
```typescript
3637
import { openai } from '@ai-sdk/openai';
@@ -46,22 +47,18 @@ Agents SDK は標準で Responses API または Chat Completions API を通じ
4647
</Steps>
4748

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

5455
## 例
5556

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

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

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

6663
```ts
6764
providerData: {
@@ -73,7 +70,7 @@ providerData: {
7370
}
7471
```
7572

76-
次のようになります
73+
は、AI SDK 連携を使用すると
7774

7875
```ts
7976
providerMetadata: {
@@ -85,4 +82,4 @@ providerMetadata: {
8582
}
8683
```
8784

88-
AI SDK 連携を使用する場合
85+
のようになります。

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

Lines changed: 30 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -7,37 +7,38 @@ 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 に接続するために使用できます。`websocket` モードのデフォルトの Realtime Session トランスポートを使って、Twilio から届くイベントを 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 に接続するために使用できます。`websocket` モードの既定の Realtime Session トランスポートを使用して、Twilio から来るイベントを 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-
ローカルで開発している場合、これは [`ngrok`](https://ngrok.io/) や
29+
ローカルで開発している場合、this will require you to configure a local tunnel like
30+
this will require you to configure a local tunnel like [`ngrok`](https://ngrok.io/) または
2931
[Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/)
30-
のようなローカルトンネルを構成する必要があり、これはローカルトンネル（[`ngrok`](https://ngrok.io/) や
31-
[Cloudflare Tunnel](https://developers.cloudflare.com/pages/how-to/preview-with-cloudflare-tunnel/) など）を構成する必要があることを意味します。これによりローカルの サーバー を Twilio からアクセス可能にします。`TwilioRealtimeTransportLayer`
32-
を使用して Twilio に接続できます。
32+
のようなローカルトンネルを設定して、ローカルのサーバーを Twilio からアクセスできるようにする必要があります。Twilio への接続には `TwilioRealtimeTransportLayer`
33+
を使用できます。
3334

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

3637
```bash
3738
npm install @openai/agents-extensions
3839
```
3940

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

4243
<Code
4344
lang="typescript"
@@ -47,41 +48,41 @@ Twilio は、電話の通話からの 元 の音声を WebSocket サーバーに
4748
)}
4849
/>
4950

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

5253
```typescript
5354
session.connect({ apiKey: 'your-openai-api-key' });
5455
```
5556

5657
</Steps>
5758

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

6061
## ヒントと考慮事項
6162

62-
1. ** スピードが命です。**
63+
1. **スピードが命です。**
6364

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

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

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

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

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

79-
## 完全なサンプルサーバー
80+
## 完全なサーバー例
8081

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

8384
<Code
8485
lang="typescript"
8586
code={twilioServerExample}
86-
title="Fastify を使用したサーバーのサンプル"
87+
title="Fastify を使用したサーバーの例"
8788
/>

0 commit comments

Comments
 (0)