Google Docs 음성 텍스트 변환
작성: Ai Flowi · 게시일 .
공식 출처: AssemblyAI 문서, Google Docs API 문서
Google Docs 음성 텍스트 변환은 처리가 허용된 녹음을 제출하고 전사 작업을 확인한 뒤, 성공적으로 완료되면 검토한 전사 텍스트를 저장하는 과정입니다. 작업 생성, 전사 완료, 문서 생성은 별도 결과로 취급합니다. 이 가이드는 자동 녹음-문서 변환 흐름이 테스트되었다고 주장하지 않으며, 단계 간 전달과 실패 확인 방법을 설명합니다.
설정 예시이며, 기록된 테스트가 아닙니다. 전사 및 문서 생성 제안은 카탈로그에 문서화되어 있으며, Ai Flowi가 프로덕션 환경에서 테스트한 것은 아닙니다.
1. 처리가 허용된 녹음과 저장 대상을 준비합니다
제공업체를 통한 전사가 취급 권한상 허용되는 녹음을 선택합니다. 출처 식별자, 대상 언어, 취급 제한과 검토 목적을 기록합니다. 파일을 갖고 있다는 이유만으로 내용을 처리하거나 배포할 권한이 있다고 가정하지 않습니다. Google 문서의 예정 열람 대상과 녹음에 대한 접근 권한은 별도로 관리합니다.
처리가 허용된 녹음 샘플로 AI Flowi Workflow를 준비하고, 제공업체 설정 참조 문서에 따라 직접 관리하는 AssemblyAI 계정과 API 키를 연결합니다(AssemblyAI 사용료는 별도 청구). Google 연결 설정으로 저장 대상에 사용할 Google 계정을 승인합니다.
이 가이드는 언어 모델 요약을 추가하지 않고 하나의 녹음을 검토된 문서로 만드는 과정을 다룹니다. 문서 생성 권한은 예정된 전사문 열람 대상까지 포괄해야 합니다.
2. AssemblyAI Start Transcript를 설정합니다
AssemblyAI Start Transcript의 audio_file에 처리가 허용된 샘플을 설정하고, 다음 선택 사항을 사용하여 텍스트가 문서의 검토 목적에 적합한지 평가합니다.
| 입력 | 초기 선택 | 확인할 사항 |
|---|---|---|
api_key | 컴포넌트의 인증 정보 필드에 입력하는 본인의 AssemblyAI 인증 정보. | 전사 텍스트와 공유 예시에 포함하지 않습니다. |
audio_file | 처리가 허용된 샘플 녹음. | 파일 선택기와 제공업체가 해당 형식 및 크기를 허용하는지 확인합니다. |
language_code, language_detection | 언어를 아는 경우 검증된 언어 코드를 사용하고, 해당 테스트에서는 감지를 끕니다. | 선택한 제공업체 모드와 실제 언어 처리를 확인합니다. |
punctuate, format_text | 읽기 쉬운 전사문 초안을 위해 켭니다. | 결과 텍스트를 녹음과 비교합니다. |
speaker_labels, speakers_expected | 검토에 필요한 경우가 아니면 화자 라벨을 끕니다. | 예상 화자 필드는 문자열이며, 신원 대응표로 문서화된 것은 아닙니다. |
문서에서 전사문을 보존할지, 나중에 회의록으로 만들지 선택합니다. 전사문에서는 문장부호와 서식이 가독성을 높일 수 있지만, 쉼이나 문장 경계가 의미를 바꿀 수도 있습니다. 샘플 검토에 발화 중단과 생소한 이름이 나오는 구간을 포함합니다. 읽기 쉬운 글을 정확한 전사의 증거로 취급하지 말고, 수정의 근거로 녹음을 보존합니다.
제출 후 확인한 transcript_id를 녹음에 부여된 식별자 및 사용한 제출 설정과 연결합니다. 그러면 검토자가 같은 녹음에 대한 두 작업과 이름이 비슷한 두 녹음을 구분할 수 있습니다. 문서 단계가 실제로 성공할 때까지 저장 대상 필드는 별도로 대기 상태에 둡니다.
3. AssemblyAI Poll Transcript로 작업을 확인합니다
AssemblyAI Poll Transcript는 AssemblyAI 폴링 설정과 제한을 따릅니다.
확인한 작업 참조를 transcript_id에 제공한 뒤, 실제 결과가 해당 작업에 대해 무엇을 입증하는지 기록합니다. 관찰한 원시 결과와 계속 진행하겠다는 검토 결정을 분리합니다. 연결 오류가 발생하면 상태 확인이 완료되지 않았으므로 전사 결과는 미확인 상태입니다. 미완료 작업은 텍스트가 아직 준비되지 않았다는 뜻이며, 새 제출을 허용하는 근거가 아닙니다.
미해결 작업을 위한 검토 시점을 자체 운영 절차에 정합니다. 그 시점에 기존 작업을 확인하고, 아직 대기 중인지, 실패했는지, 검토할 텍스트가 생성되었는지 기록합니다. 결과가 어느 작업에 속하는지 확인할 수 없다면 전달을 멈추고 참조를 먼저 대조합니다. 전체 상태 응답을 전사문처럼 Google 문서에 넣지 않습니다.
관련 자료: 대화 분석 AI란 무엇인가요?.
4. 완료 결정을 명확히 합니다
이 초기 설정에서는 폴링 결과를 수동으로 검토하고, 완료 결과를 검증한 경우에만 전사 텍스트를 준비합니다. 선택한 세 컴포넌트만으로는 테스트된 자동 상태 제어가 성립하지 않습니다. 작업 식별자, 관찰 결과와 문서 단계에 사용할 텍스트의 준비 여부를 기록합니다.
미완료 결과라면 저장 대상을 대기 상태로 두고, 동작을 검증한 방법으로 상태 확인을 계속합니다. 실패 결과라면 진단을 위해 출처-작업 참조와 실패 내용을 보존합니다. 폴링에서 아직 사용 가능한 텍스트가 반환되지 않았다는 이유만으로 상태 응답을 담은 문서를 만들거나 같은 녹음을 다시 제출하지 않습니다.
연결 실패 후 작업 결과가 불확실하다면 재제출이 필요한지 결정하기 전에 기존 작업을 확인합니다. 재제출은 제공업체에서 별도 작업을 생성할 수 있습니다. 한 서비스의 실패가 다른 서비스의 작업을 자동으로 반복하지 않도록 작업 재시도와 문서 재시도를 구분합니다.
5. 저장 전에 전사문을 검토합니다
이름, 전문 용어, 숫자와 불명확한 구간에서 전사문을 녹음과 비교합니다. 녹음이 수정을 뒷받침하지 않으면 불확실성을 표시합니다. 나중에 화자 라벨을 켜더라도, 확인된 개인 신원으로 취급하지 말고 라벨 자체를 검증합니다.
문서 제목과 검토한 전사 텍스트를 명시적으로 준비합니다. AssemblyAI 결과는 JSON이고 Docs 텍스트 필드는 Message를 받으므로, 이 설계는 검증되지 않은 변환을 주장하지 않고 수동으로 텍스트를 전달합니다. 인증 정보나 비공개 녹음 URL을 노출하지 않으면서 검토 기록에 출처와 작업 참조를 보존합니다.
6. 수용된 텍스트로 Google 문서를 만듭니다
Create Document 작업 참조 문서에 따라 title에 전사문 식별용 제목을, initial_text에 검토한 텍스트를 설정합니다.
양식-Docs 생성 절차에서는 CR+LF 줄바꿈을 LF로 변환한 후 42/42가 통과했다고 보고합니다. 이 근거는 양식 입력과 Create Document에 관한 것이며, 전사 충실도나 수동 전사문 전달은 평가하지 않았습니다. 같은 절차는 파일 생성 후 별도 요청으로 텍스트를 삽입한다고 명시합니다. 삽입이 실패하면 새 파일에 텍스트가 없을 수 있습니다.
같은 제목이어도 생성을 반복하면 다른 문서가 만들어질 수 있습니다. 저장 대상의 결과가 불확실하면 재시도 전에 파일과 텍스트가 이미 존재하는지 확인합니다. 검토 기록에서 제공업체의 전사 완료 상태와 대기 중인 Google 저장 대상을 분리합니다.
7. 완료, 불확실성과 저장 대상 실패를 어떻게 검증하나요?
처리가 허용된 짧은 녹음, 미완료 작업 결과, 실패 작업과 문서 삽입 실패를 테스트합니다. 검토된 완료 전사 텍스트만 Docs에 도달하는지 확인합니다. 컴포넌트가 오류를 어떻게 표시하는지 살펴보고, 무작정 재제출하거나 다시 생성하지 않고 복구할 수 있도록 충분한 참조 정보를 보존합니다.
두 서비스를 혼동하지 않는 복구 예시를 살펴봅니다. 기존 전사 작업은 완료되었고 텍스트 검토도 끝났지만 Docs 삽입이 실패했습니다. 수용된 전사문과 작업 참조를 유지합니다. 생성된 문서가 비어 있는지, 완성되었는지, 없는지 확인한 뒤 문서 작업의 복구 방법을 결정합니다. 다른 전사 작업을 시작해도 누락된 문서 텍스트는 복구되지 않습니다. 반대로 작업이 미완료 상태라면 Docs 연결이 정상이어도 Docs는 대기 상태로 둡니다.
전사문을 나중에 수정할 때는 검토된 텍스트 판본과 저장 대상의 관계를 보존합니다. 문서 제목만으로는 원래 전사문과 수정 사본을 구분할 수 없습니다. 어떤 판본을 저장했는지 기록하고, 그 판본의 이름, 불확실한 구간과 줄바꿈을 확인합니다. 그러면 성공적인 문서 전달과 계속 확인해야 할 전사 충실도 문제를 구분할 수 있습니다.
이 전달 과정은 전사 정확성을 보장하거나 동의 여부를 결정하지 않으며, 실시간 스트리밍이나 무인 게시 단계를 포함하지 않습니다. 메시징 채널에서 녹음을 수집하는 과정도 다루지 않습니다. 취급 규칙상 녹음을 제공업체에 보낼 수 없다면 제출 전에 멈춥니다.
요금제: Go 연간 결제 시 월 USD8부터(월간 USD10), Plus 월 USD16부터(월간 USD20), Pro 100 월 USD80부터(월간 USD100), Pro 200 월 USD160부터(월간 USD200), Pro 500 월 USD400부터(월간 USD500). 매월 5,000~250,000 Flowi Tokens가 제공되며 충전도 가능합니다. 노드 실행 1회당 1토큰, 타사 API 및 모델 사용 요금은 포함되지 않습니다.
수용된 전사 텍스트에서 결정과 실행 항목을 추출하려면 검토된 회의록과 실행 기록을 참고합니다. 버전 관리는 문서 출처 감사를, 기존 시작 예시의 범위는 활용 사례를 확인합니다.