PC 오디오 출력 - Typecast Documentation

에이전트가 로컬 컴퓨터를 제어하는 상황에서는 CLI로 짧은 텍스트를 음성으로 만들고 기본 오디오 출력 장치로 바로 재생할 수 있습니다. 작업 완료 알림, 손을 쓰지 않는 상태 안내, 빠른 음성 미리듣기에 유용합니다.

로컬 에이전트 피드백에는 cast "message"가 가장 단순한 실시간 느낌의 경로입니다. API 레벨의 chunked streaming이 필요하면 SDK로 타입캐스트 streaming endpoint를 사용하세요.

바로 말하기

cast "The export is complete."

CLI는 기본적으로 파일 저장 대신 생성된 오디오를 바로 재생합니다.

긴 문장이나 반복 재생이 필요한 메시지는 먼저 파일로 저장합니다:

cast "The build failed. Check the test report before pushing." --out agent-alert.wav

이후 시스템 오디오 도구로 재생합니다:

afplay agent-alert.wav

aplay agent-alert.wav

긴 작업이 끝나면 PC 오디오로 짧은 상태 안내를 말해줘.
CLI를 사용해줘.
말할 문장은 12단어 이하로 유지해줘.
재생에 실패하면 오디오 파일을 저장하고 경로를 알려줘.

상황	추천 문장
작업 완료	`The task is complete.`
사용자 입력 필요	`I need your input to continue.`
테스트 실패	`Tests failed. Please check the report.`
배포 준비 완료	`The preview is ready.`

필요	추천 경로
빠른 음성 상태 안내	`cast "The preview is ready."`
같은 알림 반복 재생	`--out agent-alert.wav`로 저장한 뒤 `afplay`로 재생
에이전트 전용 음성	`cast config set voice-id tc_xxx`
프로젝트 전용 음성	`cast voices clone` 후 `--voice-id uc_xxx` 사용
자세한 보고	한 문장만 말하고 세부 내용은 채팅이나 로그에 작성

PC 오디오 메시지는 짧게 유지하세요. 자세한 상태는 한 문장으로 말하고, 세부 내용은 채팅이나 로그에 남기는 편이 좋습니다.