Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Track deferred ElevenLabs webhook transcription and conversational voice APIs

Aperta
#2,440 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
observability

Direzione di ricerca

Inizia leggendo issue #2293 e l’integrazione esistente del tracing request/response, quindi esamina gli entrypoint ElevenLabs elencati: webhook transcription, SpeechEngine.Server, SpeechEngine.Session e conversational voice APIs. Definisci il contratto di tracing per i job asincroni e le sessioni in ingresso prima dell’implementazione, includendo correlazione, durata dello span, comportamento in caso di disconnessione e output finali. Il lavoro è completato quando test realistici end-to-end del ciclo di vita preservano il contratto di trace request/response esistente senza trattare gli acknowledgements o il testo in uscita come generazioni completate.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Sub-issue of #2293 tracking the remaining conversational execution surfaces from that issue, plus asynchronous transcription mode. These APIs are intentionally excluded from the current request/response instrumentation.

Deferred surfaces:

  • client.speechToText.convert({ ..., webhook: true }): the request returns an acknowledgement and the transcription arrives at a separately configured webhook.
  • client.speechEngine.attach(...) and SpeechEngine.Server: inbound WebSocket session handling rather than an application-initiated model request returning its result.
  • SpeechEngine.Session transcript callbacks and session.sendResponse(...): the application receives inbound transcripts and sends response text to ElevenLabs; sending text does not return the synthesized audio to that application process. Session lifecycle/listener methods are also uninstrumented.
  • Conversational voice connection/run APIs mentioned in #2293: verify the exact package and execution entrypoints before implementation. Browser voice connections are provided by the separate @elevenlabs/client SDK; client.conversationalAi REST authentication and management endpoints should not be treated as model-generation calls merely because they relate to agents.

Future work needs an explicit tracing contract for asynchronous jobs or inbound conversational sessions: correlation across requests/processes, span ownership and lifetime, cancellation/disconnect behavior, and how final outputs are captured. Do not represent job acknowledgements or outbound response text as completed model generations.

The current implementation deliberately removes Speech Engine instrumentation from both manual and automatic paths and skips webhook transcription. Any future coverage should include realistic lifecycle e2e tests and preserve the request/response integration's existing trace contract.

Lingua principale
TypeScript
Stelle
27
Fork
13
Merge medio
2g 20h
PR unite (30g)
66

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di braintrustdata/braintrust-sdk-javascript

Tutte le issue di braintrustdata/braintrust-sdk-javascript

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.