Skip to content

Commit a727b1f

Browse files
docs: update translated document pages (#2730)
Co-authored-by: Kazuhiro Sera <seratch@openai.com>
1 parent bb817aa commit a727b1f

3 files changed

Lines changed: 76 additions & 46 deletions

File tree

docs/ja/streaming.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,19 @@ search:
44
---
55
# ストリーミング
66

7-
ストリーミングを使用すると、エージェント実行の進行に合わせた更新を購読できます。これは、エンドユーザーに進捗更新や部分的な応答を表示するのに役立ちます。
7+
ストリーミングを使うと、エージェントの実行が進行する間の更新を購読できます。これは、エンドユーザーに進捗更新や部分的な応答を表示するのに役立ちます。
88

9-
ストリーミングするには、[`Runner.run_streamed()`][agents.run.Runner.run_streamed] を呼び出します。これにより [`RunResultStreaming`][agents.result.RunResultStreaming] が返されます`result.stream_events()` を呼び出すと、以下で説明する [`StreamEvent`][agents.stream_events.StreamEvent] オブジェクトの async ストリームが得られます
9+
ストリーミングするには、[`Runner.run_streamed()`][agents.run.Runner.run_streamed] を呼び出します。これにより [`RunResultStreaming`][agents.result.RunResultStreaming] が得られます`result.stream_events()` を呼び出すと、以下で説明する [`StreamEvent`][agents.stream_events.StreamEvent] オブジェクトの非同期ストリームが得られます
1010

11-
async イテレーターが終了するまで、`result.stream_events()` の消費を続けてください。ストリーミング実行は、イテレーターが終了するまで完了しません。セッション永続化、承認記録、履歴圧縮などの後処理は、最後の可視トークン到着後に完了する場合があります。ループ終了時に`result.is_complete` は最終的な実行状態を反映します
11+
非同期イテレーターが終了するまで `result.stream_events()` の消費を続けてください。ストリーミング実行は、イテレーターが終了するまで完了しません。また、セッション永続化、承認の記録管理、履歴の圧縮といった後処理は、最後の可視トークン到着後に完了する場合があります。ループを抜けた時点で`result.is_complete` が最終的な実行状態を反映します
1212

13-
## raw 応答イベント
13+
## raw response イベント
1414

15-
[`RawResponsesStreamEvent`][agents.stream_events.RawResponsesStreamEvent] は、LLM から直接渡される raw イベントです。これらは OpenAI Responses API 形式であり、各イベントは type`response.created``response.output_text.delta` など)と data を持ちます。これらのイベントは、応答メッセージを生成され次第すぐにユーザーへストリーミングしたい場合に有用です
15+
[`RawResponsesStreamEvent`][agents.stream_events.RawResponsesStreamEvent] は、LLM から直接渡される raw イベントです。これらは OpenAI Responses API 形式であり、各イベントはタイプ`response.created``response.output_text.delta` など)とデータを持ちます。これらのイベントは、生成され次第すぐにレスポンスメッセージをユーザーへストリーミングしたい場合に有用です
1616

17-
コンピュータツールの raw イベントは、保存された結果と同じく preview と GA の区別を維持します。Preview フローは 1 つの `action` を持つ `computer_call` 項目をストリーミングしますが`gpt-5.4` はバッチ化された `actions[]` を持つ `computer_call` 項目をストリーミングできます。より高レベルな [`RunItemStreamEvent`][agents.stream_events.RunItemStreamEvent] の表層では、これに対してコンピュータ専用の特別なイベント名は追加されません。どちらの形も引き続き `tool_called` として表れ、スクリーンショット結果は `computer_call_output` 項目をラップした `tool_output` として返されます。
17+
コンピュータツールの raw イベントは、保存済み結果と同じく preview と GA の区別を維持します。Preview フローでは 1 つの `action` を含む `computer_call` アイテムをストリーミングし`gpt-5.4` ではバッチ化された `actions[]` を含む `computer_call` アイテムをストリーミングできます。より高レベルの [`RunItemStreamEvent`][agents.stream_events.RunItemStreamEvent] サーフェスでは、このためのコンピュータ専用イベント名は追加されません。どちらの形も引き続き `tool_called` として表出し、スクリーンショット結果は `computer_call_output` アイテムをラップした `tool_output` として返されます。
1818

19-
たとえば、以下は LLM が生成したテキストをトークン単位で出力します
19+
たとえば、これは LLM が生成するテキストをトークン単位で出力します
2020

2121
```python
2222
import asyncio
@@ -41,7 +41,7 @@ if __name__ == "__main__":
4141

4242
## ストリーミングと承認
4343

44-
ストリーミングは、ツール承認のために一時停止する実行と互換性があります。ツールが承認を必要とする場合`result.stream_events()` は終了し、保留中の承認は [`RunResultStreaming.interruptions`][agents.result.RunResultStreaming.interruptions] に公開されます。結果を `result.to_state()` [`RunState`][agents.run_state.RunState] に変換し、割り込みを承認または拒否してから、`Runner.run_streamed(...)` で再開してください
44+
ストリーミングは、ツール承認のために一時停止する実行とも互換性があります。ツールに承認が必要な場合`result.stream_events()` は終了し、保留中の承認は [`RunResultStreaming.interruptions`][agents.result.RunResultStreaming.interruptions] に公開されます。`result.to_state()` で結果を [`RunState`][agents.run_state.RunState] に変換し、割り込みを承認または拒否してから、`Runner.run_streamed(...)` で再開します
4545

4646
```python
4747
result = Runner.run_streamed(agent, "Delete temporary files if they are no longer needed.")
@@ -57,15 +57,25 @@ if result.interruptions:
5757
pass
5858
```
5959

60-
一時停止 / 再開の完全な手順については、[human-in-the-loop ガイド](human_in_the_loop.md) を参照してください。
60+
一時停止 / 再開の完全な手順は、[human-in-the-loop ガイド](human_in_the_loop.md) を参照してください。
61+
62+
## 現在のターン後のストリーミングキャンセル
63+
64+
ストリーミング実行を途中で停止する必要がある場合は、[`result.cancel()`][agents.result.RunResultStreaming.cancel] を呼び出します。デフォルトでは、これにより実行は即時停止します。停止前に現在のターンをきれいに完了させるには、代わりに `result.cancel(mode="after_turn")` を呼び出してください。
65+
66+
ストリーミング実行は、`result.stream_events()` が終了するまで完了しません。SDK は、最後の可視トークンの後でも、セッション項目の永続化、承認状態の確定、履歴の圧縮を続ける場合があります。
67+
68+
[`result.to_input_list(mode="normalized")`][agents.result.RunResultBase.to_input_list] から手動で継続していて、`cancel(mode="after_turn")` がツールターン後に停止した場合は、新しいユーザーターンをすぐ追加するのではなく、その正規化済み入力で `result.last_agent` を再実行して未完了ターンを継続してください。
69+
- ストリーミング実行がツール承認で停止した場合、それを新しいターンとして扱わないでください。ストリームの消費を最後まで完了し、`result.interruptions` を確認してから、`result.to_state()` から再開してください。
70+
- 次のモデル呼び出し前に、取得したセッション履歴と新しいユーザー入力をどのようにマージするかをカスタマイズするには [`RunConfig.session_input_callback`][agents.run.RunConfig.session_input_callback] を使用します。そこで新規ターン項目を書き換えた場合、そのターンで永続化されるのは書き換え後のバージョンです。
6171

6272
## 実行項目イベントとエージェントイベント
6373

64-
[`RunItemStreamEvent`][agents.stream_events.RunItemStreamEvent] は、より高レベルのイベントです。これは、項目が完全に生成されたタイミングを通知します。これにより、各トークンではなく「メッセージ生成」「ツール実行」などのレベルで進捗更新を送れます。同様に、[`AgentUpdatedStreamEvent`][agents.stream_events.AgentUpdatedStreamEvent] は、現在のエージェントが変わったとき(例: ハンドオフの結果)に更新を提供します。
74+
[`RunItemStreamEvent`][agents.stream_events.RunItemStreamEvent] はより高レベルのイベントです。項目が完全に生成されたときに通知します。これにより、各トークン単位ではなく、「メッセージ生成済み」「ツール実行済み」などのレベルで進捗更新を送れます。同様に、[`AgentUpdatedStreamEvent`][agents.stream_events.AgentUpdatedStreamEvent] は、現在のエージェントが変わったとき(例: ハンドオフの結果)に更新を提供します。
6575

6676
### 実行項目イベント名
6777

68-
`RunItemStreamEvent.name` は、固定された意味的イベント名のセットを使用します
78+
`RunItemStreamEvent.name` は、固定のセマンティックなイベント名セットを使用します
6979

7080
- `message_output_created`
7181
- `handoff_requested`
@@ -81,9 +91,9 @@ if result.interruptions:
8191

8292
`handoff_occured` は、後方互換性のため意図的にスペルミスのままです。
8393

84-
ホストされたツール検索を使用すると、モデルがツール検索リクエストを発行したときに `tool_search_called` が送出され、Responses API が読み込まれたサブセットを返したときに `tool_search_output_created` が送出されます
94+
ホスト型ツール検索を使用すると、モデルがツール検索リクエストを発行したときに `tool_search_called` が発行され、Responses API が読み込まれたサブセットを返したときに `tool_search_output_created` が発行されます
8595

86-
たとえば、以下は raw イベントを無視し、ユーザーへの更新をストリーミングします。
96+
たとえば、これは raw イベントを無視して、ユーザーへの更新をストリーミングします。
8797

8898
```python
8999
import asyncio

0 commit comments

Comments
 (0)