Transcripción
Usa los esquemas de herramientas de PyAI conectadas como fuente de verdad; los clientes pueden prefijar los IDs de las herramientas con el nombre del servidor. Si PyAI está desconectado, dirige al usuario a la pantalla de inicio de sesión en el navegador del anfitrión. Mantén las credenciales fuera del chat. Respeta el proyecto seleccionado y la tarea autorizada del usuario.
Herramientas: whoami, transcribe_audio, create_transcription_job, get_transcription_job, list_transcription_jobs
Para una grabación corta proporcionada, usa transcribe_audio con audio en base64 (hasta 8 MiB descodificado). Para una grabación más grande ya disponible en una URL HTTPS autorizada, usa create_transcription_job. Inspecciona los esquemas actuales para opciones de diarización, idioma y otras; nunca prometas una opción que no esté en el contrato.
Conserva el job_id devuelto. Consulta get_transcription_job a intervalos razonables hasta que se complete, ocurra un error o se alcance el límite de espera de la tarea. Pendiente no es fallo. Si la espera termina, devuelve el ID y estado reales para que el trabajo pueda reanudarse; no reenvíes la grabación.
Devuelve la transcripción y cualquier dato de hablante/marca de tiempo realmente proporcionado. Para transmisión por micrófono, usa la API de transmisión o SDK de Hear descrito en https://docs.pyai.com; un trabajo de transcripción MCP no es una transmisión de audio en vivo.