Microsoft Cognitive 작업

Azure Cognitive Services를 사용하면 기계 학습 전문 지식 없이도 인공 지능을 사용하여 의사 결정을 가속화할 수 있습니다.

중요

Azure는 2024년 2월 29일에 Azure Cognitive Services Text Analytics v2.x를 사용 중지합니다. 이 라이브러리는 Microsoft Cognitive Text Analytics 작업에서 사용됩니다. 2024년 2월 29일 이후에는 해당 작업이 더 이상 데스크톱 흐름에서 지원되지 않으며 작동하지 않습니다.

데스크톱 흐름은 이 기능을 데스크톱 흐름에 통합할 수 있는 다양한 Microsoft 인지 작업을 제공합니다. 텍스트 분석, 컴퓨터 비전 및 맞춤법 검사는 모두 Microsoft Cognitive 작업에서 수행할 수 있는 작업입니다.

모든 Microsoft Cognitive 작업에는 서비스 또는 서비스 그룹에 대한 구독의 유효성을 검사하는 구독 키가 필요합니다. 키는 만든 각 리소스에 대해 Azure Portal에서 사용할 수 있습니다.

맞춤법 검사

'Bing Spell Check'이라는 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Subscription key	아니요	텍스트 값		이 API 호출에 사용할 구독 키
Text	아니요	텍스트 값목록		전송할 텍스트 또는 텍스트 목록
Mode	예	텍스트 값		맞춤법 검사 모드 지정
MKT	예	텍스트 값		교정 모드에는 en-us, es-es, pt-br 언어 코드만 지원됩니다. 맞춤법 모드의 경우 모든 언어 코드가 지원됩니다.
Timeout	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄

이미지 분석

이름이 '이미지 분석'인 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
서버 위치	해당 없음	미국 서부, 미국 서부 2, 미국 동부, 미국 동부 2, 미국 중서부, 미국 중남부, 서유럽, 북유럽, 동남 아시아, 동아시아, 오스트레일리아 동부, 브라질 남부, 캐나다 중부, 인도 중부, 영국 남부, 일본 동부	미국 서부	이 API 호출에 사용할 서버 위치
구독 키	아니요	텍스트 값		이 API 호출에 사용할 구독 키
Provide image	해당 없음	파일에서, GCS에서	파일에서	이미지를 전체 경로로 제공할지 URL 주소로 제공할지 지정
Image file	아니요	파일		전송할 이미지 파일의 전체 경로(폴더와 파일 이름)
Image URL	아니요	텍스트 값		이미지의 URL 주소
Visual features	예	텍스트 값		반환할 시각적 기능 유형을 나타내는 텍스트 값입니다. 여러 값은 쉼표로 구분해야 합니다. 예: 범주, 태그, 설명
Details	예	텍스트 값		반환할 도메인별 세부 정보를 나타내는 텍스트 값입니다. 여러 값은 쉼표로 구분해야 합니다
Language	예	텍스트 값		반환할 언어를 나타내는 텍스트 값입니다. 서비스는 지정된 언어로 인식 결과를 반환함
Timeout	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄

이미지 설명

'이미지 설명'이라는 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
서버 위치	해당 없음	미국 서부, 미국 서부 2, 미국 동부, 미국 동부 2, 미국 중서부, 미국 중남부, 서유럽, 북유럽, 동남 아시아, 동아시아, 오스트레일리아 동부, 브라질 남부, 캐나다 중부, 인도 중부, 영국 남부, 일본 동부	미국 서부	이 API 호출에 사용할 서버 위치
구독 키	아니요	텍스트 값		이 API 호출에 사용할 구독 키
Provide image	해당 없음	파일에서, GCS에서	파일에서	이미지를 전체 경로로 제공할지 URL 주소로 제공할지 지정
Image file	아니요	파일		전송할 이미지 파일의 전체 경로(폴더와 파일 이름)
Image URL	아니요	텍스트 값		이미지의 URL 주소
Max candidates	예	텍스트 값		반환될 후보 설명의 최대 수입니다. 기본값은 1입니다.
Timeout	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄

OCR

'OCR'이라는 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
서버 위치	해당 없음	미국 서부, 미국 서부 2, 미국 동부, 미국 동부 2, 미국 중서부, 미국 중남부, 서유럽, 북유럽, 동남 아시아, 동아시아, 오스트레일리아 동부, 브라질 남부, 캐나다 중부, 인도 중부, 영국 남부, 일본 동부	미국 서부	이 API 호출에 사용할 서버 위치
구독 키	아니요	텍스트 값		이 API 호출에 사용할 구독 키
Provide image	해당 없음	파일에서, GCS에서	파일에서	이미지를 전체 경로로 제공할지 URL 주소로 제공할지 지정
Image file	아니요	파일		전송할 이미지 파일의 전체 경로(폴더와 파일 이름)
Image URL	아니요	텍스트 값		이미지의 URL 주소
Language	예	텍스트 값		이미지에서 감지할 텍스트의 BCP-47 언어 코드
Detect orientation	예	텍스트 값		이미지에서 텍스트 방향을 감지할지 여부 지정
Timeout	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄

이미지 태그

'이미지 태깅'이라는 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
서버 위치	해당 없음	미국 서부, 미국 서부 2, 미국 동부, 미국 동부 2, 미국 중서부, 미국 중남부, 서유럽, 북유럽, 동남 아시아, 동아시아, 오스트레일리아 동부, 브라질 남부, 캐나다 중부, 인도 중부, 영국 남부, 일본 동부	미국 서부	이 API 호출에 사용할 서버 위치
구독 키	아니요	텍스트 값		이 API 호출에 사용할 구독 키
Provide image	해당 없음	파일에서, GCS에서	파일에서	이미지를 전체 경로로 제공할지 URL 주소로 제공할지 지정
Image file	아니요	파일		전송할 이미지 파일의 전체 경로(폴더와 파일 이름)
Image URL	아니요	텍스트 값		이미지의 URL 주소
Timeout	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄

언어 감지

'텍스트 분석 - 언어 감지'라는 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
서버 위치	해당 없음	미국 서부, 미국 서부 2, 미국 동부, 미국 동부 2, 미국 중서부, 미국 중남부, 서유럽, 북유럽, 동남 아시아, 동아시아, 오스트레일리아 동부, 브라질 남부, 캐나다 중부, 인도 중부, 영국 남부, 일본 동부	미국 서부	이 API 호출에 사용할 서버 위치
구독 키	아니요	텍스트 값		이 API 호출에 사용할 구독 키
Text	아니요	텍스트 값		분석할 텍스트
Timeout	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄

핵심 구

'텍스트 분석 - 핵심 구'라는 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
서버 위치	해당 없음	미국 서부, 미국 서부 2, 미국 동부, 미국 동부 2, 미국 중서부, 미국 중남부, 서유럽, 북유럽, 동남 아시아, 동아시아, 오스트레일리아 동부, 브라질 남부, 캐나다 중부, 인도 중부, 영국 남부, 일본 동부	미국 서부	이 API 호출에 사용할 서버 위치
구독 키	아니요	텍스트 값		이 API 호출에 사용할 구독 키
Text	아니요	텍스트 값목록		분석할 텍스트 또는 텍스트 목록
Language	예	텍스트 값		텍스트의 언어
Timeout	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄

관심도

'텍스트 분석 - 감정'이라는 Microsoft Cognitive 서비스를 호출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
서버 위치	해당 없음	미국 서부, 미국 서부 2, 미국 동부, 미국 동부 2, 미국 중서부, 미국 중남부, 서유럽, 북유럽, 동남 아시아, 동아시아, 오스트레일리아 동부, 브라질 남부, 캐나다 중부, 인도 중부, 영국 남부, 일본 동부	미국 서부	이 API 호출에 사용할 서버 위치
구독 키	아니요	텍스트 값		이 API 호출에 사용할 구독 키
문자	아니요	텍스트 값목록		문자
언어	네	텍스트 값		텍스트의 언어를 2자로 된 ISO 639-1 코드로 표현
시간 제한	예	숫자 값	30	서버와의 연결이 설정되는 동안(실패하기 전까지) 에이전트가 대기해야 하는 시간(초)

변수 생성됨

인수	Type	Description
JSONResponse	사용자 지정 개체	API 응답 결과
StatusCode	숫자 값	반환된 상태 코드

예외

예외	설명
요청 시간이 초과됨	요청을 수행하는 중 시간 제한이 만료되었음을 나타냄
Cognitive Services를 호출하지 못함	Cognitive Services를 호출하는 중 문제가 발생했음을 나타냄