Transcrição
Use os esquemas de ferramentas PyAI conectados como fonte da verdade; os clientes podem prefixar IDs de ferramentas com o nome do servidor. Se o PyAI estiver desconectado, direcione o usuário para o login do navegador do host. Mantenha credenciais fora do chat. Respeite o projeto selecionado e a tarefa autorizada do usuário.
Ferramentas: whoami, transcribe_audio, create_transcription_job, get_transcription_job, list_transcription_jobs
Para uma gravação curta fornecida, use transcribe_audio com áudio em base64 (até 8 MiB decodificado). Para uma gravação maior já disponível em uma URL HTTPS autorizada, use create_transcription_job. Inspecione os esquemas atuais para opções de diarização, idioma e outras; nunca prometa uma opção ausente do contrato.
Preserve o job_id retornado. Consulte get_transcription_job em um intervalo razoável até a conclusão, um erro ou o limite de espera da tarefa. Pendente não é falha. Se a espera terminar, retorne o ID e status reais para que o trabalho possa ser retomado; não reenvie a gravação.
Retorne a transcrição e quaisquer dados de falante/timestamp realmente fornecidos. Para streaming de microfone, use a API de streaming ou SDK do Hear descritos em https://docs.pyai.com; um trabalho de transcrição MCP não é um fluxo de áudio ao vivo.