Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 37a285e637
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
|
|
||
| ### 音声設定 | ||
| - マイク入力取得およびスピーカー再生コード。[`examples/realtime`](https://github.com/openai/openai-agents-python/tree/main/examples/realtime) の realtime コード例を参照してください。 | ||
| - SIP / テレフォニー接続フロー。[Realtime transport](transport.md) と [SIP section](guide.md#sip-and-telephony) を参照してください。 |
There was a problem hiding this comment.
Use localized anchors for quickstart cross-links
The new quickstart links point to English section fragments (for example guide.md#sip-and-telephony, and similarly #manual-response-control / #low-level-access-and-custom-endpoints), but the linked localized guide now uses translated headings (e.g. ## SIP とテレフォニー, ### 手動レスポンス制御, ## 低レベルアクセスとカスタムエンドポイント), so these anchors do not resolve and users are sent to the top of the page instead of the intended section; the same pattern appears in the KO/ZH quickstarts added in this commit.
Useful? React with 👍 / 👎.
| - **ローカル MCP サーバー**: `MCPServerStdio` / `MCPServerSse` / `MCPServerStreamableHttp` の `require_approval` を使って MCP ツール呼び出しを制御します(`examples/mcp/get_all_mcp_tools_example/main.py` と `examples/mcp/tool_filter_example/main.py` を参照)。 | ||
| - **ホスト型 MCP サーバー**: HITL を強制するには、`HostedMCPTool` の `require_approval` を `"always"` に設定します。必要に応じて、自動承認または却下のため `on_approval_request` を指定できます(`examples/hosted_mcp/human_in_the_loop.py` と `examples/hosted_mcp/on_approval.py` を参照)。信頼できるサーバーには `"never"` を使用します(`examples/hosted_mcp/simple.py`)。 | ||
| - **セッションとメモリ**: `Runner.run` にセッションを渡すと、承認と会話履歴を複数ターンにわたって保持できます。SQLite と OpenAI Conversations のセッションバリアントは `examples/memory/memory_session_hitl_example.py` と `examples/memory/openai_session_hitl_example.py` にあります。 | ||
| - **Realtime エージェント**: realtime デモでは、`RealtimeSession` の `approve_tool_call` / `reject_tool_call` を通じてツール呼び出しを承認または却下する WebSocket メッセージを公開しています(サーバー側ハンドラーは `examples/realtime/app/server.py`、API の表面は [Realtime ガイド](realtime/guide.md#tool-approvals) を参照)。 |
There was a problem hiding this comment.
Link HITL docs to an existing guide anchor
This new link targets realtime/guide.md#tool-approvals, but the localized realtime guide section is translated (### ツール承認) and does not expose that English fragment, so the "Realtime ガイド" link in this HITL page will not jump to the approvals section; KO/ZH translations in the same commit have the same broken fragment.
Useful? React with 👍 / 👎.
Automated update of translated documentation.
Triggered by commit: 148ecabf53edda515bba6fc2d1629f211e8ac0d0.
Message:
docs: clarify realtime transport boundaries and SIP attach flows (#2591)