Azure AI Search(미리 보기)
Azure AI Search는 기존 및 생성 AI 검색 애플리케이션에서 사용자 소유 콘텐츠에 대해 대규모로 보안 정보 검색을 제공합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL | https://support.microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://learn.microsoft.com/en-us/azure/search/search-what-is-azure-search/ |
| 카테고리 | AI; 비즈니스 인텔리전스 |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/en-us/privacystatement |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 액세스 키 | Azure AI Search에 액세스하기 위한 연결 문자열을 제공합니다. | 모든 지역 | 공유할 수 없음 |
| 클라이언트 인증서 인증 | PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공 | 모든 지역 | 공유 가능 |
| Logic Apps 앱 관리 ID | LogicApps 관리 ID를 사용하여 연결 만들기 | LOGICAPPS만 | 공유 가능 |
| Microsoft Entra ID 통합 | Microsoft Entra ID를 사용하여 액세스 | 모든 지역 | 공유할 수 없음 |
| 서비스 주체(Microsoft Entra ID 애플리케이션) | Microsoft Entra ID 애플리케이션을 사용하여 Azure AI Search에 액세스합니다. | 모든 지역 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
액세스 키
인증 ID: adminkey
적용 가능: 모든 지역
Azure AI Search에 액세스하기 위한 연결 문자열을 제공합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Azure AI Search 엔드포인트 URL | 문자열 | 연결할 Azure AI Search 엔드포인트 | 진실 |
| Azure AI Search 관리자 키 | 시큐어스트링 (보안 문자열) | Azure AI Search를 사용하여 연결하는 관리 키 | 진실 |
클라이언트 인증서 인증
인증 ID: certOauth
적용 가능: 모든 지역
PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Azure AI Search 엔드포인트 URL | 문자열 | Azure AI Search 네임스페이스 엔드포인트 제공(예: ai://testai.search.windows.net/) | 진실 |
| 임차인 | 문자열 | 진실 | |
| 클라이언트 ID | 문자열 | Microsoft Entra ID 애플리케이션의 클라이언트 ID | |
| 클라이언트 인증서 비밀 | 클라이언트 인증서 | 이 애플리케이션에서 허용하는 클라이언트 인증서 비밀 | 진실 |
Logic Apps 관리 ID
인증 ID: managedIdentityAuth
적용 가능: LOGICAPPS만 해당
LogicApps 관리 ID를 사용하여 연결 만들기
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| LogicApps 관리 ID | 관리되는 ID | Logic Apps 관리 ID로 로그인 | 진실 |
| Azure AI Search 엔드포인트 URL | 문자열 | Azure AI Search 네임스페이스 엔드포인트 제공(예: ai://testai.search.windows.net/) | 진실 |
Microsoft Entra ID 통합
인증 ID: oauth
적용 가능: 모든 지역
Microsoft Entra ID를 사용하여 액세스
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Azure AI Search 엔드포인트 URL | 문자열 | Azure AI Search 네임스페이스 엔드포인트 제공(예: ai://testai.search.windows.net/) | 진실 |
서비스 주체(Microsoft Entra ID 애플리케이션)
인증 ID: oauthSP
적용 가능: 모든 지역
Microsoft Entra ID 애플리케이션을 사용하여 Azure AI Search에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Azure AI Search 엔드포인트 URL | 문자열 | Azure AI Search 네임스페이스 엔드포인트 제공(예: ai://testai.search.windows.net/) | 진실 |
| 임차인 | 문자열 | 진실 | |
| 클라이언트 ID | 문자열 | 진실 | |
| 클라이언트 암호 | 시큐어스트링 (보안 문자열) | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Azure AI Search 엔드포인트 URL | 문자열 | 연결할 Azure AI Search 엔드포인트 | 진실 |
| Azure AI Search 관리자 키 | 시큐어스트링 (보안 문자열) | Azure AI Search를 사용하여 연결하는 관리 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 200 | 60초 |
동작
| 검색 벡터(미리 보기) |
필터가 있는 단일 벡터 검색입니다. |
| 검색 인덱스 가져오기 |
이 작업은 Azure AI Search의 필드 세부 정보가 포함된 모든 인덱스 스키마를 가져옵니다. |
| 문서 병합(미리 보기) |
단일 문서를 병합합니다. |
| 문서 삭제(미리 보기) |
단일 문서를 삭제합니다. |
| 문서 인덱싱(미리 보기) |
단일 문서를 인덱싱합니다. |
| 여러 문서 삭제(미리 보기) |
지정한 문서를 삭제합니다. |
| 여러 문서 인덱싱(미리 보기) |
지정한 문서를 인덱싱합니다. |
| 의미 체계 하이브리드 검색(미리 보기) |
필터를 사용하는 의미 체계 하이브리드 검색입니다. |
| 인덱스 통계 가져오기 |
이 작업은 Azure AI Search의 인덱스에 대한 통계를 가져옵니다. |
| 자연어를 사용하여 벡터 검색(미리 보기) |
자연어를 사용하여 벡터를 검색합니다. |
검색 벡터(미리 보기)
필터가 있는 단일 벡터 검색입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
|
벡터 필드 및 값 검색 벡터 필드 이름
|
vectorFieldsName | True | string |
검색 벡터 필드 이름입니다. |
|
vectorFieldsValue
|
vectorFieldsValue | True | array of float | |
|
반환할 가장 가까운 인접 항목 수
|
nearestNeighbors | True | integer |
반환할 가장 가까운 인접 항목의 수입니다. |
|
Search
|
searchQuery | string |
쿼리 조건 검색 |
|
|
검색 모드
|
searchMode | string |
검색 모드 |
|
|
필터 조건
|
filterCondition | string |
가장 가까운 인접 항목을 찾기 전에 적용할 필터링 조건입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
array of string |
검색 인덱스 가져오기
이 작업은 Azure AI Search의 필드 세부 정보가 포함된 모든 인덱스 스키마를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
통합 벡터를 사용하는 인덱스만
|
onlyIntegratedVectorIndexes | boolean |
true이면 통합 벡터가 있는 인덱스만 반환됩니다. |
반환
- response
- array of Object
문서 병합(미리 보기)
단일 문서를 병합합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
문서 삭제(미리 보기)
단일 문서를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
문서 인덱싱(미리 보기)
단일 문서를 인덱싱합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
반환
- response
- object
여러 문서 삭제(미리 보기)
지정한 문서를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
여러 문서 인덱싱(미리 보기)
지정한 문서를 인덱싱합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
반환
- response
- object
의미 체계 하이브리드 검색(미리 보기)
필터를 사용하는 의미 체계 하이브리드 검색입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
|
텍스트 검색
|
searchText | string |
텍스트 검색 |
|
|
벡터화된 검색 필드
|
vectorizedSearchFields | array of string |
벡터화된 검색 필드 |
|
|
의미 체계 구성
|
semanticConfiguration | string |
의미 체계 구성 |
|
|
필드 선택
|
selectFields | array of string |
필드 선택 |
|
|
필터 조건
|
filterCondition | string |
필터 조건 |
|
|
세션 아이디
|
sessionId | string |
세션 아이디 |
|
|
가장 가까운 이웃
|
nearestNeighbors | integer |
가장 가까운 이웃 |
|
|
상위 검색
|
top | integer |
상위 검색 |
|
|
검색 건너뛰기
|
skipSearches | integer |
검색 건너뛰기 |
반환
- response
- array of Object
인덱스 통계 가져오기
이 작업은 Azure AI Search의 인덱스에 대한 통계를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
반환
- response
- object
자연어를 사용하여 벡터 검색(미리 보기)
자연어를 사용하여 벡터를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인덱스 이름
|
indexName | True | string |
인덱스 이름입니다. |
|
텍스트 검색
|
searchText | string |
텍스트 검색 |
|
|
벡터화된 검색 필드
|
vectorizedSearchFields | array of string |
벡터화된 검색 필드 |
|
|
필드 선택
|
selectFields | array of string |
필드 선택 |
|
|
필터 조건
|
filterCondition | string |
필터 조건 |
|
|
세션 아이디
|
sessionId | string |
세션 아이디 |
|
|
가장 가까운 이웃
|
nearestNeighbors | integer |
가장 가까운 이웃 |
|
|
상위 검색
|
top | integer |
상위 검색 |
|
|
검색 건너뛰기
|
skipSearches | integer |
검색 건너뛰기 |
반환
- response
- array of Object
정의
Object
객체
'object' 형식입니다.