docs: daily engineering digest for 2026-07-28

automations/livekit-agent/2026-07-28.markdown

@@ -0,0 +1,27 @@
+# LiveKit Agents 每日工程摘要
+
+**Date range covered:** 2026-07-27 00:00 UTC → 2026-07-28 00:00 UTC  
+**Repository:** [livekit/agents](https://github.com/livekit/agents) (`upstream/main`)  
+**Commits landed:** 3
+
+---
+
+## 关键变更
+
+- **Cloud Agent 可观测性增强（[#6570](https://github.com/livekit/agents/pull/6570)）** — 读取 `LIVEKIT_AGENT_ID` 与 `LIVEKIT_AGENT_DEPLOYMENT` 环境变量，在 tracing resource 与 session metadata（spans + logs）中写入 `lk.cloud_agent_id` / `lk.deployment_id`，沿用既有 `lk.agent_name` 模式；自托管或未设置时自动省略。新增 64 行测试（`tests/test_recording.py`）。影响：LiveKit Cloud 部署可按 agent 实例与 deployment 归因遥测数据。
+
+- **Evals Judge 工具调用解析修复（[#6382](https://github.com/livekit/agents/pull/6382)，关闭 [#4240](https://github.com/livekit/agents/issues/4240)）** — intent/verdict judge 将 `tool_choice` 从特定函数名改为 `"required"`，避免 Azure gpt-4.1 等 provider 在 pinned function 路径下间歇性返回截断 JSON，触发 `ValueError: EOF while parsing a string`。改动覆盖 `evals/judge.py` 与 `voice/run_result.py`，新增 110 行 `tests/test_judge.py`。影响：evals 流水线在 Azure 等 provider 上稳定性提升。
+
+- **ElevenLabs Realtime STT 支持 `previous_text`（[#6534](https://github.com/livekit/agents/pull/6534)，关闭 [#6074](https://github.com/livekit/agents/issues/6074)）** — 在 WebSocket 连接（含重连）后，于首个空 `input_audio_chunk` 上发送 `previous_text` 作为 priming 上下文，满足 ElevenLabs `scribe_v2_realtime` 协议要求。新增插件与集成测试。影响：使用 ElevenLabs realtime STT 的 agent 可在重连后保留前文语境，提升转录连贯性。
+
+- **活跃 PR 生态（未合入，24h 内更新）** — 同日 upstream 出现大量 voice/插件 PR：`#6564`（工具调用后自适应打断保留）、`#6560`（CJK 连续文本 markdown 剥离）、`#6562`（Sarvam realtime STT）、`#6573`（Inworld Realtime 插件）、`#6552`（放宽 OpenTelemetry 版本约束至 `>=1.39.0,<2`）、`#6551`（falsy 工具返回值不再被吞）。显示 voice 打断与 STT/TTS 插件仍是当前活跃开发主线。
+
+---
+
+## Watchlist
+
+1. **自适应打断 + 工具调用交叉场景（[#6564](https://github.com/livekit/agents/pull/6564)）** — 修复工具调用后 agent playout 恢复时用户重叠语音被静默丢弃（AGT-3180 / #6548）。改动位于 voice 打断核心路径，合入前需关注回归风险；remote forwarding 标记仍待协议支持。
+
+2. **Falsy 工具返回值修复无单测（[#6551](https://github.com/livekit/agents/pull/6551)）** — `make_function_call_output` 将 `0`/`False`/`[]` 等合法返回值错误折叠为 `""`，PR 作者注明未加单元测试（需完整 agents runtime）。合入后建议在 `llm/utils.py` 补覆盖，避免同类回归。
+
+3. **Fork 持续落后 upstream 321 commits** — 今日 upstream 合入 3 条（#6570/#6382/#6534），本仓库 `origin/main` 未同步。自动化摘要基于 upstream 证据，fork 代码状态可能脱节，建议计划 bulk sync。