Knowledge Sources - Create Or Update

새 지식 소스를 만들거나 지식 소스가 이미 있는 경우 업데이트합니다.

PUT {endpoint}/knowledgesources('{sourceName}')?api-version=2026-11-01-preview

URI 매개 변수

속성 In(다음 안에) 필수 형식 Description
endpoint
path True

string (uri)

검색 서비스의 엔드포인트 URL입니다.

sourceName
path True

string

참조 자료의 이름입니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 헤더

속성 필수 형식 Description
x-ms-client-request-id

string (uuid)

요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.

Accept

Accept

Accept 헤더입니다.

If-Match

string

If-Match 조건을 정의합니다. 서버의 ETag가 이 값과 일치하는 경우에만 작업이 수행됩니다.

If-None-Match

string

If-None-Match 조건을 정의합니다. 서버의 ETag가 이 값과 일치하지 않는 경우에만 작업이 수행됩니다.

Prefer True

Prefer

HTTP PUT 요청의 경우 성공 시 생성/업데이트된 리소스를 반환하도록 서비스에 지시합니다.

요청 본문

요청 본문은 다음 중 하나가 될 수 있습니다.

속성 Description
AzureBlobKnowledgeSource

Azure Blob Storage 지식 원본에 대한 구성입니다.

FabricDataAgentKnowledgeSource

Fabric Data Agent 지식 소스 구성

FabricOntologyKnowledgeSource

Fabric Ontology 구성 지식 출처.

FileKnowledgeSource

직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정.

IndexedOneLakeKnowledgeSource

OneLake 기술 자료에 대한 구성입니다.

IndexedSharePointKnowledgeSource

SharePoint 기술 자료에 대한 구성입니다.

IndexedSqlKnowledgeSource

인덱스화된 SQL 지식 소스 설정.

McpServerKnowledgeSource

MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성.

RemoteSharePointKnowledgeSource

원격 SharePoint 지식 원본에 대한 구성입니다.

SearchIndexKnowledgeSource

검색 인덱스를 대상으로 하는 지식 소스입니다.

WebKnowledgeSource

웹 결과를 타겟팅하는 지식 소스.

WorkIQKnowledgeSource

WorkIQ 지식 소스 설정.

AzureBlobKnowledgeSource

Azure Blob Storage 지식 원본에 대한 구성입니다.

속성 필수 형식 Description
azureBlobParameters True

AzureBlobKnowledgeSourceParameters

지식 소스의 유형입니다.

kind True string:

azureBlob

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

FabricDataAgentKnowledgeSource

Fabric Data Agent 지식 소스 구성

속성 필수 형식 Description
fabricDataAgentParameters True

FabricDataAgentKnowledgeSourceParameters

Fabric Data Agent 지식 소스의 매개변수.

kind True string:

fabricDataAgent

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

FabricOntologyKnowledgeSource

Fabric Ontology 구성 지식 출처.

속성 필수 형식 Description
fabricOntologyParameters True

FabricOntologyKnowledgeSourceParameters

Fabric 온톨로지 지식 소스의 매개변수입니다.

kind True string:

fabricOntology

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

FileKnowledgeSource

직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정.

속성 필수 형식 Description
fileParameters True

FileKnowledgeSourceParameters

파일 지식 소스의 매개변수.

kind True string:

file

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

corsOptions

CorsOptions

파일 지식 소스의 파일 엔드포인트(업로드, 목록, 업데이트, 삭제)에 대한 교차 출처 자원 공유(CORS) 제어 옵션.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

IndexedOneLakeKnowledgeSource

OneLake 기술 자료에 대한 구성입니다.

속성 필수 형식 Description
indexedOneLakeParameters True

IndexedOneLakeKnowledgeSourceParameters

지식 소스에 대한 매개변수입니다.

kind True string:

indexedOneLake

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

IndexedSharePointKnowledgeSource

SharePoint 기술 자료에 대한 구성입니다.

속성 필수 형식 Description
indexedSharePointParameters True

IndexedSharePointKnowledgeSourceParameters

지식 소스에 대한 매개변수입니다.

kind True string:

indexedSharePoint

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

IndexedSqlKnowledgeSource

인덱스화된 SQL 지식 소스 설정.

속성 필수 형식 Description
indexedSqlParameters True

IndexedSqlKnowledgeSourceParameters

SQL 지식 소스의 매개변수입니다.

kind True string:

indexedSql

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

McpServerKnowledgeSource

MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성.

속성 필수 형식 Description
kind True string:

mcpServer

지식 소스의 유형입니다.

mcpServerParameters True

McpServerKnowledgeSourceParameters

MCP 서버 지식 소스의 매개변수.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

RemoteSharePointKnowledgeSource

원격 SharePoint 지식 원본에 대한 구성입니다.

속성 필수 형식 Description
kind True string:

remoteSharePoint

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

remoteSharePointParameters

RemoteSharePointKnowledgeSourceParameters

원격 SharePoint 지식 소스의 매개변수입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

SearchIndexKnowledgeSource

검색 인덱스를 대상으로 하는 지식 소스입니다.

속성 필수 형식 Description
kind True string:

searchIndex

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

searchIndexParameters True

SearchIndexKnowledgeSourceParameters

지식 소스에 대한 매개변수입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

WebKnowledgeSource

웹 결과를 타겟팅하는 지식 소스.

속성 필수 형식 Description
kind True string:

web

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

webParameters

WebKnowledgeSourceParameters

웹 지식 소스에 대한 매개 변수입니다.

WorkIQKnowledgeSource

WorkIQ 지식 소스 설정.

속성 필수 형식 Description
kind True string:

workIQ

지식 소스의 유형입니다.

name True

string

참조 자료의 이름입니다.

workIQParameters True

WorkIQKnowledgeSourceParameters

WorkIQ 지식 소스의 매개변수, 즉 인증 대신에 사용되는 고객 소유의 Entra 앱 구성 등이 포함됩니다.

@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

응답

속성 형식 Description
200 OK KnowledgeSource:

요청이 성공했습니다.

201 Created KnowledgeSource:

요청이 성공했고 결과적으로 새 리소스가 생성되었습니다.

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

api-key

형식: apiKey
In(다음 안에): header

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

범위

속성 Description
https://search.azure.com/.default

예제

SearchServiceAttachKnowledgeSourceGraphOntology
SearchServiceCreateOrUpdateKnowledgeSource
SearchServiceCreateOrUpdateKnowledgeSourceAzureBlob
SearchServiceCreateOrUpdateKnowledgeSourceAzureBlobWithTopicGraphs
SearchServiceCreateOrUpdateKnowledgeSourceCompatibleResponses
SearchServiceCreateOrUpdateKnowledgeSourceFile
SearchServiceCreateOrUpdateKnowledgeSourceIndexedOneLake
SearchServiceCreateOrUpdateKnowledgeSourceIndexedSharePoint
SearchServiceCreateOrUpdateKnowledgeSourceIndexedSql
SearchServiceCreateOrUpdateKnowledgeSourceMcpServer
SearchServiceCreateOrUpdateKnowledgeSourceOpenAICompatible
SearchServiceCreateOrUpdateKnowledgeSourceWeb
SearchServiceCreateOrUpdateKnowledgeSourceWithTopicGraphs
SearchServiceCreateOrUpdateKnowledgeSourceWorkIQ

SearchServiceAttachKnowledgeSourceGraphOntology

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-graph-cache')?api-version=2026-11-01-preview






{
  "name": "ks-graph-cache",
  "kind": "azureBlob",
  "@odata.etag": "\"0\"",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "isADLSGen2": false,
    "ingestionParameters": {
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "disableImageVerbalization": true,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "contentExtractionMode": "minimal",
      "cache": {
        "storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "enableReprocessing": true
      }
    },
    "graphExtraction": {
      "graphName": "products",
      "ontology": {
        "kind": "inline",
        "name": "product-ontology",
        "value": "{\n  \"@context\": {\n    \"@version\": 1.1,\n    \"owl\": \"http://www.w3.org/2002/07/owl#\",\n    \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n    \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n    \"ex\": \"https://example.com/products#\"\n  },\n  \"@graph\": [\n    { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n    { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n    { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n      \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n  ]\n}"
      }
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-graph-cache",
  "kind": "azureBlob",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": true,
      "contentExtractionMode": "minimal",
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "cache": {
        "enableReprocessing": true
      }
    },
    "graphExtraction": {
      "graphName": "products",
      "ontology": {
        "kind": "inline",
        "name": "product-ontology",
        "value": "{\n  \"@context\": {\n    \"@version\": 1.1,\n    \"owl\": \"http://www.w3.org/2002/07/owl#\",\n    \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n    \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n    \"ex\": \"https://example.com/products#\"\n  },\n  \"@graph\": [\n    { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n    { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n    { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n      \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n  ]\n}"
      }
    },
    "createdResources": {
      "datasource": "ks-graph-cache-datasource",
      "indexer": "ks-graph-cache-indexer",
      "skillset": "ks-graph-cache-skillset",
      "index": "ks-graph-cache-index"
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-graph-cache",
  "kind": "azureBlob",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": true,
      "contentExtractionMode": "minimal",
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "cache": {
        "enableReprocessing": true
      }
    },
    "graphExtraction": {
      "graphName": "products",
      "ontology": {
        "kind": "inline",
        "name": "product-ontology",
        "value": "{\n  \"@context\": {\n    \"@version\": 1.1,\n    \"owl\": \"http://www.w3.org/2002/07/owl#\",\n    \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n    \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n    \"ex\": \"https://example.com/products#\"\n  },\n  \"@graph\": [\n    { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n    { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n    { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n      \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n  ]\n}"
      }
    },
    "createdResources": {
      "datasource": "ks-graph-cache-datasource",
      "indexer": "ks-graph-cache-indexer",
      "skillset": "ks-graph-cache-skillset",
      "index": "ks-graph-cache-index"
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSource

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "searchIndex",
  "resultsProcessing": "none",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "semanticConfigurationName": "testconfig",
    "baseFilter": "category eq 'news'",
    "queryHints": {
      "filters": [
        {
          "field": "model",
          "fieldValues": [
            "Model-X100",
            "Model-X200",
            "Model-Pro"
          ],
          "filterInstructions": "Product model name."
        }
      ],
      "boosts": [
        {
          "kind": "fieldValue",
          "boostInstructions": "Document language; pick from the user's locale.",
          "field": "language",
          "fieldValues": [
            "en",
            "ja",
            "fr",
            "de"
          ],
          "boost": 2
        }
      ]
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "resultsProcessing": "none",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "semanticConfigurationName": "testconfig",
    "baseFilter": "category eq 'news'",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "queryHints": {
      "filters": [
        {
          "field": "model",
          "fieldValues": [
            "Model-X100",
            "Model-X200",
            "Model-Pro"
          ],
          "filterInstructions": "Product model name."
        }
      ],
      "boosts": [
        {
          "kind": "fieldValue",
          "field": "language",
          "fieldValues": [
            "en",
            "ja",
            "fr",
            "de"
          ],
          "boost": 2,
          "boostInstructions": "Document language; pick from the user's locale."
        }
      ]
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "resultsProcessing": "none",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "semanticConfigurationName": "testconfig",
    "baseFilter": "category eq 'news'",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "queryHints": {
      "filters": [
        {
          "field": "model",
          "fieldValues": [
            "Model-X100",
            "Model-X200",
            "Model-Pro"
          ],
          "filterInstructions": "Product model name."
        }
      ],
      "boosts": [
        {
          "kind": "fieldValue",
          "field": "language",
          "fieldValues": [
            "en",
            "ja",
            "fr",
            "de"
          ],
          "boost": 2,
          "boostInstructions": "Document language; pick from the user's locale."
        }
      ]
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceAzureBlob

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "azureBlob",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      },
      "networkAccessMode": "private"
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "azureBlob",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "networkAccessMode": "private",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "azureBlob",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "networkAccessMode": "private",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceAzureBlobWithTopicGraphs

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "azureBlob",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      },
      "networkAccessMode": "private"
    },
    "topicGraph": {
      "kind": "diverse",
      "minDiversityPoolSize": 1000,
      "diversityFactor": 0.1
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "azureBlob",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "networkAccessMode": "private",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    },
    "topicGraph": {
      "kind": "diverse",
      "diversityFactor": 0.1,
      "minDiversityPoolSize": 1000
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "azureBlob",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "networkAccessMode": "private",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    },
    "topicGraph": {
      "kind": "diverse",
      "diversityFactor": 0.1,
      "minDiversityPoolSize": 1000
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceCompatibleResponses

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('image-documents')?api-version=2026-11-01-preview




{
  "name": "image-documents",
  "kind": "azureBlob",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "documents",
    "ingestionParameters": {
      "chatCompletionModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/responses?route=primary&api-version=2026-01-01",
          "modelName": "gpt-4.1-mini",
          "headers": {
            "api-key": "test-key"
          }
        }
      },
      "disableImageVerbalization": false,
      "contentExtractionMode": "minimal"
    }
  }
}

샘플 응답

{
  "name": "image-documents",
  "kind": "azureBlob",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "documents",
    "ingestionParameters": {
      "chatCompletionModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/responses?route=primary&api-version=2026-01-01",
          "modelName": "gpt-4.1-mini"
        }
      },
      "disableImageVerbalization": false,
      "contentExtractionMode": "minimal"
    }
  }
}
{
  "name": "image-documents",
  "kind": "azureBlob",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "documents",
    "ingestionParameters": {
      "chatCompletionModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/responses?route=primary&api-version=2026-01-01",
          "modelName": "gpt-4.1-mini"
        }
      },
      "disableImageVerbalization": false,
      "contentExtractionMode": "minimal"
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceFile

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the File knowledge source.",
  "kind": "file",
  "fileParameters": {
    "ingestionParameters": {
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "file",
  "description": "Description of the File knowledge source.",
  "fileParameters": {
    "ingestionParameters": {
      "contentExtractionMode": "standard",
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    },
    "createdResources": {
      "index": "ks-preview-test-index"
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "file",
  "description": "Description of the File knowledge source.",
  "fileParameters": {
    "ingestionParameters": {
      "contentExtractionMode": "standard",
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    },
    "createdResources": {
      "index": "ks-preview-test-index"
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceIndexedOneLake

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the OneLake knowledge source.",
  "kind": "indexedOneLake",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      }
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedOneLake",
  "description": "Description of the OneLake knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedOneLake",
  "description": "Description of the OneLake knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceIndexedSharePoint

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the SharePoint knowledge source.",
  "kind": "indexedSharePoint",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSharePoint",
  "description": "Description of the SharePoint knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds"
      ],
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSharePoint",
  "description": "Description of the SharePoint knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds"
      ],
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceIndexedSql

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the SQL knowledge source.",
  "kind": "indexedSql",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSqlParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "tableOrView": "dbo.Products",
    "contentColumns": [
      {
        "name": "title",
        "sourceField": "Title",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "description",
        "sourceField": "Description",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "price",
        "sourceField": "Price",
        "searchFieldType": "Edm.Double"
      }
    ],
    "embeddingColumns": [
      {
        "name": "descriptionEmbedding",
        "sourceField": "Description"
      }
    ],
    "ingestionParameters": {
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "contentExtractionMode": "minimal"
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSql",
  "description": "Description of the SQL knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSqlParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "tableOrView": "dbo.Products",
    "contentColumns": [
      {
        "name": "title",
        "sourceField": "Title",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "description",
        "sourceField": "Description",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "price",
        "sourceField": "Price",
        "searchFieldType": "Edm.Double"
      }
    ],
    "embeddingColumns": [
      {
        "name": "descriptionEmbedding",
        "sourceField": "Description"
      }
    ],
    "ingestionParameters": {
      "contentExtractionMode": "minimal",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      }
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSql",
  "description": "Description of the SQL knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSqlParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "tableOrView": "dbo.Products",
    "contentColumns": [
      {
        "name": "title",
        "sourceField": "Title",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "description",
        "sourceField": "Description",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "price",
        "sourceField": "Price",
        "searchFieldType": "Edm.Double"
      }
    ],
    "embeddingColumns": [
      {
        "name": "descriptionEmbedding",
        "sourceField": "Description"
      }
    ],
    "ingestionParameters": {
      "contentExtractionMode": "minimal",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      }
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceMcpServer

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the MCP server knowledge source.",
  "kind": "mcpServer",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "mcpServerParameters": {
    "serverURL": "https://mcp.contoso.com/sse",
    "authentication": {
      "kind": "foundryConnection",
      "foundryConnectionParameters": {
        "connectionId": "conn-123"
      }
    },
    "tools": [
      {
        "name": "search-code",
        "outputParsing": {
          "kind": "json",
          "jsonParameters": {
            "documentsPath": "$.documents[*]",
            "includeContext": true
          }
        },
        "resultsProcessing": "rerank",
        "maxOutputTokens": 4096
      }
    ]
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "mcpServer",
  "description": "Description of the MCP server knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "mcpServerParameters": {
    "serverURL": "https://mcp.contoso.com/sse",
    "authentication": {
      "kind": "foundryConnection",
      "foundryConnectionParameters": {
        "connectionId": "conn-123"
      }
    },
    "tools": [
      {
        "name": "search-code",
        "resultsProcessing": "rerank",
        "maxOutputTokens": 4096,
        "outputParsing": {
          "kind": "json",
          "jsonParameters": {
            "documentsPath": "$.documents[*]",
            "includeContext": true
          }
        }
      }
    ]
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "mcpServer",
  "description": "Description of the MCP server knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "mcpServerParameters": {
    "serverURL": "https://mcp.contoso.com/sse",
    "authentication": {
      "kind": "foundryConnection",
      "foundryConnectionParameters": {
        "connectionId": "conn-123"
      }
    },
    "tools": [
      {
        "name": "search-code",
        "resultsProcessing": "rerank",
        "maxOutputTokens": 4096,
        "outputParsing": {
          "kind": "json",
          "jsonParameters": {
            "documentsPath": "$.documents[*]",
            "includeContext": true
          }
        }
      }
    ]
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceOpenAICompatible

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('compatible-preview-file-source')?api-version=2026-11-01-preview






{
  "name": "compatible-preview-file-source",
  "description": "Description of the File knowledge source.",
  "kind": "file",
  "fileParameters": {
    "ingestionParameters": {
      "embeddingModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/embeddings?route=primary&api-version=2026-01-01",
          "modelName": "text-embedding-3-small",
          "dimensions": 1024,
          "headers": {
            "api-key": "EXAMPLE-NOT-A-REAL-SECRET",
            "x-route-key": "EXAMPLE-NOT-A-REAL-ROUTING-SECRET"
          }
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "compatible-preview-file-source",
  "kind": "file",
  "description": "Description of the File knowledge source.",
  "fileParameters": {
    "ingestionParameters": {
      "contentExtractionMode": "standard",
      "embeddingModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/embeddings?route=primary&api-version=2026-01-01",
          "modelName": "text-embedding-3-small",
          "dimensions": 1024
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    },
    "createdResources": {
      "index": "compatible-preview-file-source-index"
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "compatible-preview-file-source",
  "kind": "file",
  "description": "Description of the File knowledge source.",
  "fileParameters": {
    "ingestionParameters": {
      "contentExtractionMode": "standard",
      "embeddingModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/embeddings?route=primary&api-version=2026-01-01",
          "modelName": "text-embedding-3-small",
          "dimensions": 1024
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    },
    "createdResources": {
      "index": "compatible-preview-file-source-index"
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceWeb

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "webParameters": {
    "domains": {
      "allowedDomains": [
        {
          "address": "example.com",
          "includeSubpages": true
        },
        {
          "address": "another-example.com"
        }
      ],
      "blockedDomains": [
        {
          "address": "blocked.com"
        },
        {
          "address": "spam.com",
          "includeSubpages": true
        }
      ]
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "web",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "web",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "webParameters": {
    "domains": {
      "allowedDomains": [
        {
          "address": "example.com",
          "includeSubpages": true
        },
        {
          "address": "another-example.com"
        }
      ],
      "blockedDomains": [
        {
          "address": "blocked.com"
        },
        {
          "address": "spam.com",
          "includeSubpages": true
        }
      ]
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "web",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "webParameters": {
    "domains": {
      "allowedDomains": [
        {
          "address": "example.com",
          "includeSubpages": true
        },
        {
          "address": "another-example.com"
        }
      ],
      "blockedDomains": [
        {
          "address": "blocked.com"
        },
        {
          "address": "spam.com",
          "includeSubpages": true
        }
      ]
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceWithTopicGraphs

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "searchIndex",
  "resultsProcessing": "none",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "semanticConfigurationName": "testconfig",
    "baseFilter": "category eq 'news'",
    "queryHints": {
      "filters": [
        {
          "field": "model",
          "fieldValues": [
            "Model-X100",
            "Model-X200",
            "Model-Pro"
          ],
          "filterInstructions": "Product model name."
        }
      ],
      "boosts": [
        {
          "kind": "fieldValue",
          "boostInstructions": "Document language; pick from the user's locale.",
          "field": "language",
          "fieldValues": [
            "en",
            "ja",
            "fr",
            "de"
          ],
          "boost": 2
        }
      ]
    },
    "topicGraph": {
      "kind": "diverse",
      "minDiversityPoolSize": 1000,
      "diversityFactor": 0.1
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "resultsProcessing": "none",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "semanticConfigurationName": "testconfig",
    "baseFilter": "category eq 'news'",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "queryHints": {
      "filters": [
        {
          "field": "model",
          "fieldValues": [
            "Model-X100",
            "Model-X200",
            "Model-Pro"
          ],
          "filterInstructions": "Product model name."
        }
      ],
      "boosts": [
        {
          "kind": "fieldValue",
          "field": "language",
          "fieldValues": [
            "en",
            "ja",
            "fr",
            "de"
          ],
          "boost": 2,
          "boostInstructions": "Document language; pick from the user's locale."
        }
      ]
    },
    "topicGraph": {
      "kind": "diverse",
      "diversityFactor": 0.1,
      "minDiversityPoolSize": 1000
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "resultsProcessing": "none",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "semanticConfigurationName": "testconfig",
    "baseFilter": "category eq 'news'",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "queryHints": {
      "filters": [
        {
          "field": "model",
          "fieldValues": [
            "Model-X100",
            "Model-X200",
            "Model-Pro"
          ],
          "filterInstructions": "Product model name."
        }
      ],
      "boosts": [
        {
          "kind": "fieldValue",
          "field": "language",
          "fieldValues": [
            "en",
            "ja",
            "fr",
            "de"
          ],
          "boost": 2,
          "boostInstructions": "Document language; pick from the user's locale."
        }
      ]
    },
    "topicGraph": {
      "kind": "diverse",
      "diversityFactor": 0.1,
      "minDiversityPoolSize": 1000
    }
  }
}

SearchServiceCreateOrUpdateKnowledgeSourceWorkIQ

샘플 요청

PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview






{
  "name": "ks-preview-test",
  "description": "Description of the WorkIQ knowledge source.",
  "kind": "workIQ",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "workIQParameters": {
    "entraAppAuthentication": {
      "applicationId": "11111111-1111-1111-1111-111111111111",
      "federatedCredentialId": "22222222-2222-2222-2222-222222222222"
    }
  }
}

샘플 응답

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "workIQ",
  "description": "Description of the WorkIQ knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "workIQParameters": {
    "entraAppAuthentication": {
      "applicationId": "11111111-1111-1111-1111-111111111111",
      "federatedCredentialId": "22222222-2222-2222-2222-222222222222"
    }
  }
}
{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "workIQ",
  "description": "Description of the WorkIQ knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "workIQParameters": {
    "entraAppAuthentication": {
      "applicationId": "11111111-1111-1111-1111-111111111111",
      "federatedCredentialId": "22222222-2222-2222-2222-222222222222"
    }
  }
}

정의

속성 Description
Accept

Accept 헤더입니다.

AIServices

AI 서비스의 매개변수.

AssetStore

추출한 이미지와 같은 자산을 저장하는 데 사용되는 자산 저장소 구성.

AzureBlobKnowledgeSource

Azure Blob Storage 지식 원본에 대한 구성입니다.

AzureBlobKnowledgeSourceParameters

Azure Blob Storage 기술 자료에 대한 매개 변수입니다.

AzureOpenAIModelName

호출될 Azure Open AI 모델 이름입니다.

AzureOpenAIVectorizerParameters

Azure OpenAI 리소스에 연결하기 위한 매개 변수를 지정합니다.

BalancedVectorQueryTopicGraph

순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다.

ContentColumnMapping

SQL 열을 검색 인덱스 필드에 매핑합니다.

CorsOptions

인덱스에 대한 CORS(원본 간 리소스 공유)를 제어하는 옵션을 정의합니다.

DiverseVectorQueryTopicGraph

주제 그래프를 사용하여 다양한 검색을 수행합니다.

EmbeddingColumnMapping

SQL 열을 벡터 필드에 매핑하여 임베딩합니다.

EntraAppAuthentication

연합된 자격 증명 기반 인증을 위해 사용하는 고객 소유 Microsoft Entra 앱 등록 설정.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

FabricDataAgentKnowledgeSource

Fabric Data Agent 지식 소스 구성

FabricDataAgentKnowledgeSourceParameters

Fabric Data Agent 지식 소스의 매개변수.

FabricOntologyKnowledgeSource

Fabric Ontology 구성 지식 출처.

FabricOntologyKnowledgeSourceParameters

Fabric Ontology 지식 출처를 위한 매개변수.

FileKnowledgeSource

직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정.

FileKnowledgeSourceParameters

파일 지식 소스 매개변수.

FreshnessPolicy

신선도 인식 검색을 위한 구성. 설정이 완료되면 새 문서는 검색 시 순위 상승을 받습니다.

IndexedOneLakeKnowledgeSource

OneLake 기술 자료에 대한 구성입니다.

IndexedOneLakeKnowledgeSourceParameters

OneLake 기술 자료에 대한 매개 변수입니다.

IndexedSharePointContainerName

액세스할 SharePoint 라이브러리를 지정합니다.

IndexedSharePointKnowledgeSource

SharePoint 기술 자료에 대한 구성입니다.

IndexedSharePointKnowledgeSourceParameters

SharePoint 지식 소스의 매개변수.

IndexedSqlKnowledgeSource

인덱스화된 SQL 지식 소스 설정.

IndexedSqlKnowledgeSourceParameters

인덱스 SQL 지식 소스의 매개변수.

IndexingSchedule

인덱서 실행 일정을 나타냅니다.

KnowledgeBaseAzureOpenAIModel

쿼리 계획을 수행하는 데 사용되는 Azure OpenAI 리소스를 지정합니다.

KnowledgeBaseMicrosoftRetriever1Model

쿼리 계획 및 검색에 사용되는 Microsoft Retriever 1을 지정합니다.

KnowledgeBaseModelKind

쿼리 계획에 사용할 AI 모델입니다.

KnowledgeBaseOpenAICompatibleModel

지식 기반 검색이나 최소 모드 지식 소스 이미지 구체화를 위한 고객 제어 OpenAI 호환 모델을 지정합니다. 검색 시 모델 프로필은 채팅 완료 또는 응답을 선택합니다. Standard/CU 추출이나 웹 지식 소스가 포함된 지식 베이스에는 지원되지 않습니다.

KnowledgeBaseOpenAICompatibleParameters

OpenAI 호환 채팅 완료 또는 응답 엔드포인트의 연결 매개변수. 생성하려면 비어 있지 않은 헤더 또는 managedIdentityAudience 중 정확히 하나가 필요합니다. 업데이트는 변경 없는 연결 및 모델 프로필에 대한 자격 증명을 유지하기 위해 헤더를 생략할 수 있습니다.

KnowledgeSourceAzureOpenAIVectorizer

쿼리 문자열을 벡터화하는 데 사용되는 Azure OpenAI 리소스를 지정합니다.

KnowledgeSourceCache

캐시된 지식 소스 보강 결과를 위한 저장 공간을 구성합니다. Blob 및 Table 엔드포인트가 포함된 GPv2 스토리지 계정이 필요합니다. 캐시 저장소 바인딩과 ID는 생성 후 변경할 수 없으며, 그래프 추출 워크플로우를 사용하는 동안에는 캐시를 제거할 수 없습니다.

KnowledgeSourceGraphExtractionParameters

인덱싱 전에 네이티브 Blob 소프트 삭제가 활성화된 상태에서 Azure Blob 지식 소스에서 그래프 추출을 구성합니다. ADLS Gen2, ACL 인제스팅, 민감도 라벨 인제스팅은 지원되지 않습니다. 별도의 온톨로지 변경은 동기화가 활성화되지 않을 때까지 기다려야 합니다.

KnowledgeSourceGraphGrounding

그래프 추출을 위한 접지 소스. 동일 서비스 검색 인덱스만 지원됩니다.

KnowledgeSourceGraphGroundingIndex

추출된 엔티티를 접지시키는 데 사용되는 검색 인덱스를 식별합니다.

KnowledgeSourceGraphGroundingSourceKind

그라운딩 참조를 위한 명시적 출처 유형. searchIndex만 지원됩니다.

KnowledgeSourceGraphOntology

그래프 추출을 위한 인라인 온톨로지. 지원되는 유일한 출처는 요청서에 직접 제공된 제한된 JSON-LD 문서입니다.

KnowledgeSourceGraphOntologySourceKind

온톨로지 참조의 명시적 소스 종류. "인라인"만 지원됩니다.

KnowledgeSourceIngestionParameters

참조 자료에 대한 모든 일반 수집 설정을 통합합니다.

KnowledgeSourceIngestionPermissionOption

문서 콘텐츠와 함께 인징할 수 있는 권한 유형.

KnowledgeSourceKind

지식 소스의 종류.

KnowledgeSourceNetworkAccessMode

지식 소스 수집을 위한 네트워크 접근 모드를 지정합니다. 디폴트는 '공개'입니다.

KnowledgeSourceOpenAICompatibleVectorizer

관리되는 지식 소스 수집과 생성된 쿼리 벡터화를 위해 사용되는 OpenAI 호환 임베딩 엔드포인트입니다. 네이티브 임베딩 모델에서 전환하려면 지식 소스를 다시 만들고 다시 인덱싱해야 합니다. URI, modelName 및 치수는 생성 후에는 변경할 수 없습니다.

KnowledgeSourceResultsProcessing

지식 소스의 결과가 재순위화되는지 여부를 통제합니다.

McpServerAuthenticationKind

MCP 서버용 인증 방식입니다.

McpServerAutoOutputParsing

출력 형식을 자동으로 감지하고 그에 맞게 파싱합니다.

McpServerFoundryConnectionAuthentication

Azure AI Foundry 연결을 통한 인증.

McpServerFoundryConnectionParameters

파운드리 연결 인증을 위한 매개변수.

McpServerJsonOutputParsing

생성된 JSON 매개변수를 사용하여 출력을 JSON 문서로 파싱합니다.

McpServerKnowledgeSource

MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성.

McpServerKnowledgeSourceParameters

MCP 서버 지식 소스의 매개변수.

McpServerNoneOutputParsing

출력을 구문 분석 없이 단일 블록으로 처리하세요.

McpServerOutputParsingJsonParameters

JSON 출력 파싱을 위한 매개변수들.

McpServerOutputParsingKind

MCP 서버 도구용 출력 파싱 같은 것들입니다.

McpServerOutputParsingSplitParameters

분할 출력 파싱을 위한 매개변수.

McpServerSplitOutputParsing

출력을 설정한 분할 매개변수를 사용해 페이지로 나누세요.

McpServerStoredHeadersAuthentication

저장된 HTTP 헤더를 이용한 인증.

McpServerStoredHeadersParameters

저장된 헤더 인증에 대한 매개변수.

McpServerTool

MCP 서버 지식 소스 내의 단일 도구를 나타냅니다.

NoneVectorQueryTopicGraph

주제 그래프 다양성 검색 없이 일반 벡터 탐색을 사용합니다.

OpenAICompatibleVectorizerParameters

직접 OpenAI 호환 임베딩스 엔드포인트의 연결 매개변수. 생성하려면 비어 있지 않은 헤더 또는 managedIdentityAudience 중 정확히 하나가 필요합니다. 업데이트는 변경 없는 연결 및 임베딩 프로필에 대한 자격 증명을 보존하기 위해 헤더를 생략할 수 있습니다.

Prefer

HTTP PUT 요청의 경우 성공 시 생성/업데이트된 리소스를 반환하도록 서비스에 지시합니다.

RemoteSharePointKnowledgeSource

원격 SharePoint 지식 원본에 대한 구성입니다.

RemoteSharePointKnowledgeSourceParameters

원격 SharePoint 참조 자료에 대한 매개 변수입니다.

SearchIndexerDataNoneIdentity

데이터 원본의 ID 속성을 지웁니다.

SearchIndexerDataUserAssignedIdentity

사용할 데이터 원본의 ID를 지정합니다.

SearchIndexFieldReference

검색 색인을 위한 필드 참조.

SearchIndexKnowledgeSource

검색 인덱스를 대상으로 하는 지식 소스입니다.

SearchIndexKnowledgeSourceBoostKind

검색 지수 지식 소스에 대한 부스트 팁 같은 것.

SearchIndexKnowledgeSourceFieldValueBoost

필드 값에 따라 문서를 강화하는 힌트입니다.

SearchIndexKnowledgeSourceFilterHint

필드를 식별하는 힌트와 쿼리 플래너가 필터를 구성할 때 사용할 수 있는 포괄적인 근지 값입니다.

SearchIndexKnowledgeSourceFilterHintAutoConfiguration

대상 인덱스 측면에서 필터 힌트의 그라운딩 값을 자동으로 분해하도록 구성합니다.

SearchIndexKnowledgeSourceMultiWordExpressionBoost

여러 단어 표현을 기반으로 문서를 강화하는 힌트입니다.

SearchIndexKnowledgeSourceParameters

검색 인덱스 지식 원본에 대한 매개 변수입니다.

SearchIndexKnowledgeSourceQueryHints

검색 색인 지식 소스를 위한 유용한 필터와 향상을 위한 쿼리 계획을 안내하는 힌트들.

SearchResourceEncryptionKey

Azure Key Vault의 고객 관리형 암호화 키입니다. 만들고 관리하는 키를 사용하여 인덱스 및 동의어 맵과 같은 미사용 데이터를 암호화하거나 복호화할 수 있습니다.

SplitSkillLanguage

SplitSkill에서 입력 텍스트에 대해 지원하는 언어 코드입니다.

TextSplitMode

수행할 분할 모드를 나타내는 값입니다.

VectorSearchTopicGraphKind

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

VectorSearchVectorizerKind

쿼리 시간 동안 사용할 벡터화 방법입니다.

WebKnowledgeSource

웹 결과를 타겟팅하는 지식 소스.

WebKnowledgeSourceDomain

웹 지식 원본 도메인에 대한 구성입니다.

WebKnowledgeSourceDomains

웹 지식 원본에 대한 도메인 허용/차단 구성입니다.

WebKnowledgeSourceParameters

웹 지식 소스에 대한 매개 변수입니다.

WorkIQKnowledgeSource

WorkIQ 지식 소스 설정.

WorkIQKnowledgeSourceParameters

WorkIQ 지식 소스의 매개변수.

Accept

Accept 헤더입니다.

값 Description
application/json;odata.metadata=minimal

AIServices

AI 서비스의 매개변수.

속성 형식 Description
apiKey

string

AI 서비스에 액세스하기 위한 API 키입니다.

uri

string (uri)

AI 서비스 엔드포인트의 URI입니다.

AssetStore

추출한 이미지와 같은 자산을 저장하는 데 사용되는 자산 저장소 구성.

속성 형식 Description
connectionString

string

자산 저장소의 연결 문자열입니다.

containerName

string

추출한 자산(예: 이미지)이 저장되는 자산 저장소 내 블롭 컨테이너 이름입니다.

AzureBlobKnowledgeSource

Azure Blob Storage 지식 원본에 대한 구성입니다.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

azureBlobParameters

AzureBlobKnowledgeSourceParameters

지식 소스의 유형입니다.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

kind string:

azureBlob

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

AzureBlobKnowledgeSourceParameters

Azure Blob Storage 기술 자료에 대한 매개 변수입니다.

속성 형식 Default value Description
connectionString

string

키 기반 연결 문자열 또는 관리 ID를 사용하는 경우 ResourceId 형식입니다.

containerName

string

Blob Storage 컨테이너의 이름입니다.

createdResources

object

지식 소스에서 만든 리소스입니다.

folderPath

string

컨테이너 내의 선택적 폴더 경로입니다.

graphExtraction

KnowledgeSourceGraphExtractionParameters

Graph extraction configuration for Azure Blob knowledge sources. 첫 번째 인덱싱 실행 전에 소스에서 네이티브 Blob 소프트 삭제를 구성하세요. 이 워크플로우에서는 ADLS Gen2, ACL 인제스팅, 민감도 라벨 인제스팅이 지원되지 않습니다.

ingestionParameters

KnowledgeSourceIngestionParameters

모든 일반 수집 설정을 통합합니다.

isADLSGen2

boolean

False

ADLS Gen2 스토리지 계정에 연결하는 경우 true로 설정합니다. 기본값은 false입니다.

topicGraph VectorQueryTopicGraph:

이 Azure Blob 지식 소스의 기본 주제 그래프 벡터 검색 옵션입니다.

AzureOpenAIModelName

호출될 Azure Open AI 모델 이름입니다.

값 Description
text-embedding-ada-002

TextEmbeddingAda002 모델.

text-embedding-3-large

TextEmbedding3Large 모델.

text-embedding-3-small

TextEmbedding3Small 모델.

gpt-4o

GPT4o 모델입니다.

gpt-4o-mini

GPT4oMini 모델입니다.

gpt-4.1

GPT41 모델입니다.

gpt-4.1-mini

GPT41Mini 모델입니다.

gpt-4.1-nano

GPT41Nano 모델입니다.

gpt-5

GPT5 모델입니다.

gpt-5-mini

GPT5미니 모델입니다.

gpt-5-nano

Gpt5Nano 모델입니다.

gpt-5.1

GPT51 모델입니다.

gpt-5.2

GPT52 모델입니다.

gpt-5.4

GPT54 모델입니다.

gpt-5.4-mini

GPT54미니 모델입니다.

gpt-5.4-nano

GPT54Nano 모델입니다.

gpt-5.5

GPT55 모델입니다.

gpt-5.6-sol

GPT56Sol 모델입니다.

gpt-5.6-terra

Gpt56Terra 모델입니다.

gpt-5.6-luna

GPT56Luna 모델입니다.

gpt-6-astra

Gpt6Astra 모델.

gpt-6-sol

Gpt6Sol 모델.

gpt-6-luna

Gpt6Luna 모델.

gpt-6.1-sol

Gpt61Sol 모델.

AzureOpenAIVectorizerParameters

Azure OpenAI 리소스에 연결하기 위한 매개 변수를 지정합니다.

속성 형식 Description
apiKey

string

지정된 Azure OpenAI 리소스의 API 키입니다.

authIdentity SearchIndexerDataIdentity:

아웃바운드 연결에 사용되는 사용자 할당 관리 ID입니다.

deploymentId

string

지정된 리소스에 대한 Azure OpenAI 모델 배포의 ID입니다.

modelName

AzureOpenAIModelName

제공된 deploymentId 경로에 배포되는 포함 모델의 이름입니다.

resourceUri

string (uri)

Azure OpenAI 리소스의 리소스 URI입니다.

BalancedVectorQueryTopicGraph

순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다.

속성 형식 Description
kind string:

balanced

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

주제 그래프 샘플링 전에 검색해야 할 최소 벡터 후보 수. 기본값은 1,000입니다.

ContentColumnMapping

SQL 열을 검색 인덱스 필드에 매핑합니다.

속성 형식 Description
name

string

대상 인덱스 필드 이름.

searchFieldType

string

Azure AI 검색 field type (eg., Edm.String, Edm.Int32).

sourceField

string

SQL 열명.

CorsOptions

인덱스에 대한 CORS(원본 간 리소스 공유)를 제어하는 옵션을 정의합니다.

속성 형식 Description
allowedOrigins

string[]

JavaScript 코드에 인덱스에 대한 액세스 권한이 부여되는 원본 목록입니다. {protocol}://{fully-qualified-domain-name}[:{port#}] 형식의 호스트 목록 또는 모든 출처를 허용하는 단일 '*'를 포함할 수 있습니다(권장되지 않음).

maxAgeInSeconds

integer (int64)

브라우저가 CORS 프리플라이트 응답을 캐시해야 하는 기간입니다. 기본값은 5분입니다.

DiverseVectorQueryTopicGraph

주제 그래프를 사용하여 다양한 검색을 수행합니다.

속성 형식 Description
diversityFactor

number (float)

minimum: 0
maximum: 1

주제 그래프 다양성 검색에 사용되는 다양성 계수. 생략하면 주제 그래프 프로필에 설정된 기본값이 사용됩니다.

kind string:

diverse

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

주제 그래프 샘플링 전에 검색해야 할 최소 벡터 후보 수. 기본값은 1,000입니다.

EmbeddingColumnMapping

SQL 열을 벡터 필드에 매핑하여 임베딩합니다.

속성 형식 Description
name

string

검색 인덱스의 대상 벡터 필드 이름.

sourceField

string

임베딩 생성을 위한 입력으로 사용되는 SQL 열.

EntraAppAuthentication

연합된 자격 증명 기반 인증을 위해 사용하는 고객 소유 Microsoft Entra 앱 등록 설정.

속성 형식 Description
applicationId

string (uuid)

고객 소유 Entra 앱 등록의 애플리케이션(클라이언트) ID.

federatedCredentialId

string (uuid)

앱 등록 시 설정된 연합 자격 증명 ID를 통해 검색 서비스가 저장된 클라이언트 비밀 없이 앱으로 인증할 수 있게 합니다.

tenantId

string (uuid)

앱 등록의 세입자 ID입니다. 앱 등록이 검색 서비스와 다른 테넌트에 있을 때 필수입니다. 생략 시 검색 서비스의 임차인이 사용됩니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보

속성 형식 Description
info

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

속성 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상.

ErrorResponse

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

속성 형식 Description
error

ErrorDetail

오류 개체입니다.

FabricDataAgentKnowledgeSource

Fabric Data Agent 지식 소스 구성

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

fabricDataAgentParameters

FabricDataAgentKnowledgeSourceParameters

Fabric Data Agent 지식 소스의 매개변수.

kind string:

fabricDataAgent

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

FabricDataAgentKnowledgeSourceParameters

Fabric Data Agent 지식 소스의 매개변수.

속성 형식 Description
dataAgentId

string

어떤 Fabric Data Agent에 접근할 것인지 지정합니다.

workspaceId

string

Fabric 작업 공간 ID.

FabricOntologyKnowledgeSource

Fabric Ontology 구성 지식 출처.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

fabricOntologyParameters

FabricOntologyKnowledgeSourceParameters

Fabric 온톨로지 지식 소스의 매개변수입니다.

kind string:

fabricOntology

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

FabricOntologyKnowledgeSourceParameters

Fabric Ontology 지식 출처를 위한 매개변수.

속성 형식 Description
ontologyId

string

Fabric 작업 공간에서 사용할 온톨로지의 ID.

workspaceId

string

온톨로지를 포함하는 Fabric 작업 공간 ID입니다.

FileKnowledgeSource

직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

corsOptions

CorsOptions

파일 지식 소스의 파일 엔드포인트(업로드, 목록, 업데이트, 삭제)에 대한 교차 출처 자원 공유(CORS) 제어 옵션.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

fileParameters

FileKnowledgeSourceParameters

파일 지식 소스의 매개변수.

kind string:

file

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

FileKnowledgeSourceParameters

파일 지식 소스 매개변수.

속성 형식 Description
createdResources

object

파일 지식 소스가 생성한 리소스.

ingestionParameters

KnowledgeSourceIngestionParameters

파일 지식 소스의 모든 일반 인제스 설정을 통합하며, 콘텐츠 추출 모드와 선택적 embeddingModel을 포함합니다.

FreshnessPolicy

신선도 인식 검색을 위한 구성. 설정이 완료되면 새 문서는 검색 시 순위 상승을 받습니다.

속성 형식 Description
boostingDuration

string

신선도 증진 기간에 대한 ISO 8601 기간(예: 'P90D' 90일). 이 기간보다 더 긴 문서는 검색 시 순위가 상승합니다.

IndexedOneLakeKnowledgeSource

OneLake 기술 자료에 대한 구성입니다.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

indexedOneLakeParameters

IndexedOneLakeKnowledgeSourceParameters

지식 소스에 대한 매개변수입니다.

kind string:

indexedOneLake

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

IndexedOneLakeKnowledgeSourceParameters

OneLake 기술 자료에 대한 매개 변수입니다.

속성 형식 Description
createdResources

object

지식 소스에서 만든 리소스입니다.

fabricWorkspaceId

string

OneLake 작업 영역 ID입니다.

ingestionParameters

KnowledgeSourceIngestionParameters

모든 일반 수집 설정을 통합합니다.

lakehouseId

string

어떤 OneLake 호숫가에 접근할 수 있는지 명시합니다.

targetPath

string

OneLakehouse 콘텐츠 필터링을 위한 선택적 OneLakehouse 폴더나 바로가기를 사용할 수 있습니다.

IndexedSharePointContainerName

액세스할 SharePoint 라이브러리를 지정합니다.

값 Description
defaultSiteLibrary

사이트의 기본 문서 라이브러리에서 콘텐츠를 인덱싱합니다.

allSiteLibraries

사이트의 모든 문서 라이브러리에서 콘텐츠를 인덱싱합니다.

useQuery

쿼리를 사용해 SharePoint 콘텐츠를 필터링하세요.

allSiteLists

사이트 내 모든 목록에서 콘텐츠를 색인화하세요.

allSitePages

사이트 내 모든 페이지에서 콘텐츠를 색인화하세요.

allSiteContent

사이트 내 지원되는 모든 라이브러리, 목록 및 페이지에서 콘텐츠를 인덱싱합니다.

IndexedSharePointKnowledgeSource

SharePoint 기술 자료에 대한 구성입니다.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

indexedSharePointParameters

IndexedSharePointKnowledgeSourceParameters

지식 소스에 대한 매개변수입니다.

kind string:

indexedSharePoint

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

IndexedSharePointKnowledgeSourceParameters

SharePoint 지식 소스의 매개변수.

속성 형식 Description
connectionString

string

SharePoint 연결 문자열 형식: SharePointOnlineEndpoint=[SharePoint 사이트 URL]; ApplicationId=[Azure AD App ID]; ApplicationSecret=[Azure AD App client secret]; TenantId=[SharePoint 사이트 tenant id]

containerName

IndexedSharePointContainerName

액세스할 SharePoint 라이브러리를 지정합니다.

createdResources

object

지식 소스에서 만든 리소스입니다.

ingestionParameters

KnowledgeSourceIngestionParameters

모든 일반 수집 설정을 통합합니다.

query

string

SharePoint 콘텐츠를 필터링하는 선택적 쿼리입니다.

IndexedSqlKnowledgeSource

인덱스화된 SQL 지식 소스 설정.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

indexedSqlParameters

IndexedSqlKnowledgeSourceParameters

SQL 지식 소스의 매개변수입니다.

kind string:

indexedSql

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

IndexedSqlKnowledgeSourceParameters

인덱스 SQL 지식 소스의 매개변수.

속성 형식 Description
connectionString

string

Azure SQL Database 또는 SQL Managed Instance의 연결 문자열입니다.

contentColumns

ContentColumnMapping[]

콘텐츠 필드에 대한 선택적 컬럼 매핑. 만약 이 열을 누락하면 모든 열이 자동 발견됩니다.

createdResources

object

지식 소스에서 만든 리소스입니다.

embeddingColumns

EmbeddingColumnMapping[]

벡터장 삽입을 위한 선택적 열(column) 매핑. 생략하면 벡터장이 생성되지 않습니다.

highWaterMarkColumnName

string

고수표 변경 감지를 위한 선택적 열명 사용. 제공된다면 HighWaterMarkChangeDetectionPolicy를 사용하세요.

ingestionParameters

KnowledgeSourceIngestionParameters

임베딩 모델, 스케줄, 아이덴티티를 포함한 모든 일반 인제트 설정을 통합합니다.

tableOrView

string

색인할 테이블 또는 뷰의 이름. 스키마 자격을 부여할 수 있습니다(예: 'dbo. MyTable').

IndexingSchedule

인덱서 실행 일정을 나타냅니다.

속성 형식 Description
interval

string (duration)

인덱서 실행 사이의 시간 간격입니다.

startTime

string (date-time)

인덱서가 실행을 시작해야 하는 시간입니다.

KnowledgeBaseAzureOpenAIModel

쿼리 계획을 수행하는 데 사용되는 Azure OpenAI 리소스를 지정합니다.

속성 형식 Description
azureOpenAIParameters

AzureOpenAIVectorizerParameters

Azure OpenAI parameters.

kind string:

azureOpenAI

쿼리 계획에 사용할 AI 모델입니다.

KnowledgeBaseMicrosoftRetriever1Model

쿼리 계획 및 검색에 사용되는 Microsoft Retriever 1을 지정합니다.

속성 형식 Description
kind string:

microsoftRetriever1

쿼리 계획에 사용할 AI 모델입니다.

KnowledgeBaseModelKind

쿼리 계획에 사용할 AI 모델입니다.

값 Description
azureOpenAI

쿼리 계획에 Azure Open AI 모델을 사용합니다.

openAICompatible

지식 기반 검색이나 지식 소스 이미지 구체화를 위해 고객이 직접 제어하는 OpenAI 호환 엔드포인트를 사용하세요.

microsoftRetriever1

쿼리 계획 및 검색을 위해 Microsoft Retriever 1을 사용하세요.

KnowledgeBaseOpenAICompatibleModel

지식 기반 검색이나 최소 모드 지식 소스 이미지 구체화를 위한 고객 제어 OpenAI 호환 모델을 지정합니다. 검색 시 모델 프로필은 채팅 완료 또는 응답을 선택합니다. Standard/CU 추출이나 웹 지식 소스가 포함된 지식 베이스에는 지원되지 않습니다.

속성 형식 Description
kind string:

openAICompatible

쿼리 계획에 사용할 AI 모델입니다.

openAICompatibleParameters

KnowledgeBaseOpenAICompatibleParameters

OpenAI 호환 엔드포인트의 연결 및 인증 매개변수.

KnowledgeBaseOpenAICompatibleParameters

OpenAI 호환 채팅 완료 또는 응답 엔드포인트의 연결 매개변수. 생성하려면 비어 있지 않은 헤더 또는 managedIdentityAudience 중 정확히 하나가 필요합니다. 업데이트는 변경 없는 연결 및 모델 프로필에 대한 자격 증명을 유지하기 위해 헤더를 생략할 수 있습니다.

속성 형식 Description
authIdentity SearchIndexerDataIdentity:

managedIdentityAudience 토큰을 획득하는 데 사용된 사용자 할당 관리 신원입니다. 검색 서비스의 시스템 할당 신원을 사용하지 않습니다. managedIdentityAudience에서만 허용됩니다.

headers

object (password)

엔드포인트 인증을 위한 비어 있지 않은 HTTP 헤더가 저장됩니다. 이름과 값 모두 비밀이며 응답에서 절대 반환되지 않습니다. 빈 지도는 유효하지 않습니다. managedIdentityAudience 및 authIdentity와 상호 독점적입니다. 업데이트 시, 생략된 헤더는 동일한 리소스와 모델 바인딩에서만 보존되며, 이는 정확한 엔드포인트, 모델 프로필 및 인증 ID가 변경되지 않은 경우에만 적용됩니다; 그렇지 않으면 새로운 자격 증명을 제공하세요.

managedIdentityAudience

string

관리형 신원 인증을 위한 고객의 서드파티 Microsoft Entra 애플리케이션의 기본 애플리케이션 GUID. api:// 접두사나 /.default 접미사는 포함하지 마십시오. 헤더와 상호 배타적인 경우.

modelName

AzureOpenAIModelName

검색의 기능과 한계를 결정하는 지원되는 채팅 모델 이름입니다. 지식 소스 이미지 구상의 경우, 이는 요청 본문의 모델 선택자로 전송됩니다; URI 경로는 이 이름과 관계없이 채팅 완료 또는 응답을 선택합니다. 지식 기반 검색을 위해 GPT-6 모델 프로필은 응답을 사용하고, 기존 모델 프로필은 채팅 완료를 사용합니다; 엔드포인트는 선택한 프로토콜을 지원해야 하며, 응답에 대한 상태 없는 도구 연속성을 포함해야 합니다. 검색 요청 본문은 모델을 생략합니다; URI 또는 게이트웨이는 실제 모델을 선택하고 필요한 공급자 모델 식별자를 제공합니다. 임베딩 모델과 임의 공급자 프로토콜은 지원되지 않습니다.

uri

string (uri)

경로 및 쿼리 매개변수를 포함한 완전한 HTTPS POST URL. 경로나 API 버전을 추가하지 않고 변경 없이 전송됨; 리디렉션은 따르지 않습니다. 지식 기반 검색을 위해서는 엔드포인트가 모델 프로필의 채팅 완료 또는 응답 프로토콜을 수용해야 합니다. 지식 소스 이미지 구체화를 위해 URI 경로는 /chat/completions 또는 /response로 끝나야 합니다; 쿼리 매개변수는 프로토콜을 선택하지 않습니다.

KnowledgeSourceAzureOpenAIVectorizer

쿼리 문자열을 벡터화하는 데 사용되는 Azure OpenAI 리소스를 지정합니다.

속성 형식 Description
azureOpenAIParameters

AzureOpenAIVectorizerParameters

Azure OpenAI 포함 벡터화와 관련된 매개 변수를 포함합니다.

kind string:

azureOpenAI

벡터 검색에 사용하도록 구성되는 벡터화 메서드의 이름입니다.

KnowledgeSourceCache

캐시된 지식 소스 보강 결과를 위한 저장 공간을 구성합니다. Blob 및 Table 엔드포인트가 포함된 GPv2 스토리지 계정이 필요합니다. 캐시 저장소 바인딩과 ID는 생성 후 변경할 수 없으며, 그래프 추출 워크플로우를 사용하는 동안에는 캐시를 제거할 수 없습니다.

속성 형식 Default value Description
enableReprocessing

boolean

True

강화 구성이 변경될 때 캐시된 보강 결과를 재처리할 수 있는지 여부. 그래프 추출 캐시 재생에는 반드시 true여야 합니다.

identity SearchIndexerDataIdentity:

강화 캐시에 연결하는 데 사용된 관리 아이덴티티입니다. ResourceId 연결 문자열에서 생략된 경우, 시스템 할당 관리 신원이 사용됩니다. 캐시가 구성된 후에는 신원을 변경할 수 없습니다.

storageConnectionString

string (password)

캐시된 강화 결과가 보존되는 스토리지 계정의 연결 문자열입니다.

KnowledgeSourceGraphExtractionParameters

인덱싱 전에 네이티브 Blob 소프트 삭제가 활성화된 상태에서 Azure Blob 지식 소스에서 그래프 추출을 구성합니다. ADLS Gen2, ACL 인제스팅, 민감도 라벨 인제스팅은 지원되지 않습니다. 별도의 온톨로지 변경은 동기화가 활성화되지 않을 때까지 기다려야 합니다.

속성 형식 Default value Description
graphName

string

생성할 그래프의 이름입니다.

grounding

KnowledgeSourceGraphGrounding

추출된 엔티티를 해석하는 데 사용되는 선택적 그라운딩 소스.

ontology

KnowledgeSourceGraphOntology

트리플을 추출하는 데 사용된 온톨로지. 생성 시 없거나 null인 경우, 구성된 강화 캐시를 통해 삼중 추출 없이도 검색 가능한 청크와 캐시 강화가 생성됩니다. 일단 온톨로지가 부착되면 제거할 수 없습니다. 별도의 온톨로지 변경은 동기화가 활성화되지 않을 때까지 기다려야 합니다.

pageDegreeOfParallelism

integer (int32)

minimum: 1
maximum: 1024
128

그래프 추출을 위해 병렬로 처리되는 최대 페이지 수.

KnowledgeSourceGraphGrounding

그래프 추출을 위한 접지 소스. 동일 서비스 검색 인덱스만 지원됩니다.

속성 형식 Default value Description
index

KnowledgeSourceGraphGroundingIndex

접지에 사용되는 동일 서비스 검색 인덱스입니다. searchIndex 소스에 필수입니다.

kind

KnowledgeSourceGraphGroundingSourceKind

searchIndex

근원 종류. 생략하면 searchIndex가 적용된다고 가정합니다. 다른 종류들은 거부됩니다.

KnowledgeSourceGraphGroundingIndex

추출된 엔티티를 접지시키는 데 사용되는 검색 인덱스를 식별합니다.

속성 형식 Description
indexName

string

접지 검색 인덱스의 이름입니다.

vectorFieldName

string

벡터 조회가 구성될 때 접지에 사용되는 벡터 필드의 이름입니다.

KnowledgeSourceGraphGroundingSourceKind

그라운딩 참조를 위한 명시적 출처 유형. searchIndex만 지원됩니다.

값 Description
searchIndex

동일한 검색 서비스 내의 검색 인덱스.

KnowledgeSourceGraphOntology

그래프 추출을 위한 인라인 온톨로지. 지원되는 유일한 출처는 요청서에 직접 제공된 제한된 JSON-LD 문서입니다.

속성 형식 Description
kind

KnowledgeSourceGraphOntologySourceKind

근원 종류. "인라인"만 지원됩니다.

name

string

온톨로지에 대한 선택적 고객이 제공한 이름이 다시 메 graphStatistics.ontologyName아리쳤습니다.

value

string

JSON으로 인코딩된 문자열로 제공되는 제한된 JSON-LD 1.1 온톨로지 문서(플랫 클래스 및 객체/데이터타입 속성).

KnowledgeSourceGraphOntologySourceKind

온톨로지 참조의 명시적 소스 종류. "인라인"만 지원됩니다.

값 Description
inline

요청서에 인라인으로 제공되는 온톨로지 콘텐츠는 제한된 JSON-LD 문서로 제공됩니다.

KnowledgeSourceIngestionParameters

참조 자료에 대한 모든 일반 수집 설정을 통합합니다.

속성 형식 Default value Description
aiServices

AIServices

콘텐츠 처리를 위한 선택적 AI 서비스 구성입니다.

assetStore

AssetStore

이미지와 같은 추출된 자산을 저장하는 선택적 자산 저장소 설정.

cache

KnowledgeSourceCache

Enrichment cache configuration for Azure Blob graph extraction. Blob 및 Table 엔드포인트와 재처리가 활성화된 GPv2 스토리지 계정이 필요합니다. 한 번 구성되면 캐시는 제거할 수 없으며, 저장 바인딩이나 식별 자체를 변경할 수 없습니다.

chatCompletionModel KnowledgeBaseModel:

이미지 언어화 또는 컨텍스트 추출을 위한 선택적 채팅 완료 모델입니다.

contentExtractionMode enum:
  • minimal
  • standard
minimal

선택적 콘텐츠 추출 모드. 기본값은 '최소'입니다.

disableImageVerbalization

boolean

False

이미지 언어화를 사용하지 않도록 설정해야 하는지 여부를 나타냅니다. 기본값은 false입니다.

embeddingModel KnowledgeSourceVectorizer:

콘텐츠를 벡터화하기 위한 선택적 벡터화기 구성입니다.

freshnessPolicy

FreshnessPolicy

검색을 새로운 문서에 편향하기 위한 선택적 신선성 정책.

identity SearchIndexerDataIdentity:

이 지식 소스에 사용할 명시적 ID입니다.

ingestionPermissionOptions

KnowledgeSourceIngestionPermissionOption[]

문서 콘텐츠와 함께 수집할 권한 유형의 선택적 목록입니다. 지정된 경우 데이터 원본에 대한 인덱서 권한 옵션을 설정합니다.

ingestionSchedule

IndexingSchedule

데이터 수집에 대한 선택적 일정입니다.

networkAccessMode

KnowledgeSourceNetworkAccessMode

public

선택적으로 네트워크 접속 모드가 제공됩니다. 'private'로 설정하여 사설 네트워크를 통해 데이터 소스와 의존성에 접근할 수 있는 사설 실행 환경에서 인제스팅을 실행합니다. 디폴트는 '공개'입니다. 이것은 생성 시간 설정이며, 지식 소스가 생성된 후에는 변경할 수 없습니다.

KnowledgeSourceIngestionPermissionOption

문서 콘텐츠와 함께 인징할 수 있는 권한 유형.

값 Description
userIds

문서 내용과 함께 명시적인 사용자 식별자를 인징합니다.

groupIds

문서 콘텐츠와 함께 그룹 식별자를 수집합니다.

rbacScope

문서 콘텐츠와 함께 RBAC 범위 정보를 수집합니다.

oneLakeParentFolders

생성된 인덱스에 OneLake 상위 폴더 경로를 수집하고 OneLake 권한 필터링을 활성화합니다. 인덱싱된 OneLake 지식 소스에만 지원됩니다.

oneLakeLakehouseId

소스 항목의 OneLake lakehouse ID를 수집하고 생성된 인덱스에 OneLake 권한 필터링을 활성화합니다. 인덱싱된 OneLake 지식 소스에만 지원됩니다.

sensitivityLabels

문서 내용과 함께 Microsoft Purview 민감도 라벨을 인징하세요.

KnowledgeSourceKind

지식 소스의 종류.

값 Description
searchIndex

검색 인덱스에서 데이터를 읽는 지식 소스입니다.

azureBlob

Azure Blob Storage에서 검색 인덱스로 데이터를 읽고 수집하는 기술 자료입니다.

indexedSharePoint

인덱스된 SharePoint에서 데이터를 읽는 지식 소스입니다.

indexedOneLake

색인화된 OneLake에서 데이터를 읽는 지식 소스입니다.

indexedSql

Azure SQL Database 또는 SQL Managed Instance에서 데이터를 검색 인덱스로 가져오고 인징하는 지식 소스입니다.

web

웹에서 데이터를 읽는 지식 소스입니다.

remoteSharePoint

원격 SharePoint에서 데이터를 읽는 지식 소스입니다.

workIQ

Work IQ에서 데이터를 읽어내는 지식 소스

file

직접 파일 업로드와 인덱싱을 지원하는 지식 소스입니다.

mcpServer

MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스입니다.

fabricDataAgent

이는 Fabric 데이터 에이전트에서 데이터를 가져오는 지식 소스입니다.

fabricOntology

Microsoft Fabric 온톨로지 온톨로지에서 데이터를 가져오는 지식 소스입니다.

KnowledgeSourceNetworkAccessMode

지식 소스 수집을 위한 네트워크 접근 모드를 지정합니다. 디폴트는 '공개'입니다.

값 Description
public

인제스팅은 표준적이고 공개적으로 접근 가능한 실행 환경에서 실행됩니다. 이것이 기본값입니다.

private

인제스팅은 사설 실행 환경에서 실행되므로 사설 네트워크(사설 엔드포인트/공유 사설 링크)를 통해 데이터 소스와 의존성에 도달할 수 있습니다.

KnowledgeSourceOpenAICompatibleVectorizer

관리되는 지식 소스 수집과 생성된 쿼리 벡터화를 위해 사용되는 OpenAI 호환 임베딩 엔드포인트입니다. 네이티브 임베딩 모델에서 전환하려면 지식 소스를 다시 만들고 다시 인덱싱해야 합니다. URI, modelName 및 치수는 생성 후에는 변경할 수 없습니다.

속성 형식 Description
kind string:

openAICompatible

벡터 검색에 사용하도록 구성되는 벡터화 메서드의 이름입니다.

openAICompatibleParameters

OpenAICompatibleVectorizerParameters

연결, 인증 및 임베딩 프로필 매개변수.

KnowledgeSourceResultsProcessing

지식 소스의 결과가 재순위화되는지 여부를 통제합니다.

값 Description
rerank

이 지식 소스의 결과는 재순위 파이프라인을 거칩니다. 기본 동작입니다.

none

이 지식 소스의 결과는 재순위를 거치지 않고 기본 순서를 유지합니다.

McpServerAuthenticationKind

MCP 서버용 인증 방식입니다.

값 Description
foundryConnection

Azure AI Foundry 연결을 통해 인증하세요.

storedHeaders

저장된 HTTP 헤더를 사용해 인증하세요.

McpServerAutoOutputParsing

출력 형식을 자동으로 감지하고 그에 맞게 파싱합니다.

속성 형식 Description
kind string:

auto

어떤 종류의 출력 파싱을 적용해야 할지.

McpServerFoundryConnectionAuthentication

Azure AI Foundry 연결을 통한 인증.

속성 형식 Description
foundryConnectionParameters

McpServerFoundryConnectionParameters

파운드리 연결 인증을 위한 매개변수.

kind string:

foundryConnection

어떤 종류의 인증 방식을 사용해야 할까요?

McpServerFoundryConnectionParameters

파운드리 연결 인증을 위한 매개변수.

속성 형식 Description
connectionId

string

Azure AI Foundry 연결 식별자.

McpServerJsonOutputParsing

생성된 JSON 매개변수를 사용하여 출력을 JSON 문서로 파싱합니다.

속성 형식 Description
jsonParameters

McpServerOutputParsingJsonParameters

JSON 출력 파싱을 위한 매개변수들. 종류가 'json'일 때 필수입니다.

kind string:

json

어떤 종류의 출력 파싱을 적용해야 할지.

McpServerKnowledgeSource

MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

kind string:

mcpServer

지식 소스의 유형입니다.

mcpServerParameters

McpServerKnowledgeSourceParameters

MCP 서버 지식 소스의 매개변수.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

McpServerKnowledgeSourceParameters

MCP 서버 지식 소스의 매개변수.

속성 형식 Description
authentication McpServerAuthentication:

MCP 서버의 인증 구성.

serverURL

string

MCP 서버 엔드포인트의 URL입니다.

tools

McpServerTool[]

MCP 서버에서 호출할 수 있는 도구 목록입니다.

McpServerNoneOutputParsing

출력을 구문 분석 없이 단일 블록으로 처리하세요.

속성 형식 Description
kind string:

none

어떤 종류의 출력 파싱을 적용해야 할지.

McpServerOutputParsingJsonParameters

JSON 출력 파싱을 위한 매개변수들.

속성 형식 Description
documentsPath

string

도구 출력에 있는 문서 배열로 가는 JSON 경로입니다.

includeContext

boolean

추출된 문서와 함께 JSON 출력에서 주변 맥락을 포함할지 여부에 대해서요.

McpServerOutputParsingKind

MCP 서버 도구용 출력 파싱 같은 것들입니다.

값 Description
auto

출력 형식을 자동으로 감지하고 그에 맞게 파싱합니다.

json

생성된 JSON 매개변수를 사용하여 출력을 JSON 문서로 파싱합니다.

split

출력을 설정한 분할 매개변수를 사용해 페이지로 나누세요.

none

출력을 구문 분석 없이 단일 블록으로 처리하세요.

McpServerOutputParsingSplitParameters

분할 출력 파싱을 위한 매개변수.

속성 형식 Description
defaultLanguageCode

SplitSkillLanguage

사용할 언어 코드를 나타내는 값입니다. 기본값은 en입니다.

maximumPageLength

integer (int32)

페이지당 최대 문자 수.

maximumPagesToTake

integer (int32)

출력에서 가져갈 수 있는 최대 페이지 수.

pageOverlapLength

integer (int32)

페이지 간에 겹치는 문자 수.

textSplitMode

TextSplitMode

텍스트 분할 모드를 사용하세요.

McpServerSplitOutputParsing

출력을 설정한 분할 매개변수를 사용해 페이지로 나누세요.

속성 형식 Description
kind string:

split

어떤 종류의 출력 파싱을 적용해야 할지.

splitParameters

McpServerOutputParsingSplitParameters

분할 출력 파싱을 위한 매개변수.

McpServerStoredHeadersAuthentication

저장된 HTTP 헤더를 이용한 인증.

속성 형식 Description
kind string:

storedHeaders

어떤 종류의 인증 방식을 사용해야 할까요?

storedHeadersParameters

McpServerStoredHeadersParameters

저장된 헤더 인증에 대한 매개변수.

McpServerStoredHeadersParameters

저장된 헤더 인증에 대한 매개변수.

속성 형식 Description
headers

object

MCP 서버 요청에 포함하는 저장된 HTTP 헤더들.

McpServerTool

MCP 서버 지식 소스 내의 단일 도구를 나타냅니다.

속성 형식 Description
maxOutputTokens

integer (int32)

이 도구의 출력에 대해 선택적으로 파싱 후 토큰 제한을 설정할 수 있습니다. 명시된 경우 0보다 커야 합니다.

name

string

호출할 MCP 도구의 이름입니다.

outputParsing McpServerOutputParsing:

도구의 출력을 해석하는 선택적 설정.

resultsProcessing

KnowledgeSourceResultsProcessing

이 도구에서 파싱된 결과가 재순위화되는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

NoneVectorQueryTopicGraph

주제 그래프 다양성 검색 없이 일반 벡터 탐색을 사용합니다.

속성 형식 Description
kind string:

none

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

OpenAICompatibleVectorizerParameters

직접 OpenAI 호환 임베딩스 엔드포인트의 연결 매개변수. 생성하려면 비어 있지 않은 헤더 또는 managedIdentityAudience 중 정확히 하나가 필요합니다. 업데이트는 변경 없는 연결 및 임베딩 프로필에 대한 자격 증명을 보존하기 위해 헤더를 생략할 수 있습니다.

속성 형식 Description
authIdentity SearchIndexerDataIdentity:

managedIdentityAudience 토큰을 획득하는 데 사용된 사용자 할당 관리 신원입니다. 검색 서비스의 시스템 할당 신원을 사용하지 않습니다. managedIdentityAudience에서만 허용됩니다.

dimensions

integer (int32)

minimum: 1

출력 치수는 대상 벡터 필드와 일치해야 합니다. text-embedding-ada-002와 text-embedding-3-small의 경우 기본값은 1536, text-embedding-3-large의 경우 기본값은 3072입니다. Ada는 1536을 요구합니다; text-embedding-3-small은 1부터 1536까지를 지원하며, text-embedding-3-large는 1부터 3072까지를 지원합니다. 업데이트 시 누락된 헤더를 유지하려면 구성된 치수가 변경되지 않아야 합니다; 치수를 생략하는 것은 기본값을 명시적으로 지정하는 것과 구별됩니다.

headers

object (password)

엔드포인트 인증을 위한 비어 있지 않은 HTTP 헤더가 저장됩니다. 이름과 값 모두 비밀이며 응답에서 절대 반환되지 않습니다. 빈 지도는 유효하지 않습니다. managedIdentityAudience 및 authIdentity와 상호 독점적입니다. 업데이트 시, 생략된 헤더는 동일한 리소스 및 벡터라이저 바인딩에서만 보존되며, 이는 정확한 엔드포인트, 구성된 치수를 포함한 임베딩 프로필, 인증 ID가 변경되지 않은 경우에만 유지됩니다; 그렇지 않으면 새로운 자격 증명을 제공하세요.

managedIdentityAudience

string

관리형 신원 인증을 위한 고객의 서드파티 Microsoft Entra 애플리케이션의 기본 애플리케이션 GUID. api:// 접두사나 /.default 접미사는 포함하지 마십시오. 헤더와 상호 배타적인 경우.

modelName

AzureOpenAIModelName

네이티브 Azure OpenAI 벡터라이저와 동일한 모델 이름 열거형을 사용하는 임베딩 프로파일입니다. 런타임에는 text-embedding-ada-002, text-embedding-3-small, text-embedding-3-large만 지원됩니다; 공유 열거형 내 채팅 이름은 거부됩니다. 검색의 제한과 기본 치수를 제어합니다; 아웃바운드 바디가 모델을 누락하므로 URI 또는 게이트웨이가 실제 모델을 선택해야 합니다. 임의 공급자 프로토콜은 지원되지 않습니다.

uri

string (uri)

완전한 HTTPS는 POST URL을 임베딩하며, 경로와 쿼리 매개변수를 포함합니다. 경로나 API 버전을 추가하지 않고 변경 없이 전송됨. 리디렉션은 따르지 않습니다.

Prefer

HTTP PUT 요청의 경우 성공 시 생성/업데이트된 리소스를 반환하도록 서비스에 지시합니다.

값 Description
return=representation

RemoteSharePointKnowledgeSource

원격 SharePoint 지식 원본에 대한 구성입니다.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

kind string:

remoteSharePoint

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

remoteSharePointParameters

RemoteSharePointKnowledgeSourceParameters

원격 SharePoint 지식 소스의 매개변수입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

RemoteSharePointKnowledgeSourceParameters

원격 SharePoint 참조 자료에 대한 매개 변수입니다.

속성 형식 Description
containerTypeId

string

SharePoint Embedded 연결에 대한 컨테이너 ID입니다. null이면 SharePoint Online을 사용합니다.

filterExpression

string

쿼리가 실행되기 전에 검색 범위를 지정하기 위한 쿼리 가능한 SharePoint 속성 및 특성이 있는 KQL(키워드 쿼리 언어) 식입니다.

resourceMetadata

string[]

응답의 각 항목에 대해 반환될 메타데이터 필드 목록입니다. 검색 가능한 메타데이터 속성만 이 목록에 포함될 수 있습니다. 기본적으로 메타데이터는 반환되지 않습니다.

SearchIndexerDataNoneIdentity

데이터 원본의 ID 속성을 지웁니다.

속성 형식 Description
@odata.type string:

#Microsoft.Azure.Search.DataNoneIdentity

ID 유형을 지정하는 URI 조각입니다.

SearchIndexerDataUserAssignedIdentity

사용할 데이터 원본의 ID를 지정합니다.

속성 형식 Description
@odata.type string:

#Microsoft.Azure.Search.DataUserAssignedIdentity

ID 유형을 지정하는 URI 조각입니다.

federatedIdentityClientId

string

다중 테넌트 User-Assigned 관리 신원 지원: 사용자 지정 관리 신원과 연합되도록 구성된 멀티텐턴트 앱의 클라이언트 ID.

userAssignedIdentity

string

일반적으로 검색 서비스에 할당되어야 하는 "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" 형식으로 사용자 할당 관리 ID의 정규화된 Azure 리소스 ID입니다.

SearchIndexFieldReference

검색 색인을 위한 필드 참조.

속성 형식 Description
name

string

@FSHO2@필드의 이름입니다.

SearchIndexKnowledgeSource

검색 인덱스를 대상으로 하는 지식 소스입니다.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

kind string:

searchIndex

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

searchIndexParameters

SearchIndexKnowledgeSourceParameters

지식 소스에 대한 매개변수입니다.

SearchIndexKnowledgeSourceBoostKind

검색 지수 지식 소스에 대한 부스트 팁 같은 것.

값 Description
fieldValue

필드 값을 기반으로 문서를 부스트하세요.

multiWordExpression

여러 단어 표현식을 기반으로 문서를 강화하세요.

SearchIndexKnowledgeSourceFieldValueBoost

필드 값에 따라 문서를 강화하는 힌트입니다.

속성 형식 Description
boost

number (double)

문서 점수의 배수입니다. 1.0과 같지 않은 양수여야 합니다.

boostInstructions

string

부스트를 언제 어떻게 적용해야 하는지 설명하는 자연어 지침.

field

string

minLength: 1

검색 인덱스 필드의 이름입니다.

fieldValues

string[]

필드의 대표 값.

kind string:

fieldValue

그런 종류의 부스트 힌트.

SearchIndexKnowledgeSourceFilterHint

필드를 식별하는 힌트와 쿼리 플래너가 필터를 구성할 때 사용할 수 있는 포괄적인 근지 값입니다.

속성 형식 Description
autoConfiguration

SearchIndexKnowledgeSourceFilterHintAutoConfiguration

필드의 측면에서 접지 값을 해결하도록 서비스를 구성합니다. 이 기능이 있으면 자동 구성을 가능하게 합니다. 필드는 필터링 가능하고 페이스팅 가능해야 합니다. 대상 인덱스에 문서 수준 권한이나 Purview 민감도 라벨이 활성화된 경우에는 지원되지 않습니다; 이 제한은 지식 소스 생성/업데이트 및 지식 기반 검색 시점에 검증됩니다. fieldValues와 상호 배타적입니다. 지식 소스가 저장된 queryHints경우에만 지원되며, 요청 시 queryHintOverrides점에서는 지원되지 않습니다.

field

string

minLength: 1

필터링 가능한 검색 인덱스 필드의 이름입니다.

fieldValues

string[]

해당 분야에 대한 포괄적인 값 집합. 최대 160개의 값, 값당 최대 128자, 합산 2048자까지. 를 지원하는 autoConfiguration버전에서는 명시되지 않는 한 autoConfiguration 필수이며, 상호 배타적이어야 합니다.

filterInstructions

string

필드에서 언제 어떻게 필터링할지 설명하는 자연어 지침.

SearchIndexKnowledgeSourceFilterHintAutoConfiguration

대상 인덱스 측면에서 필터 힌트의 그라운딩 값을 자동으로 분해하도록 구성합니다.

속성 형식 Description
cacheTtl

integer (int32)

minimum: 60
maximum: 3600

해결된 페이스트 값의 초수 수가 캐시됩니다. 허용 범위는 전용 서비스에서 60에서 3600까지, 서버리스 서비스에서는 60에서 900까지입니다. 생략 시 전용 서비스에서는 3600초, 서버리스 서비스에서는 900초로 기본 설정됩니다.

maxFacetValueCount

integer (int32)

minimum: 1
maximum: 64

접지로 사용할 최대 면(facet) 값 수. 기본값은 64입니다; 허용 범위는 1부터 64까지입니다. 값은 수제 필터 값과 동일한 2048자 결합 길이 제한과 값당 128자 제한을 적용받으며, 패셋 수 순서로 선택됩니다.

SearchIndexKnowledgeSourceMultiWordExpressionBoost

여러 단어 표현을 기반으로 문서를 강화하는 힌트입니다.

속성 형식 Description
boost

number (double)

문서 점수의 배수입니다. 1.0과 같지 않은 양수여야 합니다.

boostInstructions

string

부스트를 언제 어떻게 적용해야 하는지 설명하는 자연어 지침.

fieldValues

string[]

부스트의 대표 값입니다.

kind string:

multiWordExpression

그런 종류의 부스트 힌트.

SearchIndexKnowledgeSourceParameters

검색 인덱스 지식 원본에 대한 매개 변수입니다.

속성 형식 Description
baseFilter

string

검색 시점에 인덱스에 기본 필터 조건이 적용됩니다(예: '상태 eq VA'). 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다.

queryHints

SearchIndexKnowledgeSourceQueryHints

쿼리 계획을 안내하는 기본 힌트, 유용한 필터와 검색 정보 출처 향상을 위한 도움말입니다. 요청 시 쿼리 힌트가 이러한 기본값을 완전한 객체로 대체합니다.

searchFields

SearchIndexFieldReference[]

검색 인덱스에서 검색할 필드를 제한하는 데 사용됩니다.

searchIndexName

string

검색 인덱스의 이름입니다.

semanticConfigurationName

string

대상 검색 인덱스에서 기본 구성이 아닌 다른 의미 체계 구성을 지정하는 데 사용됩니다.

sourceDataFields

SearchIndexFieldReference[]

참조된 원본 데이터에 대한 추가 필드를 요청하는 데 사용됩니다.

topicGraph VectorQueryTopicGraph:

이 검색 인덱스 지식 소스의 기본 주제 그래프 벡터 검색 옵션입니다.

SearchIndexKnowledgeSourceQueryHints

검색 색인 지식 소스를 위한 유용한 필터와 향상을 위한 쿼리 계획을 안내하는 힌트들.

속성 형식 Description
boosts SearchIndexKnowledgeSourceBoost[]:

쿼리 플래너가 문서 순위에 영향을 줄 수 있는 조건을 식별하는 힌트를 강화하세요.

filters

SearchIndexKnowledgeSourceFilterHint[]

쿼리 플래너가 필터를 구성할 때 사용할 수 있는 필드와 대표 값을 식별하는 필터 힌트.

SearchResourceEncryptionKey

Azure Key Vault의 고객 관리형 암호화 키입니다. 만들고 관리하는 키를 사용하여 인덱스 및 동의어 맵과 같은 미사용 데이터를 암호화하거나 복호화할 수 있습니다.

속성 형식 Default value Description
accessCredentials.applicationId

string

미사용 데이터를 암호화할 때 사용할 Azure Key Vault에 필요한 액세스 권한이 부여된 AAD 애플리케이션 ID입니다. 애플리케이션 ID는 AAD 애플리케이션의 개체 ID와 혼동해서는 안 됩니다.

accessCredentials.applicationSecret

string

지정된 AAD 애플리케이션의 인증 키입니다.

identity SearchIndexerDataIdentity:

이 암호화 키에 사용할 명시적 관리 ID입니다. 지정하지 않고 액세스 자격 증명 속성이 null이면 시스템 할당 관리 ID가 사용됩니다. 리소스 업데이트 시 명시적 ID가 지정되지 않은 경우 변경되지 않은 상태로 유지됩니다. "none"을 지정하면 이 속성의 값이 지워집니다.

isServiceLevelKey

boolean

False

이 키가 서비스 수준 키인지 여부를 나타내는 선택적 값입니다. 기본값은 false입니다.

keyVaultKeyName

string

미사용 데이터를 암호화하는 데 사용할 Azure Key Vault 키의 이름입니다.

keyVaultKeyVersion

string

미사용 데이터를 암호화하는 데 사용할 Azure Key Vault 키의 버전입니다.

keyVaultUri

string

미사용 데이터를 암호화하는 데 사용할 키를 포함하는 DNS 이름이라고도 하는 Azure Key Vault의 URI입니다. 예제 URI는 https://my-keyvault-name.vault.azure.net수 있습니다.

SplitSkillLanguage

SplitSkill에서 입력 텍스트에 대해 지원하는 언어 코드입니다.

값 Description
am

암하라어

bs

Bosnian

cs

체코어

da

덴마크어

de

German

en

English

es

Spanish

et

Estonian

fi

핀란드어

fr

French

he

히브리어

hi

힌디어

hr

크로아티아어

hu

Hungarian

id

Indonesian

is

아이슬란드어

it

Italian

ja

Japanese

ko

Korean

lv

Latvian

nb

노르웨이어

nl

네덜란드어

pl

Polish

pt

포르투갈어(포르투갈)

pt-br

포르투갈어 (브라질)

ru

Russian

sk

슬로바키아어

sl

슬로베니아어

sr

세르비아어

sv

스웨덴어

tr

터키어

ur

우르두어

zh

중국어 (간체)

TextSplitMode

수행할 분할 모드를 나타내는 값입니다.

값 Description
pages

텍스트를 개별 페이지로 분할합니다.

sentences

텍스트를 개별 문장으로 분할합니다.

VectorSearchTopicGraphKind

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

값 Description
none

주제 그래프 다양성 검색이 꺼져 있을 때는 일반 벡터 검색을 사용하세요.

diverse

주제 그래프 다양성 검색을 활용하세요.

balanced

순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다.

VectorSearchVectorizerKind

쿼리 시간 동안 사용할 벡터화 방법입니다.

값 Description
azureOpenAI

쿼리 시 Azure OpenAI 리소스를 사용하여 포함을 생성합니다.

openAICompatible

고객이 직접 제어하는 OpenAI 호환 임베딩 엔드포인트를 사용하여 임베딩을 생성하세요.

customWebApi

쿼리 시 사용자 지정 웹 엔드포인트를 사용하여 포함을 생성합니다.

aiServicesVision

Azure AI Services Vision Vectorize API를 사용하여 쿼리 시 이미지 또는 텍스트 입력에 대한 임베딩을 생성합니다.

aml

쿼리 시 Azure AI Foundry 모델 카탈로그를 통해 배포된 Azure Machine Learning 엔드포인트를 사용하여 포함을 생성합니다.

WebKnowledgeSource

웹 결과를 타겟팅하는 지식 소스.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

kind string:

web

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

webParameters

WebKnowledgeSourceParameters

웹 지식 소스에 대한 매개 변수입니다.

WebKnowledgeSourceDomain

웹 지식 원본 도메인에 대한 구성입니다.

속성 형식 Description
address

string

도메인의 주소입니다.

includeSubpages

boolean

이 도메인의 하위 페이지를 포함할지 여부입니다.

WebKnowledgeSourceDomains

웹 지식 원본에 대한 도메인 허용/차단 구성입니다.

속성 형식 Description
allowedDomains

WebKnowledgeSourceDomain[]

웹 결과에 허용되는 도메인들.

blockedDomains

WebKnowledgeSourceDomain[]

웹 결과에서 차단된 도메인들.

WebKnowledgeSourceParameters

웹 지식 소스에 대한 매개 변수입니다.

속성 형식 Description
count

integer (int32)

기본 웹 결과 수. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다.

domains

WebKnowledgeSourceDomains

웹 결과에 대한 도메인 허용/차단 구성입니다.

freshness

string

웹 결과의 기본 신선도 필터입니다. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다.

language

string

웹 결과의 기본 언어입니다. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다.

market

string

웹 결과의 기본 시장입니다. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다.

WorkIQKnowledgeSource

WorkIQ 지식 소스 설정.

속성 형식 Description
@odata.etag

string

지식의 원천 ETag.

description

string

선택적 사용자 정의 설명입니다.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다.

kind string:

workIQ

지식 소스의 유형입니다.

name

string

참조 자료의 이름입니다.

resultsProcessing

KnowledgeSourceResultsProcessing

이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다.

workIQParameters

WorkIQKnowledgeSourceParameters

WorkIQ 지식 소스의 매개변수, 즉 인증 대신에 사용되는 고객 소유의 Entra 앱 구성 등이 포함됩니다.

WorkIQKnowledgeSourceParameters

WorkIQ 지식 소스의 매개변수.

속성 형식 Description
entraAppAuthentication

EntraAppAuthentication

고객 소유의 Microsoft Entra 앱 등록 구성은 Work IQ API를 대리하여 인증하는 데 사용됩니다. 고객은 임차인 소유의 Entra 앱을 등록하고, WorkIQAgent.Ask delegated 권한을 부여하며, Azure AI 검색가 저장된 클라이언트 비밀 없이 해당 앱으로 인증할 수 있도록 연합 자격 증명을 설정합니다.