AssemblyAI(미리 보기)

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	다음을 제외한 모든 Power Automate 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
논리 앱	스탠다드	다음을 제외한 모든 Logic Apps 지역 :      - Azure Government 지역      - Azure 중국 지역      - 미국 국방부(DoD)
Power Apps	Premium	다음을 제외한 모든 Power Apps 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
Power Automate	Premium	다음을 제외한 모든 Power Automate 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)

연락처
이름	Support
URL	https://www.assemblyai.com/docs/
전자 메일	support@assemblyai.com

커넥터 메타데이터
게시자	AssemblyAI
웹 사이트	https://www.assemblyai.com
개인 정보 보호 정책	https://www.assemblyai.com/legal/privacy-policy
카테고리	AI

AssemblyAI 커넥터를 사용하면 AssemblyAI 모델을 사용하여 음성 인식 모델로 전사하고, 오디오 인텔리전스 모델로 분석하고, LLM을 사용하여 생성 기능을 빌드하여 오디오 데이터를 처리할 수 있습니다.

• 화자 다이어리화, 사용자 지정 맞춤법, 사용자 지정 어휘 등과 같은 구성 가능한 많은 기능을 포함하는 음성 텍스트 변환
• 오디오 인텔리전스 모델은 전사 구성을 통해 사용 가능하고 구성된 추가 AI 모델입니다.
• LeMUR 를 사용하면 매우 큰 대본을 위해 고유한 RAG 인프라를 빌드할 필요 없이 다양한 LLM 모델을 대본에 적용할 수 있습니다.

필수 조건

계속하려면 다음이 필요합니다.

• AssemblyAI API 키(무료로 가져오기)

자격 증명을 가져오는 방법

계정에 등록하고 대시보드에서 API 키를 복사하여 AssemblyAI API 키를 무료로 가져올 수 있습니다.

커넥터 시작

다음 단계에 따라 AssemblyAI 커넥터를 사용하여 오디오를 전사합니다.

파일 업로드

AssemblyAI를 사용하여 오디오 파일을 전사하려면 AssemblyAI에서 파일에 액세스할 수 있어야 합니다. 오디오 파일이 URL을 통해 이미 액세스할 수 있는 경우 기존 URL을 사용할 수 있습니다.

그렇지 않으면 작업을 사용하여 Upload a File AssemblyAI에 파일을 업로드할 수 있습니다. API 키를 사용하여 전사하는 데만 사용할 수 있는 파일의 URL을 다시 가져옵니다. 파일을 전사하면 파일이 AssemblyAI의 서버에서 제거됩니다.

오디오 전사

오디오를 전사하려면 오디오 파일 URL을 Audio URL 사용하여 매개 변수를 구성합니다. 그런 다음 더 많은 음성 인식 기능 및 오디오 인텔리전스 모델을 사용하도록 추가 매개 변수를 구성합니다.

오디오 전사 작업의 결과는 즉시 처리되기 시작하는 대기 중인 대본입니다. 완료된 대본을 얻으려면 다음 두 가지 옵션이 있습니다.

1. 대본 준비 웹후크 처리
2. 성적 증명서 상태 폴링

대본 준비 웹후크 처리

Logic Apps 또는 Power Automate를 사용하여 웹후크를 처리하지 않으려면 작업에서 Transcribe Audio 매개 변수를 구성 Webhook URL 하고 AssemblyAI의 웹후크 설명서에 따라 웹후크를 구현합니다.

Logic Apps 또는 Power Automate를 사용하여 웹후크를 처리하려면 다음 단계를 수행합니다.

1. 별도의 논리 앱 또는 Power Automate Flow 만들기

2. 트리거로 구성 When an HTTP request is received :

   • Who Can Trigger The Flow?를 Anyone로 설정
   • 다음으로 설정합니다 Request Body JSON Schema .

     {
       "type": "object",
       "properties": {
         "transcript_id": {
           "type": "string"
         },
         "status": {
           "type": "string"
         }
       }
     }
     

   • Method를 POST로 설정

3. 트리거 Transcript ID 에서 매개 변수로 전달하는 transcript_id AssemblyAI Get Transcript 작업을 추가합니다.

4. 다른 작업을 수행하기 전에 is completed 또는 Statuserror. 출력의 Condition 내용이 다음과 같은지 StatusGet Transcript 확인하는 작업을 추가합니다 error.

   • 분기에서 True 작업 추가 Terminate
     • 다음으로 Status 설정 Failed
     • 다음으로 Code 설정 Transcript Error
     • 출력에서 ErrorGet Transcript 매개 변수로 전달합니다 Message .
   • 분기를 비워 둘 False 수 있습니다.

   이제 기록 상태가 확인되면 completed작업을 Condition 추가할 수 있으며 작업의 출력 속성을 Get Transcript 검색할 수 있습니다.

5. 논리 앱 또는 흐름을 저장합니다. HTTP URL 트리거에 대해 When an HTTP request is received 생성됩니다. 복사한 후 HTTP URL 원래 논리 앱 또는 흐름으로 돌아갑니다.

6. 원래 논리 앱 또는 흐름에서 작업을 업데이트합니다 Transcribe Audio . 이전에 복사한 HTTP URL 매개 변수를 매개 변수에 Webhook URL 붙여넣고 저장합니다.

성적 증명서 상태가 되거나 completederror, AssemblyAI가 웹후크 URL에 HTTP POST 요청을 보내면 다른 논리 앱 또는 흐름에서 처리됩니다.

웹후크를 사용하는 대신 다음 섹션에서 설명한 대로 성적 증명서 상태를 폴링할 수 있습니다.

성적 증명서 상태 폴링

다음 단계를 사용하여 성적 증명서 상태를 폴링할 수 있습니다.

• Initialize variable 작업 추가

  • Name를 transcript_status로 설정
  • Type를 String로 설정
  • 출력의 StatusTranscribe Audio 매개 변수에 Value 저장

• Do until 작업 추가

  • Loop Until 다음 Fx 코드를 사용하여 매개 변수를 구성합니다.

    or(equals(variables('transcript_status'), 'completed'), equals(variables('transcript_status'), 'error'))
    

    이 코드는 completederror변수가 있는지 여부를 transcript_status 확인합니다.
  • 매개 변수를 다음으로 구성합니다.Count86400
  • 매개 변수를 다음으로 구성합니다.TimeoutPT24H

  Do until 작업 내에 다음 작업을 추가합니다.

  • 1 Delay 초 동안 대기하는 작업 추가
  • Get Transcript 작업을 추가하고 출력에서 IDTranscribe Audio 매개 변수로 Transcript ID 전달합니다.
  • Set variable 작업 추가
    • Name를 transcript_status로 설정
    • 출력을 StatusGet Transcript 매개 변수에 전달합니다 Value .

  스크립트가 Do until 완료되거나 오류가 발생할 때까지 루프가 계속됩니다.

• 이전과 같이 다른 Get Transcript 작업을 추가하지만 루프 후에 Do until 추가하면 해당 출력이 작업 범위 Do until 밖에서 사용할 수 있게 됩니다.

다른 작업을 수행하기 전에 대본 Statuscompletederror이 있는지 여부를 확인해야 합니다. 다음이 Condition 있는지 transcript_status 확인하는 작업을 추가합니다.error

• 분기에서 True 작업 추가 Terminate
  • Status를 Failed로 설정
  • Code를 Transcript Error로 설정
  • 출력에서 ErrorGet Transcript 매개 변수로 전달합니다 Message .
• 분기를 비워 둘 False 수 있습니다.

이제 기록 상태가 확인되면 completed작업을 Condition 추가할 수 있으며 작업의 출력 속성을 Get Transcript 검색할 수 있습니다.

더 많은 작업 추가

이제 전사가 완료되었으므로 다음과 같이 대본을 전달하는 ID 다른 많은 작업을 사용할 수 있습니다.

• Get Sentences of Transcript
• Get Paragraphs of Transcript
• Get Subtitles of Transcript
• Get Redacted Audio
• Search Transcript for Words
• Run a Task using LeMUR

알려진 문제 및 제한 사항

현재 알려진 문제가 없습니다. 사용자 지정 커넥터를 사용할 수 없으므로 스트리밍 음성To-Text(실시간)는 지원하지 않습니다.

일반적인 오류 및 해결

AssemblyAI 설명서에서 오류에 대한 자세한 정보를 찾을 수 있습니다.

자주 묻는 질문(FAQ)

설명서에서 자주 묻는 질문을 찾을 수 있습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값	연결을 만들기 위한 매개 변수입니다.	모든 지역	공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름	유형	Description	필수
AssemblyAI API 키	시큐어스트링 (보안 문자열)	AssemblyAI API를 인증하는 AssemblyAI API 키입니다.	진실

제한 한도

Name	호출	갱신 기간
연결당 API 호출	100	60초

동작

LeMUR 요청 데이터 제거	이전에 제출된 LeMUR 요청에 대한 데이터를 삭제합니다. LLM 응답 데이터와 원래 요청에 제공된 모든 컨텍스트가 제거됩니다.
LeMUR 응답 검색	이전에 생성된 LeMUR 응답을 검색합니다.
LeMUR를 사용하여 작업 실행	LeMUR 작업 엔드포인트를 사용하여 사용자 고유의 LLM 프롬프트를 입력합니다.
대본 가져오기	기록 리소스를 가져옵니다. "상태"가 "완료"되면 대본이 준비됩니다.
대본 삭제	대본을 삭제합니다. 삭제는 리소스 자체를 삭제하지 않지만 리소스에서 데이터를 제거하고 삭제된 것으로 표시합니다.
대본에 대한 자막 가져오기	자막 및 선택 자막에 비디오 플레이어와 함께 사용할 수 있도록 SRT 또는 VTT 형식으로 대본을 내보냅니다.
대본에서 단락 가져오기	단락으로 분할된 대본을 가져옵니다. API는 더 읽기 쉬운 대본을 만들기 위해 대본을 단락으로 의미적으로 분할하려고 시도합니다.
대본에서 단어 검색	대본에서 키워드를 검색합니다. 최대 5개의 단어 또는 숫자를 포함하는 개별 단어, 숫자 또는 구를 검색할 수 있습니다.
대본에서 문장 가져오기	문장으로 분할된 대본을 가져옵니다. API는 더 읽기 쉬운 대본을 만들기 위해 대본을 문장으로 의미적으로 분할하려고 시도합니다.
미디어 파일 업로드	AssemblyAI의 서버에 미디어 파일을 업로드합니다.
성적 증명서 나열	만든 대본 목록을 검색합니다. 대본은 최신에서 가장 오래된 내용으로 정렬됩니다. 이전 URL은 항상 이전 대본이 있는 페이지를 가리킵니다.
오디오 전사	URL을 통해 액세스할 수 있는 미디어 파일에서 대본을 만듭니다.
편집된 오디오 가져오기	수정된 오디오에 대한 상태 및 URL이 포함된 수정된 오디오 개체를 검색합니다.

LeMUR 요청 데이터 제거

LeMUR 응답 검색

LeMUR를 사용하여 작업 실행

대본 가져오기

대본 삭제

대본에 대한 자막 가져오기

대본에서 단락 가져오기

대본에서 단어 검색

대본에서 문장 가져오기

미디어 파일 업로드

성적 증명서 나열

오디오 전사

편집된 오디오 가져오기

정의

RedactedAudioResponse

WordSearchResponse

대본

SentencesResponse

ParagraphsResponse

TranscriptList

UploadedFile

PurgeLemurRequestDataResponse

LemurTaskResponse

LemurResponse

문자열