valenti/vocero-client
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: standardize Spanish user-facing copy

Browse Source
This commit is contained in:
alvaro
2026-10-05 10:24:33 -03:00
parent dfc1f663c7
commit cdbff5cb0e
8 changed files with 204 additions and 201 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/proposals/vocero-architecture.html
+2 -2
View File
@@ -244,7 +244,7 @@ a.inline_marker { display:inline; margin-left:1px; color:#075c77; font-size:.9em
<h3 id="11-4-data-and-retention" data-cid="kuKGIi">11.4 Data and retention</h3><p data-cid="k_4NLm">Define a matrix by data class:</p><ul data-cid="3v1WWF"><li data-cid="5rJmr1">raw audio;</li><li data-cid="VkSLyu">voice references;</li><li data-cid="8aOIsd">transcripts;</li><li data-cid="J7Y74H">prompt/context;</li><li data-cid="6CPODX">model responses;</li><li data-cid="2gYs6P">tool arguments and results;</li><li data-cid="phF27i">telemetry and auditing.</li></ul><p data-cid="aF8xcz">For each class, approve purpose, legal basis, location, encryption, retention, deletion, export, access, training use and redaction. <strong data-cid="5qKyXe">Pending:</strong> the requester did not supply corporate policies or jurisdictions; this document therefore sets no retention periods.</p>
<h2 class="chapter" id="12-observability-and-initial-slos" data-cid="tCwZyI">12. Observability and initial SLOs</h2><h3 id="12-1-telemetry-model" data-cid="m3zjXZ">12.1 Telemetry model</h3><p data-cid="j-u4rg"><strong data-cid="1UhJRp">Traces:</strong> one trace per turn with spans for capture, relay, STT, endpointing, LLM, policy, MCP, TTS, network and playout. The future RC proposes standardized names for propagating W3C Trace Context in <code data-cid="9z3Qpe">_meta</code>, but this form remains a candidate until ratification <a class="inline_marker" href="#ref4" data-cid="wS4Po1">4</a>. In the stable adapter, Vocero will propagate <code data-cid="93rwTu">traceparent</code> through compatible internal metadata without requiring future domain changes.</p><p data-cid="J750jH"><strong data-cid="BBbmRc">Experience metrics</strong></p><ul data-cid="2Ey_Wc"><li data-cid="5o-A_q"><code data-cid="hwNkdv">turn_endpointing_ms</code>: acoustic endpoint to turn commit.</li><li data-cid="zAukNl"><code data-cid="6rWpQr">stt_partial_ms</code> and <code data-cid="ncoQUH">stt_final_ms</code>.</li><li data-cid="YaedG8"><code data-cid="WJGF8k">llm_ttft_ms</code>: commit to first token.</li><li data-cid="NcE_iK"><code data-cid="T1Lm8L">tts_ttfa_ms</code>: available text to first audio.</li><li data-cid="vmcq1R"><code data-cid="AdCatj">ttfs_ms</code>: end of speech to first playable sound.</li><li data-cid="2gr-6y"><code data-cid="tCPnFi">barge_in_stop_ms</code>: interruption detection to effective silence.</li><li data-cid="A3Y_lr"><code data-cid="5iwjTj">tool_latency_ms</code> by tool and outcome.</li><li data-cid="AAhZAj"><code data-cid="aETFuO">turn_e2e_ms</code> by direct or tool-assisted path.</li><li data-cid="7kZ6vC">reconnection, cancellation, false barge-in and abandonment rates.</li></ul><p data-cid="M1dVZO">TTFT and end-to-end latency are recognized as distinct, relevant dimensions for voice/realtime workloads <a class="inline_marker" href="#ref9" data-cid="XoMUg9">9</a>.</p><p data-cid="tFQY1A"><strong data-cid="nbmcXA">Quality metrics</strong></p><ul data-cid="G_hour"><li data-cid="Ns_Vtp">WER/CER by language, accent, noise and domain.</li><li data-cid="5krVT8">early/late endpointing rate.</li><li data-cid="QIKGrD">intelligibility and human assessment of naturalness.</li><li data-cid="VbZp2z">speaker similarity and voice stability.</li><li data-cid="erBq7M">accuracy of tool selection, arguments, policy and task completion.</li></ul><p data-cid="GBKg7X"><strong data-cid="nP3Trf">Resource metrics</strong></p><ul data-cid="Pp9yP4"><li data-cid="9QftJu">GPU utilization and memory; KV cache; per-model queues; tokens/s; audio seconds/s.</li><li data-cid="ydnFOY">buffer depth and age; drops; retransmissions; jitter; playout underruns.</li><li data-cid="xe-hyA">active connections, admitted/rejected sessions and dependency errors.</li></ul>
<h3 id="12-2-initial-targets-not-observed-performance" data-cid="o1IqPd">12.2 Initial targets — not observed performance</h3><blockquote data-cid="ewkw_Y"><p data-cid="MtiLnU"><strong data-cid="6q8cxx">[REC/BENCH]</strong> These values are <strong data-cid="Aa5TVw">provisional engineering targets</strong>, not measured figures, guarantees or a contractual SLO. They must be ratified after benchmarking with real audio, networks, tools and concurrency.</p></blockquote>
<div class="sk-doc-native-table-frame" data-scroll-left-active="false" data-scroll-right-active="false" data-scrolling="false" data-cid="UewefS"><table data-cid="3Lkxis"><thead data-cid="SWgBg1"><tr data-cid="YX23Pt"><th data-cid="fLV9-Q">Indicator</th><th data-cid="PdPaBM">Proposed initial target</th><th data-cid="x-RkYj">Window/percentile</th><th data-cid="L7jYUr">Ratification condition</th></tr></thead><tbody data-cid="SGn-1f"><tr data-cid="ISg1qm"><td data-cid="FSnIs_">Conversational service availability</td><td data-cid="DXM-N-">≥ 99,5 %</td><td data-cid="mP0Cbp">Monthly</td><td data-cid="VXfMex">Exclude agreed windows and define the GPU dependency</td></tr><tr data-cid="QIW15t"><td data-cid="cSvYGf">Response audio start <code data-cid="OkiyqU">ttfs_ms</code></td><td data-cid="l71z6T">≤ 1,200 ms</td><td data-cid="YEYtBX">p95, direct turn</td><td data-cid="AfnwPM">Target corporate network and warm session</td></tr><tr data-cid="ASRmra"><td data-cid="Q56rj9">Barge-in stopping</td><td data-cid="cxb2To">≤ 300 ms</td><td data-cid="qldv4J">p95</td><td data-cid="SnU8xd">Measured through playout silence, not only ACK</td></tr><tr data-cid="xq02_4"><td data-cid="0I_Qns">Turns without platform errors</td><td data-cid="H_4-3I">≥ 99,0 %</td><td data-cid="sm91bg">Monthly</td><td data-cid="IkJZS1">Separate dependency errors from invalid input</td></tr><tr data-cid="ntZaDX"><td data-cid="an4iVp">MCP read executions accepted by the gateway</td><td data-cid="svmQf9">≥ 99,0 %</td><td data-cid="doBQAs">Monthly</td><td data-cid="nlo5iR">Exclude policy rejections and downstream timeouts</td></tr><tr data-cid="u02olk"><td data-cid="aQBhCN">Loss of accepted control events</td><td data-cid="CAW-uo">0</td><td data-cid="SE8KqI">Every window</td><td data-cid="fQ1UeX">Verified by sequence and ACK</td></tr><tr data-cid="13mkhq"><td data-cid="Ze0MIK">Unauthorized voice use</td><td data-cid="CiiGPZ">0</td><td data-cid="huwWIH">Every window</td><td data-cid="DcBt-f">Mandatory alert and audit</td></tr></tbody></table></div><p data-cid="RxZGbL">Provisional budget for <code data-cid="NISkWj">ttfs_ms</code> for analysis, not a commitment:</p><pre class="code-block keep-together" data-cid="LJ82ku"><code class="code language-text" data-cid="qKu-h-">endpointing + STT final + scheduling + LLM TTFT + TTS primer audio + transporte/playout</code></pre><p data-cid="gGyyys">No fixed milliseconds are allocated per stage before benchmarking; the dashboard must show contributions and percentiles separately.</p>
<div class="sk-doc-native-table-frame" data-scroll-left-active="false" data-scroll-right-active="false" data-scrolling="false" data-cid="UewefS"><table data-cid="3Lkxis"><thead data-cid="SWgBg1"><tr data-cid="YX23Pt"><th data-cid="fLV9-Q">Indicator</th><th data-cid="PdPaBM">Proposed initial target</th><th data-cid="x-RkYj">Window/percentile</th><th data-cid="L7jYUr">Ratification condition</th></tr></thead><tbody data-cid="SGn-1f"><tr data-cid="ISg1qm"><td data-cid="FSnIs_">Conversational service availability</td><td data-cid="DXM-N-">≥ 99.5 %</td><td data-cid="mP0Cbp">Monthly</td><td data-cid="VXfMex">Exclude agreed windows and define the GPU dependency</td></tr><tr data-cid="QIW15t"><td data-cid="cSvYGf">Response audio start <code data-cid="OkiyqU">ttfs_ms</code></td><td data-cid="l71z6T">≤ 1,200 ms</td><td data-cid="YEYtBX">p95, direct turn</td><td data-cid="AfnwPM">Target corporate network and warm session</td></tr><tr data-cid="ASRmra"><td data-cid="Q56rj9">Barge-in stopping</td><td data-cid="cxb2To">≤ 300 ms</td><td data-cid="qldv4J">p95</td><td data-cid="SnU8xd">Measured through playout silence, not only ACK</td></tr><tr data-cid="xq02_4"><td data-cid="0I_Qns">Turns without platform errors</td><td data-cid="H_4-3I">≥ 99.0 %</td><td data-cid="sm91bg">Monthly</td><td data-cid="IkJZS1">Separate dependency errors from invalid input</td></tr><tr data-cid="ntZaDX"><td data-cid="an4iVp">MCP read executions accepted by the gateway</td><td data-cid="svmQf9">≥ 99.0 %</td><td data-cid="doBQAs">Monthly</td><td data-cid="nlo5iR">Exclude policy rejections and downstream timeouts</td></tr><tr data-cid="u02olk"><td data-cid="aQBhCN">Loss of accepted control events</td><td data-cid="CAW-uo">0</td><td data-cid="SE8KqI">Every window</td><td data-cid="fQ1UeX">Verified by sequence and ACK</td></tr><tr data-cid="13mkhq"><td data-cid="Ze0MIK">Unauthorized voice use</td><td data-cid="CiiGPZ">0</td><td data-cid="huwWIH">Every window</td><td data-cid="DcBt-f">Mandatory alert and audit</td></tr></tbody></table></div><p data-cid="RxZGbL">Provisional budget for <code data-cid="NISkWj">ttfs_ms</code> for analysis, not a commitment:</p><pre class="code-block keep-together" data-cid="LJ82ku"><code class="code language-text" data-cid="qKu-h-">endpointing + STT final + scheduling + LLM TTFT + TTS first audio + transport/playout</code></pre><p data-cid="gGyyys">No fixed milliseconds are allocated per stage before benchmarking; the dashboard must show contributions and percentiles separately.</p>
<h3 id="12-3-initial-alerts" data-cid="VSjV0I">12.3 Initial alerts</h3><ul data-cid="k6nCPX"><li data-cid="bR2-tx">Availability and successful-turn burn rates.</li><li data-cid="NRzADW">Sustained queue growth or buffer age.</li><li data-cid="UxO0GD">GPU OOM, model restart or degraded health.</li><li data-cid="3tEvV4">Divergence between <code data-cid="qazQ-Y">generation.cancel</code> and the last emitted chunk.</li><li data-cid="Qb28W0">MCP error/latency by tool, tenant and dependency.</li><li data-cid="NQMtl-">Denied access or voice anomalies.</li><li data-cid="lSA2BL">Missing traces or uncontrolled cardinality.</li></ul>
<h2 class="chapter" id="13-scalability-backpressure-and-resilience" data-cid="S-LogK">13. Scalability, backpressure and resilience</h2><h3 id="13-1-scaling" data-cid="Tx0fGk">13.1 Scaling</h3><ul data-cid="4QpQzq"><li data-cid="-_zxab"><strong data-cid="vM8-7h">Edge/Relay:</strong> horizontal scaling by connections; minimal state; drain before deployment.</li><li data-cid="10o9TO"><strong data-cid="qYAfma">Orchestrator:</strong> horizontal scaling by session with a store lease; optional affinity as an optimization rather than a correctness requirement.</li><li data-cid="gxrdWw"><strong data-cid="RXXb7w">MCP Gateway:</strong> horizontal scaling; per-downstream pools; per-tenant/tool bulkheads.</li><li data-cid="zHEk8m"><strong data-cid="OJwAHO">Inference:</strong> admission control based on actual capacity, not only CPU; separate STT, LLM and TTS queues; prioritize cancellation and active audio.</li><li data-cid="G5cthX"><strong data-cid="Ye4Twn">Voice cache:</strong> encrypted cache bounded by approved voices; invalidate on version changes/revocation.</li></ul>
<h3 id="13-2-backpressure" data-cid="0JvDeL">13.2 Backpressure</h3><p data-cid="utahvp"><strong data-cid="cHawg8">[REC]</strong> Each link publishes <code data-cid="N2slfm">high_watermark</code>, <code data-cid="ke9ISa">low_watermark</code> and an overflow policy. The LLM can produce text faster than TTS or the network can consume it; the system must throttle tokens, group pronounceable units and limit buffered audio. Realtime pipelines document the general problem of fast producers and slow consumers <a class="inline_marker" href="#ref10" data-cid="TffY26">10</a>.</p><p data-cid="PAiaHT">Policies:</p><ol data-cid="34cFBN"><li data-cid="BS0Gyn">Control events never share a blocking queue with audio.</li><li data-cid="9Hbjz9">Stale partial STT transcripts may be coalesced; final transcripts and commits may not.</li><li data-cid="U030et">Discard unsynthesized tokens from a canceled generation.</li><li data-cid="_oDMes">Discard generated but unplayed audio on interruption.</li><li data-cid="gOQW7L">A slow connection cannot consume unbounded memory.</li><li data-cid="zcEc1G">The client reports <code data-cid="upJNXd">buffered_ms</code> and playout; the server adjusts chunking or pauses.</li><li data-cid="D4VlSi">Queues have deadlines; expired work is not processed merely for completeness.</li></ol>
@@ -269,4 +269,4 @@ a.inline_marker { display:inline; margin-left:1px; color:#075c77; font-size:.9em
</article>
</body></html>
</body></html>