[bot] OpenAI Live API (`client.live`) not instrumented
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 48/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- ruby
调研方向
Start with lib/braintrust/contrib/openai/patcher.rb and the existing files under lib/braintrust/contrib/openai/instrumentation/, especially the Chat and Responses implementations. Compare their instrumentation approach with the Live API create and sessions.fork entry points described here, then check lib/braintrust/contrib.rb for registration. Done means the actionable Live session calls are instrumented with the listed input, metadata, and safe output fields, with session-stream handling scoped as appropriate.
由索引模型根据 Issue 内容生成。
描述
Summary
The official openai Ruby gem added a top-level Live API (client.live) in v0.89.0 (2026-09-10, "api: Add Live API"). This is OpenAI's GPT-Live real-time, full-duplex voice-conversation execution surface (spoken input/output, with server-side or client-delegated backend reasoning) — a distinct generative execution path from Chat Completions, Responses, and the already-tracked Realtime API (#206). No Patcher in this repo wraps any part of it.
What is missing
Per the official Ruby API reference (developers.openai.com/api/reference/ruby/resources/live):
client.live.create(session:, transport:, **kwargs)→POST /live/sessions— creates a Live session (returnssession,transport, e.g. an SDP answer for WebRTC). This is the generation-session-initiating call.client.live.sessions.fork(session_id, **kwargs)→POST /live/sessions/{session_id}/fork— forks a live session into a new one, returning a new session/transport pair.client.live.sessions.accept/hangup/refer/reject(session_id, **kwargs)→ SIP-style session lifecycle control.client.live.sessions.download_recording(session_id)→ retrieves the session's recorded audio.- Session interaction itself happens over
ClientEvent/ServerEventstreams (Primary/Sideband/Fork WebSocket connections) once a session is created — analogous to the streaming event model already instrumented for Chat Completions/Responses in this repo, but for a new resource family.
What a span should capture
- Input: session config (
model,audio,clientdelegation settings) passed tolive.create/sessions.fork - Metadata: provider (
openai), sessionid,model,expires_at, transport type - Output: resolved session/transport response (excluding any secret/credential values)
- Given the live/bidirectional nature of the session,
live.create(andsessions.fork) are the actionable, well-defined instrumentation points — matching the pattern already proposed for other session-initiating calls in this repo (e.g. #206 for the Realtime API, #223 for the Agents API)
Braintrust docs status
not_found — Neither https://www.braintrust.dev/docs/integrations/ai-providers/openai nor https://www.braintrust.dev/docs/integrations/sdk-integrations mention "Live API," "GPT-Live," or client.live for any language, including Ruby.
Upstream sources
- openai-ruby CHANGELOG: https://raw.githubusercontent.com/openai/openai-ruby/main/CHANGELOG.md (v0.89.0 "Add Live API")
- Ruby API reference for the Live resource: https://developers.openai.com/api/reference/ruby/resources/live
- GPT-Live getting-started guide: https://developers.openai.com/api/docs/guides/live
Braintrust docs sources checked
- https://www.braintrust.dev/docs/integrations/ai-providers/openai
- https://www.braintrust.dev/docs/integrations/sdk-integrations
Local repo files inspected
lib/braintrust/contrib/openai/patcher.rb— definesChatPatcher,ResponsesPatcher,ModerationsPatcher; no live/session patcherlib/braintrust/contrib/openai/instrumentation/— containschat.rb,responses.rb,moderations.rb,common.rb; nolive.rblib/braintrust/contrib.rb— registers only the three existing OpenAI patchers- Grep for
live,client.live,GPT-Liveacrosslib/braintrust/returns zero relevant matches
- 主要语言
- Ruby
- 星标
- 9
- 派生
- 11
- 平均合并
- 2 天 3 小时
- 30 天内合并 PR
- 5
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
braintrustdata/braintrust-sdk-ruby 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 78/100
-
难度 2/5 1-3 小时 新手友好度 76/100
-
难度 2/5 1-3 小时 新手友好度 72/100
-
ruby
难度 3/5 半天 新手友好度 62/100
-
ruby
难度 3/5 1-2 天 新手友好度 45/100
查看 braintrustdata/braintrust-sdk-ruby 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
TheOdinProject/curriculum#31493 ·
维护者通常 1 天内回复
-
enhancement
难度 1/5 1 小时以内 新手友好度 62/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
rmosolgo/graphql-ruby#5843 ·
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 66/100
betagouv/conseillers-entreprises#4770 ·
维护者通常 1 天内回复