Voz (ElevenLabs)

Para la voz, Sherlock trabaja junto con ElevenLabs Agents. ElevenLabs hace el reconocimiento de voz, la síntesis y el manejo de turnos de la llamada; Sherlock hace el razonamiento, con el mismo conocimiento, las mismas herramientas y los mismos guardrails que en el resto de los canales. En ElevenLabs, Sherlock figura como un «LLM personalizado» (Custom LLM).

1. En el Estudio del agente, vista Canales, hacé clic en «Conectar canal» → «Voz (ElevenLabs)».
2. Elegí Nombre y Ambiente y hacé clic en «Crear canal».

La tarjeta muestra la «URL del LLM personalizado (Server URL en ElevenLabs)»:

https://app.sherlock.posselab.net/voice/vox_xxxxxxxxxxxxxxxxxxxxxxxx

Después, conectalo a ElevenLabs de forma automática o manual.

En la tarjeta del canal, sección «Crear el agente en ElevenLabs automáticamente»:

1. API key de ElevenLabs: con permisos sobre Agents (ConvAI). Se guarda cifrada.
2. Voice ID (opcional): la voz que querés usar.
3. Primer mensaje (opcional): lo primero que dice al atender. Si lo dejás vacío, usa el mensaje de bienvenida del agente.
4. Hacé clic en «Crear agente de voz».

Sherlock crea en ElevenLabs el agente «Sherlock · (nombre del agente)», configurado con la URL del LLM personalizado, y te muestra el «Código del widget de voz para el sitio»:

<elevenlabs-convai agent-id="agent_xxxxxxxx"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>

Si después cambiás la voz o el primer mensaje, usá «Actualizar agente de voz». Las instrucciones y el conocimiento se siguen administrando en Sherlock.

Si preferís configurar el agente en la consola de ElevenLabs:

1. En ElevenLabs → tu agente → LLM, elegí Custom LLM.
2. Pegá la URL del LLM personalizado que muestra el canal. ElevenLabs le agrega /v1/chat/completions; Sherlock acepta las dos variantes.
3. Como modelo, cualquier valor (por ejemplo sherlock): Sherlock usa el modelo configurado en el agente.

Para atender llamadas, conectá un número al mismo agente de ElevenLabs desde la consola de ElevenLabs, por SIP trunk o con Twilio. Sherlock no necesita ninguna configuración adicional: la llamada usa la misma URL.

• El agente responde con frases cortas y naturales, sin markdown, listas, emojis, URLs ni números de cita, y lee números y siglas de forma que suenen bien.
• Las citas y el formato se quitan de la respuesta antes de enviarla a ElevenLabs.
• Las respuestas se transmiten a medida que se generan, para que la voz empiece a hablar enseguida.
• Los mensajes de una misma llamada forman una conversación, visible en Conversaciones con el canal «Voz» y su traza.
• Las derivaciones quedan registradas en la Bandeja, pero las respuestas escritas de un operador no se pueden reproducir en una llamada: el operador tiene que contactar a la persona por otro medio.

La URL del LLM personalizado incluye un token secreto que identifica el canal: no la compartas fuera de ElevenLabs. Si se filtró, usá «Regenerar credencial» y actualizala en ElevenLabs (o volvé a usar «Actualizar agente de voz»).