Azure AI Content Understanding(미리 보기)

Azure AI Content Understanding은 AI 기반 분석을 사용하여 문서, 이미지, 오디오 및 비디오를 비롯한 멀티모달 입력에서 콘텐츠와 필드를 추출합니다.

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

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

Contact
Name	Microsoft
URL	https://aka.ms/content-understanding
전자 메일	contentunderstanding@microsoft.com

커넥터 메타데이터
Publisher	Microsoft
웹 사이트	https://aka.ms/content-understanding
개인 정보 보호 정책	https://privacy.microsoft.com
카테고리	AI

연결을 만드는 중

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

API 키	Content Understanding 리소스 이름 및 API 키를 제공합니다.	모든 지역	공유 가능
Logic Apps 앱 관리 ID	LogicApps 관리 ID를 사용하여 연결 만들기	LOGICAPPS만	공유 가능
Microsoft Entra ID 통합	Microsoft Entra ID를 사용하여 액세스	모든 지역	공유할 수 없음
기본값 [사용되지 않음]	이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.	모든 지역	공유할 수 없음

API 키

인증 ID: keyBasedAuth

적용 가능: 모든 지역

Content Understanding 리소스 이름 및 API 키를 제공합니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

Name	Type	Description	필수
API 키	시큐어스트링 (보안 문자열)	Content Understanding API 키	True
엔드포인트 URL	string	Content Understanding 엔드포인트 URL(예: https://your-resource.cognitiveservices.azure.com/)	True

Logic Apps 관리 ID

인증 ID: managedIdentityAuth

적용 가능: LOGICAPPS만 해당

LogicApps 관리 ID를 사용하여 연결 만들기

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

Name	Type	Description	필수
LogicApps 관리 ID	managedIdentity	Logic Apps 관리 ID로 로그인	True
엔드포인트 URL	string	Content Understanding 엔드포인트 URL(예: https://your-resource.cognitiveservices.azure.com/)	True

통합된 Microsoft Entra ID

인증 ID: oauth

적용 가능: 모든 지역

Microsoft Entra ID를 사용하여 액세스

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

Name	Type	Description	필수
엔드포인트 URL	string	Content Understanding 엔드포인트 URL(예: https://your-resource.cognitiveservices.azure.com/)	True

기본값 [사용되지 않음]

적용 가능: 모든 지역

이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.

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

Name	Type	Description	필수
API 키	시큐어스트링 (보안 문자열)	Content Understanding API 키	True
엔드포인트 URL	string	Content Understanding 엔드포인트 URL(예: https://your-resource.cognitiveservices.azure.com/)	True

제한 한도

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

actions

콘텐츠 분석

분석기를 사용하여 다중 모드 입력(문서, 이미지, 오디오, 비디오)에서 콘텐츠 및 필드를 추출합니다. 작업은 비동기적으로 실행되고 완료되면 결과를 반환합니다.

콘텐츠 분석

작업 ID:

AnalyzeContent

분석기를 사용하여 다중 모드 입력(문서, 이미지, 오디오, 비디오)에서 콘텐츠 및 필드를 추출합니다. 작업은 비동기적으로 실행되고 완료되면 결과를 반환합니다.

매개 변수

Name	키	필수	형식	Description
분석기 ID	analyzerId	True	string	분석에 사용할 분석기의 고유 식별자입니다.
File Content(파일 내용)	inputFileContent		byte	분석할 파일 콘텐츠(문서, 이미지, 오디오 또는 비디오)입니다. Base64로 인코딩되었습니다. 또는 Input File URL.와 함께 inputs 사용할 수 없습니다.
입력 파일 URL	inputFileUrl		string	분석할 파일의 URL입니다. 또는 File Content.와 함께 inputs 사용할 수 없습니다.
범위	range		string	분석할 페이지 범위(예: 1-3,5,9-). 사용하거나 Input File URL.를 사용할 File Content 때만 적용됩니다. 설정하지 않으면 모든 페이지가 처리됩니다.
파일 MIME 형식	inputFileMimeType		string	파일 콘텐츠의 MIME 형식(예: application/pdf, image/jpeg)입니다. 를 사용하는 File Content경우 선택 사항입니다.
url	url		string	분석할 입력의 URL입니다. URL 또는 데이터 중 하나만 지정하면 됩니다.
data	data		byte	분석할 입력의 Base64 인코딩 이진 내용. URL 또는 데이터 중 하나만 지정하면 됩니다.
name	name		string	입력 이름.
MIME 형식	mimeType		string	입력 콘텐츠의 MIME 형식입니다. 예: application/pdf, image/jpeg 등
범위	range		string	분석할 입력 범위입니다(예: 1-3,5,9-). 문서 콘텐츠는 1부터 시작하는 페이지 번호를 사용합니다.
처리 위치	processingLocation		string	데이터가 처리될 수 있는 장소입니다. 기본값은 전역으로 설정됩니다.
문자열 인코딩	stringEncoding		string	응답 범위에 대한 문자열 인코딩 형식은 응답 구간에서 사용됩니다. 가능한 값은 'codePoint', 'utf16', 그리고 utf8.

반품

분석 작업의 상태 및 결과입니다.

몸

AnalyzeOperationResult

정의

OperationState

작업의 상태입니다.

작업의 상태입니다.

string

AnalysisContent

분석에서 추출된 콘텐츠입니다.

Name	경로	형식	Description
kind	kind	string	만족스러운 종류.
markdown	markdown	string	콘텐츠의 마크다운 표현.
fields	fields	object	콘텐츠에서 필드를 추출했습니다.
카테고리	category	string	분류 콘텐츠 카테고리.
analyzerId	analyzerId	string	이 콘텐츠를 생성한 분석기입니다.
마임 타입	mimeType	string	콘텐츠의 MIME 형식입니다.
path	path	string	입력 내 콘텐츠의 경로.

AnalysisResult

작업 결과를 분석합니다.

Name	경로	형식	Description
analyzerId	analyzerId	string	분석기의 고유 식별자입니다.
API버전	apiVersion	string	문서 분석에 사용된 API 버전입니다.
createdAt	createdAt	date-time	결과가 생성된 날짜와 시간.
경고	warnings	array of object	문서 분석 중 발견된 경고들.
code	warnings.code	string
message	warnings.message	string
Markdown 콘텐츠	_markdown	string	빠른 액세스를 위해 첫 번째 콘텐츠 항목의 Markdown 표현입니다.
contents	contents	array of AnalysisContent	추출된 내용.

AnalyzeOperationResult

분석 작업의 상태 및 결과입니다.

Name	경로	형식	Description
id	id	string	작업의 고유 ID입니다.
상태	status	OperationState	작업의 상태입니다.
code	error.code	string	오류 코드입니다.
message	error.message	string	오류 메시지입니다.
result	result	AnalysisResult	작업 결과를 분석합니다.