diff --git a/docs/ja/realtime/quickstart.md b/docs/ja/realtime/quickstart.md index 773f7bbdd1..61521376a0 100644 --- a/docs/ja/realtime/quickstart.md +++ b/docs/ja/realtime/quickstart.md @@ -4,14 +4,14 @@ search: --- # クイックスタート -Realtime エージェントを使用すると、OpenAI の Realtime API を使って AI エージェントと音声会話ができます。このガイドでは、最初の realtime 音声エージェントを作成する手順を説明します。 +Realtime エージェントを使うと、OpenAI の Realtime API を使用して AI エージェントと音声会話できます。このガイドでは、最初の realtime 音声エージェントを作成する手順を説明します。 !!! warning "ベータ機能" -Realtime エージェントはベータ版です。実装を改善する過程で、破壊的変更が入る可能性があります。 +Realtime エージェントはベータ版です。実装の改善に伴い、破壊的変更が発生する可能性があります。 ## 前提条件 -- Python 3.9 以上 +- Python 3.10 以上 - OpenAI API キー - OpenAI Agents SDK の基本的な理解 @@ -41,7 +41,7 @@ agent = RealtimeAgent( ) ``` -### 3. Runner の設定 +### 3. ランナーの設定 ```python runner = RealtimeRunner( @@ -204,14 +204,14 @@ if __name__ == "__main__": ### ターン検出 -- `type`: 検出方式(`server_vad`、`semantic_vad`) -- `threshold`: 音声活動のしきい値(0.0-1.0) +- `type`: 検出方法(`server_vad`、`semantic_vad`) +- `threshold`: 音声アクティビティのしきい値(0.0-1.0) - `silence_duration_ms`: ターン終了を検出する無音時間 - `prefix_padding_ms`: 発話前の音声パディング ## 次のステップ -- [realtime エージェントの詳細](guide.md) +- [Realtime エージェントについて詳しく見る](guide.md) - [examples/realtime](https://github.com/openai/openai-agents-python/tree/main/examples/realtime) フォルダーの動作する例を確認する - エージェントにツールを追加する - エージェント間のハンドオフを実装する @@ -225,7 +225,7 @@ if __name__ == "__main__": export OPENAI_API_KEY="your-api-key-here" ``` -または、セッション作成時に直接渡します。 +または、セッション作成時に直接渡してください。 ```python session = await runner.run(model_config={"api_key": "your-api-key"}) @@ -233,7 +233,7 @@ session = await runner.run(model_config={"api_key": "your-api-key"}) ## Azure OpenAI エンドポイント形式 -OpenAI のデフォルトエンドポイントではなく Azure OpenAI に接続する場合は、`model_config["url"]` に GA Realtime URL を渡し、認証ヘッダーを明示的に設定してください。 +OpenAI のデフォルトのエンドポイントではなく Azure OpenAI に接続する場合は、`model_config["url"]` に GA Realtime URL を渡し、認証ヘッダーを明示的に設定してください。 ```python session = await runner.run( @@ -244,7 +244,7 @@ session = await runner.run( ) ``` -ベアラートークンも使用できます。 +Bearer トークンも使用できます。 ```python session = await runner.run( @@ -255,4 +255,4 @@ session = await runner.run( ) ``` -realtime エージェントでは、レガシーなベータパス(`/openai/realtime?api-version=...`)の使用は避けてください。SDK は GA Realtime インターフェースを想定しています。 \ No newline at end of file +Realtime エージェントでは、レガシーのベータ版パス(`/openai/realtime?api-version=...`)の使用は避けてください。SDK は GA Realtime インターフェースを想定しています。 \ No newline at end of file diff --git a/docs/ko/realtime/quickstart.md b/docs/ko/realtime/quickstart.md index ed0497a5e6..58b619c27e 100644 --- a/docs/ko/realtime/quickstart.md +++ b/docs/ko/realtime/quickstart.md @@ -4,14 +4,14 @@ search: --- # 빠른 시작 -실시간 에이전트를 사용하면 OpenAI의 Realtime API로 AI 에이전트와 음성 대화를 할 수 있습니다. 이 가이드에서는 첫 번째 실시간 음성 에이전트를 만드는 과정을 안내합니다. +실시간 에이전트를 사용하면 OpenAI의 Realtime API로 AI 에이전트와 음성 대화를 할 수 있습니다. 이 가이드는 첫 실시간 음성 에이전트를 만드는 과정을 안내합니다. !!! warning "베타 기능" -실시간 에이전트는 베타 버전입니다. 구현을 개선하는 과정에서 일부 호환성이 깨지는 변경이 있을 수 있습니다. +실시간 에이전트는 베타입니다. 구현을 개선하는 과정에서 일부 파괴적 변경이 있을 수 있습니다. ## 사전 준비 사항 -- Python 3.9 이상 +- Python 3.10 이상 - OpenAI API 키 - OpenAI Agents SDK에 대한 기본적인 이해 @@ -32,7 +32,7 @@ import asyncio from agents.realtime import RealtimeAgent, RealtimeRunner ``` -### 2. 실시간 에이전트 생성하기 +### 2. 실시간 에이전트 만들기 ```python agent = RealtimeAgent( @@ -111,7 +111,7 @@ def _truncate_str(s: str, max_length: int) -> str: ## 전체 예제 -다음은 완전하게 동작하는 전체 예제입니다: +다음은 완전히 동작하는 전체 예제입니다: ```python import asyncio @@ -192,9 +192,9 @@ if __name__ == "__main__": ### 모델 설정 -- `model_name`: 사용 가능한 실시간 모델에서 선택하세요(예: `gpt-realtime`) -- `voice`: 음성 선택(`alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`) -- `modalities`: 텍스트 또는 오디오 활성화(`["text"]` 또는 `["audio"]`) +- `model_name`: 사용 가능한 실시간 모델에서 선택합니다(예: `gpt-realtime`) +- `voice`: 음성을 선택합니다(`alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`) +- `modalities`: 텍스트 또는 오디오를 활성화합니다(`["text"]` 또는 `["audio"]`) ### 오디오 설정 @@ -205,27 +205,27 @@ if __name__ == "__main__": ### 턴 감지 - `type`: 감지 방식(`server_vad`, `semantic_vad`) -- `threshold`: 음성 활동 임곗값(0.0-1.0) +- `threshold`: 음성 활동 임계값(0.0-1.0) - `silence_duration_ms`: 턴 종료를 감지하기 위한 무음 지속 시간 -- `prefix_padding_ms`: 발화 이전 오디오 패딩 +- `prefix_padding_ms`: 발화 전 오디오 패딩 ## 다음 단계 -- [실시간 에이전트 더 알아보기](guide.md) -- [examples/realtime](https://github.com/openai/openai-agents-python/tree/main/examples/realtime) 폴더의 동작 예제를 확인하세요 +- [실시간 에이전트에 대해 더 알아보기](guide.md) +- [examples/realtime](https://github.com/openai/openai-agents-python/tree/main/examples/realtime) 폴더의 동작하는 예제를 확인하세요 - 에이전트에 도구 추가하기 - 에이전트 간 핸드오프 구현하기 - 안전을 위한 가드레일 설정하기 ## 인증 -환경 변수에 OpenAI API 키가 설정되어 있는지 확인하세요: +환경에 OpenAI API 키가 설정되어 있는지 확인하세요: ```bash export OPENAI_API_KEY="your-api-key-here" ``` -또는 세션을 생성할 때 직접 전달할 수도 있습니다: +또는 세션을 만들 때 직접 전달할 수도 있습니다: ```python session = await runner.run(model_config={"api_key": "your-api-key"}) @@ -233,7 +233,7 @@ session = await runner.run(model_config={"api_key": "your-api-key"}) ## Azure OpenAI 엔드포인트 형식 -OpenAI 기본 엔드포인트 대신 Azure OpenAI에 연결하는 경우, +OpenAI의 기본 엔드포인트 대신 Azure OpenAI에 연결하는 경우, `model_config["url"]`에 GA Realtime URL을 전달하고 인증 헤더를 명시적으로 설정하세요. ```python @@ -245,7 +245,7 @@ session = await runner.run( ) ``` -Bearer 토큰도 사용할 수 있습니다: +베어러 토큰을 사용할 수도 있습니다: ```python session = await runner.run( @@ -256,4 +256,4 @@ session = await runner.run( ) ``` -실시간 에이전트와 함께 레거시 베타 경로(`/openai/realtime?api-version=...`)를 사용하는 것은 피하세요. SDK는 GA Realtime 인터페이스를 기대합니다. \ No newline at end of file +실시간 에이전트에서는 레거시 베타 경로(`/openai/realtime?api-version=...`) 사용을 피하세요. SDK는 GA Realtime 인터페이스를 기대합니다. \ No newline at end of file diff --git a/docs/zh/realtime/quickstart.md b/docs/zh/realtime/quickstart.md index 344768bf82..35b3895083 100644 --- a/docs/zh/realtime/quickstart.md +++ b/docs/zh/realtime/quickstart.md @@ -4,14 +4,14 @@ search: --- # 快速入门 -Realtime 智能体支持使用 OpenAI 的 Realtime API 与你的 AI 智能体进行语音对话。本指南将带你创建第一个 realtime 语音智能体。 +Realtime 智能体使你能够使用 OpenAI 的 Realtime API 与你的 AI 智能体进行语音对话。本指南将带你创建第一个实时语音智能体。 !!! warning "Beta 功能" -Realtime 智能体目前处于 beta 阶段。随着我们改进实现,可能会出现一些破坏性变更。 +Realtime 智能体处于 beta 阶段。随着我们改进实现,预计会有一些破坏性变更。 ## 前置条件 -- Python 3.9 或更高版本 +- Python 3.10 或更高版本 - OpenAI API key - 对 OpenAI Agents SDK 的基本了解 @@ -23,7 +23,7 @@ Realtime 智能体目前处于 beta 阶段。随着我们改进实现,可能 pip install openai-agents ``` -## 创建你的第一个 realtime 智能体 +## 创建你的第一个实时智能体 ### 1. 导入所需组件 @@ -32,7 +32,7 @@ import asyncio from agents.realtime import RealtimeAgent, RealtimeRunner ``` -### 2. 创建一个 realtime 智能体 +### 2. 创建一个实时智能体 ```python agent = RealtimeAgent( @@ -192,14 +192,14 @@ if __name__ == "__main__": ### 模型设置 -- `model_name`: 从可用的 realtime 模型中选择(例如 `gpt-realtime`) +- `model_name`: 从可用的 realtime 模型中选择(例如:`gpt-realtime`) - `voice`: 选择声音(`alloy`、`echo`、`fable`、`onyx`、`nova`、`shimmer`) - `modalities`: 启用文本或音频(`["text"]` 或 `["audio"]`) ### 音频设置 -- `input_audio_format`: 输入音频的格式(`pcm16`、`g711_ulaw`、`g711_alaw`) -- `output_audio_format`: 输出音频的格式 +- `input_audio_format`: 输入音频格式(`pcm16`、`g711_ulaw`、`g711_alaw`) +- `output_audio_format`: 输出音频格式 - `input_audio_transcription`: 转写配置 ### 轮次检测 @@ -213,9 +213,9 @@ if __name__ == "__main__": - [了解更多 realtime 智能体](guide.md) - 查看 [examples/realtime](https://github.com/openai/openai-agents-python/tree/main/examples/realtime) 文件夹中的可运行示例 -- 为你的智能体添加工具调用 -- 实现智能体之间的任务转移 -- 为安全设置安全防护措施 +- 为你的智能体添加 tools +- 在智能体之间实现 handoffs +- 设置 guardrails 以确保安全 ## 身份验证 @@ -233,8 +233,8 @@ session = await runner.run(model_config={"api_key": "your-api-key"}) ## Azure OpenAI 端点格式 -如果你连接的是 Azure OpenAI 而不是 OpenAI 的默认端点,请在 -`model_config["url"]` 中传入 GA Realtime URL,并显式设置认证 headers。 +如果你连接的是 Azure OpenAI,而不是 OpenAI 的默认端点,请在 +`model_config["url"]` 中传入 GA Realtime URL,并显式设置 auth headers。 ```python session = await runner.run( @@ -256,4 +256,5 @@ session = await runner.run( ) ``` -避免在 realtime 智能体中使用旧版 beta 路径(`/openai/realtime?api-version=...`)。SDK 期望使用 GA Realtime 接口。 \ No newline at end of file +避免在 realtime 智能体中使用旧版 beta 路径(`/openai/realtime?api-version=...`)。该 +SDK 期望使用 GA Realtime 接口。 \ No newline at end of file