Skip to content

Update all translated document pages #384

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 26, 2025
Merged

Update all translated document pages #384

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 16 additions & 10 deletions docs/src/content/docs/ja/extensions/ai-sdk.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,37 +7,37 @@ import { Aside, Steps, Code } from '@astrojs/starlight/components';
import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk-setup.ts?raw';

<Aside type="caution">
このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題があれば
このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する場合があります。問題があれば
[GitHub issues](https://github.com/openai/openai-agents-js/issues)
から報告してください。迅速に修正します。
</Aside>

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

## セットアップ

<Steps>

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

```bash
npm install @openai/agents-extensions
```

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

```bash
npm install @ai-sdk/openai@"^1.0.0"
```

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

```typescript
import { openai } from '@ai-sdk/openai';
import { aisdk } from '@openai/agents-extensions';
```

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

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

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

## 例

<Code lang="typescript" code={aiSdkSetupExample} title="AI SDK セットアップ" />
<Code
lang="typescript"
code={aiSdkSetupExample}
title="AI SDK のセットアップ"
/>

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

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

```ts
providerData: {
Expand All @@ -69,7 +73,7 @@ providerData: {
}
```

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

```ts
providerMetadata: {
Expand All @@ -80,3 +84,5 @@ providerMetadata: {
}
}
```

AI SDK 連携を使用する場合
52 changes: 26 additions & 26 deletions docs/src/content/docs/ja/extensions/twilio.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,37 +7,37 @@ import { Aside, Steps, Code } from '@astrojs/starlight/components';
import twilioBasicExample from '../../../../../../examples/docs/extensions/twilio-basic.ts?raw';
import twilioServerExample from '../../../../../../examples/realtime-twilio/index.ts?raw';

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 ベースの会話より電話では遅延が大きくなりやすいため、割り込みのタイミングを調整する必要があります。
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 ベースの会話よりも通話は自然とレイテンシが大きくなるため、適切な音声フォーマットを設定し、割り込みタイミングを調整する必要があります。

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

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

## セットアップ

<Steps>

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

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

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

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

```bash
npm install @openai/agents-extensions
```

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

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

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

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

</Steps>

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

## ヒントと考慮事項

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

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

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

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

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

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

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

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

<Code
lang="typescript"
code={twilioServerExample}
title="Fastify を使ったサンプルサーバー"
title="Fastify を使用したサーバーのサンプル"
/>
Loading