Knowledge Sources - Create Or Update
새 지식 소스를 만들거나 지식 소스가 이미 있는 경우 업데이트합니다.
PUT {endpoint}/knowledgesources('{sourceName}')?api-version=2026-11-01-preview
URI 매개 변수
| 속성 | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
검색 서비스의 엔드포인트 URL입니다. |
|
source
|
path | True |
string |
참조 자료의 이름입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 헤더
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다. |
|
| Accept |
Accept 헤더입니다. |
||
| If-Match |
string |
If-Match 조건을 정의합니다. 서버의 ETag가 이 값과 일치하는 경우에만 작업이 수행됩니다. |
|
| If-None-Match |
string |
If-None-Match 조건을 정의합니다. 서버의 ETag가 이 값과 일치하지 않는 경우에만 작업이 수행됩니다. |
|
| Prefer | True |
HTTP PUT 요청의 경우 성공 시 생성/업데이트된 리소스를 반환하도록 서비스에 지시합니다. |
요청 본문
요청 본문은 다음 중 하나가 될 수 있습니다.
| 속성 | Description |
|---|---|
|
Azure |
Azure Blob Storage 지식 원본에 대한 구성입니다. |
|
Fabric |
Fabric Data Agent 지식 소스 구성 |
|
Fabric |
Fabric Ontology 구성 지식 출처. |
|
File |
직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정. |
|
Indexed |
OneLake 기술 자료에 대한 구성입니다. |
|
Indexed |
SharePoint 기술 자료에 대한 구성입니다. |
|
Indexed |
인덱스화된 SQL 지식 소스 설정. |
|
Mcp |
MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성. |
|
Remote |
원격 SharePoint 지식 원본에 대한 구성입니다. |
|
Search |
검색 인덱스를 대상으로 하는 지식 소스입니다. |
|
Web |
웹 결과를 타겟팅하는 지식 소스. |
|
Work |
WorkIQ 지식 소스 설정. |
AzureBlobKnowledgeSource
Azure Blob Storage 지식 원본에 대한 구성입니다.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| azureBlobParameters | True |
지식 소스의 유형입니다. |
|
| kind | True |
string:
azure |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
FabricDataAgentKnowledgeSource
Fabric Data Agent 지식 소스 구성
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| fabricDataAgentParameters | True |
Fabric Data Agent 지식 소스의 매개변수. |
|
| kind | True |
string:
fabric |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
FabricOntologyKnowledgeSource
Fabric Ontology 구성 지식 출처.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| fabricOntologyParameters | True |
Fabric 온톨로지 지식 소스의 매개변수입니다. |
|
| kind | True |
string:
fabric |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
FileKnowledgeSource
직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| fileParameters | True |
파일 지식 소스의 매개변수. |
|
| kind | True |
string:
file |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| corsOptions |
파일 지식 소스의 파일 엔드포인트(업로드, 목록, 업데이트, 삭제)에 대한 교차 출처 자원 공유(CORS) 제어 옵션. |
||
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
IndexedOneLakeKnowledgeSource
OneLake 기술 자료에 대한 구성입니다.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| indexedOneLakeParameters | True |
지식 소스에 대한 매개변수입니다. |
|
| kind | True |
string:
indexed |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
IndexedSharePointKnowledgeSource
SharePoint 기술 자료에 대한 구성입니다.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| indexedSharePointParameters | True |
지식 소스에 대한 매개변수입니다. |
|
| kind | True |
string:
indexed |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
IndexedSqlKnowledgeSource
인덱스화된 SQL 지식 소스 설정.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| indexedSqlParameters | True |
SQL 지식 소스의 매개변수입니다. |
|
| kind | True |
string:
indexed |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
McpServerKnowledgeSource
MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| kind | True |
string:
mcp |
지식 소스의 유형입니다. |
| mcpServerParameters | True |
MCP 서버 지식 소스의 매개변수. |
|
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
RemoteSharePointKnowledgeSource
원격 SharePoint 지식 원본에 대한 구성입니다.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| kind | True |
string:
remote |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| remoteSharePointParameters |
원격 SharePoint 지식 소스의 매개변수입니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
SearchIndexKnowledgeSource
검색 인덱스를 대상으로 하는 지식 소스입니다.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| kind | True |
string:
search |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| searchIndexParameters | True |
지식 소스에 대한 매개변수입니다. |
|
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
WebKnowledgeSource
웹 결과를 타겟팅하는 지식 소스.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| kind | True |
string:
web |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
||
| webParameters |
웹 지식 소스에 대한 매개 변수입니다. |
WorkIQKnowledgeSource
WorkIQ 지식 소스 설정.
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| kind | True |
string:
workIQ |
지식 소스의 유형입니다. |
| name | True |
string |
참조 자료의 이름입니다. |
| workIQParameters | True |
WorkIQ 지식 소스의 매개변수, 즉 인증 대신에 사용되는 고객 소유의 Entra 앱 구성 등이 포함됩니다. |
|
| @odata.etag |
string |
지식의 원천 ETag. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
|
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
||
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
응답
| 속성 | 형식 | Description |
|---|---|---|
| 200 OK |
KnowledgeSource:
|
요청이 성공했습니다. |
| 201 Created |
KnowledgeSource:
|
요청이 성공했고 결과적으로 새 리소스가 생성되었습니다. |
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
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
샘플 요청
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 서비스의 매개변수. |
|
Asset |
추출한 이미지와 같은 자산을 저장하는 데 사용되는 자산 저장소 구성. |
|
Azure |
Azure Blob Storage 지식 원본에 대한 구성입니다. |
|
Azure |
Azure Blob Storage 기술 자료에 대한 매개 변수입니다. |
|
Azure |
호출될 Azure Open AI 모델 이름입니다. |
|
Azure |
Azure OpenAI 리소스에 연결하기 위한 매개 변수를 지정합니다. |
|
Balanced |
순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다. |
|
Content |
SQL 열을 검색 인덱스 필드에 매핑합니다. |
|
Cors |
인덱스에 대한 CORS(원본 간 리소스 공유)를 제어하는 옵션을 정의합니다. |
|
Diverse |
주제 그래프를 사용하여 다양한 검색을 수행합니다. |
|
Embedding |
SQL 열을 벡터 필드에 매핑하여 임베딩합니다. |
|
Entra |
연합된 자격 증명 기반 인증을 위해 사용하는 고객 소유 Microsoft Entra 앱 등록 설정. |
|
Error |
리소스 관리 오류 추가 정보 |
|
Error |
오류 세부 정보입니다. |
|
Error |
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다. |
|
Fabric |
Fabric Data Agent 지식 소스 구성 |
|
Fabric |
Fabric Data Agent 지식 소스의 매개변수. |
|
Fabric |
Fabric Ontology 구성 지식 출처. |
|
Fabric |
Fabric Ontology 지식 출처를 위한 매개변수. |
|
File |
직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정. |
|
File |
파일 지식 소스 매개변수. |
|
Freshness |
신선도 인식 검색을 위한 구성. 설정이 완료되면 새 문서는 검색 시 순위 상승을 받습니다. |
|
Indexed |
OneLake 기술 자료에 대한 구성입니다. |
|
Indexed |
OneLake 기술 자료에 대한 매개 변수입니다. |
|
Indexed |
액세스할 SharePoint 라이브러리를 지정합니다. |
|
Indexed |
SharePoint 기술 자료에 대한 구성입니다. |
|
Indexed |
SharePoint 지식 소스의 매개변수. |
|
Indexed |
인덱스화된 SQL 지식 소스 설정. |
|
Indexed |
인덱스 SQL 지식 소스의 매개변수. |
|
Indexing |
인덱서 실행 일정을 나타냅니다. |
|
Knowledge |
쿼리 계획을 수행하는 데 사용되는 Azure OpenAI 리소스를 지정합니다. |
|
Knowledge |
쿼리 계획 및 검색에 사용되는 Microsoft Retriever 1을 지정합니다. |
|
Knowledge |
쿼리 계획에 사용할 AI 모델입니다. |
|
Knowledge |
지식 기반 검색이나 최소 모드 지식 소스 이미지 구체화를 위한 고객 제어 OpenAI 호환 모델을 지정합니다. 검색 시 모델 프로필은 채팅 완료 또는 응답을 선택합니다. Standard/CU 추출이나 웹 지식 소스가 포함된 지식 베이스에는 지원되지 않습니다. |
|
Knowledge |
OpenAI 호환 채팅 완료 또는 응답 엔드포인트의 연결 매개변수. 생성하려면 비어 있지 않은 헤더 또는 managedIdentityAudience 중 정확히 하나가 필요합니다. 업데이트는 변경 없는 연결 및 모델 프로필에 대한 자격 증명을 유지하기 위해 헤더를 생략할 수 있습니다. |
|
Knowledge |
쿼리 문자열을 벡터화하는 데 사용되는 Azure OpenAI 리소스를 지정합니다. |
|
Knowledge |
캐시된 지식 소스 보강 결과를 위한 저장 공간을 구성합니다. Blob 및 Table 엔드포인트가 포함된 GPv2 스토리지 계정이 필요합니다. 캐시 저장소 바인딩과 ID는 생성 후 변경할 수 없으며, 그래프 추출 워크플로우를 사용하는 동안에는 캐시를 제거할 수 없습니다. |
|
Knowledge |
인덱싱 전에 네이티브 Blob 소프트 삭제가 활성화된 상태에서 Azure Blob 지식 소스에서 그래프 추출을 구성합니다. ADLS Gen2, ACL 인제스팅, 민감도 라벨 인제스팅은 지원되지 않습니다. 별도의 온톨로지 변경은 동기화가 활성화되지 않을 때까지 기다려야 합니다. |
|
Knowledge |
그래프 추출을 위한 접지 소스. 동일 서비스 검색 인덱스만 지원됩니다. |
|
Knowledge |
추출된 엔티티를 접지시키는 데 사용되는 검색 인덱스를 식별합니다. |
|
Knowledge |
그라운딩 참조를 위한 명시적 출처 유형. searchIndex만 지원됩니다. |
|
Knowledge |
그래프 추출을 위한 인라인 온톨로지. 지원되는 유일한 출처는 요청서에 직접 제공된 제한된 JSON-LD 문서입니다. |
|
Knowledge |
온톨로지 참조의 명시적 소스 종류. "인라인"만 지원됩니다. |
|
Knowledge |
참조 자료에 대한 모든 일반 수집 설정을 통합합니다. |
|
Knowledge |
문서 콘텐츠와 함께 인징할 수 있는 권한 유형. |
|
Knowledge |
지식 소스의 종류. |
|
Knowledge |
지식 소스 수집을 위한 네트워크 접근 모드를 지정합니다. 디폴트는 '공개'입니다. |
|
Knowledge |
관리되는 지식 소스 수집과 생성된 쿼리 벡터화를 위해 사용되는 OpenAI 호환 임베딩 엔드포인트입니다. 네이티브 임베딩 모델에서 전환하려면 지식 소스를 다시 만들고 다시 인덱싱해야 합니다. URI, modelName 및 치수는 생성 후에는 변경할 수 없습니다. |
|
Knowledge |
지식 소스의 결과가 재순위화되는지 여부를 통제합니다. |
|
Mcp |
MCP 서버용 인증 방식입니다. |
|
Mcp |
출력 형식을 자동으로 감지하고 그에 맞게 파싱합니다. |
|
Mcp |
Azure AI Foundry 연결을 통한 인증. |
|
Mcp |
파운드리 연결 인증을 위한 매개변수. |
|
Mcp |
생성된 JSON 매개변수를 사용하여 출력을 JSON 문서로 파싱합니다. |
|
Mcp |
MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성. |
|
Mcp |
MCP 서버 지식 소스의 매개변수. |
|
Mcp |
출력을 구문 분석 없이 단일 블록으로 처리하세요. |
|
Mcp |
JSON 출력 파싱을 위한 매개변수들. |
|
Mcp |
MCP 서버 도구용 출력 파싱 같은 것들입니다. |
|
Mcp |
분할 출력 파싱을 위한 매개변수. |
|
Mcp |
출력을 설정한 분할 매개변수를 사용해 페이지로 나누세요. |
|
Mcp |
저장된 HTTP 헤더를 이용한 인증. |
|
Mcp |
저장된 헤더 인증에 대한 매개변수. |
|
Mcp |
MCP 서버 지식 소스 내의 단일 도구를 나타냅니다. |
|
None |
주제 그래프 다양성 검색 없이 일반 벡터 탐색을 사용합니다. |
|
Open |
직접 OpenAI 호환 임베딩스 엔드포인트의 연결 매개변수. 생성하려면 비어 있지 않은 헤더 또는 managedIdentityAudience 중 정확히 하나가 필요합니다. 업데이트는 변경 없는 연결 및 임베딩 프로필에 대한 자격 증명을 보존하기 위해 헤더를 생략할 수 있습니다. |
| Prefer |
HTTP PUT 요청의 경우 성공 시 생성/업데이트된 리소스를 반환하도록 서비스에 지시합니다. |
|
Remote |
원격 SharePoint 지식 원본에 대한 구성입니다. |
|
Remote |
원격 SharePoint 참조 자료에 대한 매개 변수입니다. |
|
Search |
데이터 원본의 ID 속성을 지웁니다. |
|
Search |
사용할 데이터 원본의 ID를 지정합니다. |
|
Search |
검색 색인을 위한 필드 참조. |
|
Search |
검색 인덱스를 대상으로 하는 지식 소스입니다. |
|
Search |
검색 지수 지식 소스에 대한 부스트 팁 같은 것. |
|
Search |
필드 값에 따라 문서를 강화하는 힌트입니다. |
|
Search |
필드를 식별하는 힌트와 쿼리 플래너가 필터를 구성할 때 사용할 수 있는 포괄적인 근지 값입니다. |
|
Search |
대상 인덱스 측면에서 필터 힌트의 그라운딩 값을 자동으로 분해하도록 구성합니다. |
|
Search |
여러 단어 표현을 기반으로 문서를 강화하는 힌트입니다. |
|
Search |
검색 인덱스 지식 원본에 대한 매개 변수입니다. |
|
Search |
검색 색인 지식 소스를 위한 유용한 필터와 향상을 위한 쿼리 계획을 안내하는 힌트들. |
|
Search |
Azure Key Vault의 고객 관리형 암호화 키입니다. 만들고 관리하는 키를 사용하여 인덱스 및 동의어 맵과 같은 미사용 데이터를 암호화하거나 복호화할 수 있습니다. |
|
Split |
SplitSkill에서 입력 텍스트에 대해 지원하는 언어 코드입니다. |
|
Text |
수행할 분할 모드를 나타내는 값입니다. |
|
Vector |
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지. |
|
Vector |
쿼리 시간 동안 사용할 벡터화 방법입니다. |
|
Web |
웹 결과를 타겟팅하는 지식 소스. |
|
Web |
웹 지식 원본 도메인에 대한 구성입니다. |
|
Web |
웹 지식 원본에 대한 도메인 허용/차단 구성입니다. |
|
Web |
웹 지식 소스에 대한 매개 변수입니다. |
|
Work |
WorkIQ 지식 소스 설정. |
|
Work |
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 |
지식 소스의 유형입니다. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| kind |
string:
azure |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
AzureBlobKnowledgeSourceParameters
Azure Blob Storage 기술 자료에 대한 매개 변수입니다.
| 속성 | 형식 | Default value | Description |
|---|---|---|---|
| connectionString |
string |
키 기반 연결 문자열 또는 관리 ID를 사용하는 경우 ResourceId 형식입니다. |
|
| containerName |
string |
Blob Storage 컨테이너의 이름입니다. |
|
| createdResources |
object |
지식 소스에서 만든 리소스입니다. |
|
| folderPath |
string |
컨테이너 내의 선택적 폴더 경로입니다. |
|
| graphExtraction |
Graph extraction configuration for Azure Blob knowledge sources. 첫 번째 인덱싱 실행 전에 소스에서 네이티브 Blob 소프트 삭제를 구성하세요. 이 워크플로우에서는 ADLS Gen2, ACL 인제스팅, 민감도 라벨 인제스팅이 지원되지 않습니다. |
||
| ingestionParameters |
모든 일반 수집 설정을 통합합니다. |
||
| 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 |
제공된 deploymentId 경로에 배포되는 포함 모델의 이름입니다. |
|
| resourceUri |
string (uri) |
Azure OpenAI 리소스의 리소스 URI입니다. |
BalancedVectorQueryTopicGraph
순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
balanced |
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지. |
| minDiversityPoolSize |
integer (int32) minimum: 250maximum: 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: 0maximum: 1 |
주제 그래프 다양성 검색에 사용되는 다양성 계수. 생략하면 주제 그래프 프로필에 설정된 기본값이 사용됩니다. |
| kind |
string:
diverse |
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지. |
| minDiversityPoolSize |
integer (int32) minimum: 250maximum: 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 |
오류 추가 정보 |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상. |
ErrorResponse
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
| 속성 | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
FabricDataAgentKnowledgeSource
Fabric Data Agent 지식 소스 구성
| 속성 | 형식 | Description |
|---|---|---|
| @odata.etag |
string |
지식의 원천 ETag. |
| description |
string |
선택적 사용자 정의 설명입니다. |
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| fabricDataAgentParameters |
Fabric Data Agent 지식 소스의 매개변수. |
|
| kind |
string:
fabric |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
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 |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| fabricOntologyParameters |
Fabric 온톨로지 지식 소스의 매개변수입니다. |
|
| kind |
string:
fabric |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
FabricOntologyKnowledgeSourceParameters
Fabric Ontology 지식 출처를 위한 매개변수.
| 속성 | 형식 | Description |
|---|---|---|
| ontologyId |
string |
Fabric 작업 공간에서 사용할 온톨로지의 ID. |
| workspaceId |
string |
온톨로지를 포함하는 Fabric 작업 공간 ID입니다. |
FileKnowledgeSource
직접 파일 업로드 및 인덱싱을 지원하는 파일 지식 소스 설정.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.etag |
string |
지식의 원천 ETag. |
| corsOptions |
파일 지식 소스의 파일 엔드포인트(업로드, 목록, 업데이트, 삭제)에 대한 교차 출처 자원 공유(CORS) 제어 옵션. |
|
| description |
string |
선택적 사용자 정의 설명입니다. |
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| fileParameters |
파일 지식 소스의 매개변수. |
|
| kind |
string:
file |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
FileKnowledgeSourceParameters
파일 지식 소스 매개변수.
| 속성 | 형식 | Description |
|---|---|---|
| createdResources |
object |
파일 지식 소스가 생성한 리소스. |
| ingestionParameters |
파일 지식 소스의 모든 일반 인제스 설정을 통합하며, 콘텐츠 추출 모드와 선택적 embeddingModel을 포함합니다. |
FreshnessPolicy
신선도 인식 검색을 위한 구성. 설정이 완료되면 새 문서는 검색 시 순위 상승을 받습니다.
| 속성 | 형식 | Description |
|---|---|---|
| boostingDuration |
string |
신선도 증진 기간에 대한 ISO 8601 기간(예: 'P90D' 90일). 이 기간보다 더 긴 문서는 검색 시 순위가 상승합니다. |
IndexedOneLakeKnowledgeSource
OneLake 기술 자료에 대한 구성입니다.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.etag |
string |
지식의 원천 ETag. |
| description |
string |
선택적 사용자 정의 설명입니다. |
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| indexedOneLakeParameters |
지식 소스에 대한 매개변수입니다. |
|
| kind |
string:
indexed |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
IndexedOneLakeKnowledgeSourceParameters
OneLake 기술 자료에 대한 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| createdResources |
object |
지식 소스에서 만든 리소스입니다. |
| fabricWorkspaceId |
string |
OneLake 작업 영역 ID입니다. |
| ingestionParameters |
모든 일반 수집 설정을 통합합니다. |
|
| 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 |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| indexedSharePointParameters |
지식 소스에 대한 매개변수입니다. |
|
| kind |
string:
indexed |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
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 |
액세스할 SharePoint 라이브러리를 지정합니다. |
|
| createdResources |
object |
지식 소스에서 만든 리소스입니다. |
| ingestionParameters |
모든 일반 수집 설정을 통합합니다. |
|
| query |
string |
SharePoint 콘텐츠를 필터링하는 선택적 쿼리입니다. |
IndexedSqlKnowledgeSource
인덱스화된 SQL 지식 소스 설정.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.etag |
string |
지식의 원천 ETag. |
| description |
string |
선택적 사용자 정의 설명입니다. |
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| indexedSqlParameters |
SQL 지식 소스의 매개변수입니다. |
|
| kind |
string:
indexed |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
IndexedSqlKnowledgeSourceParameters
인덱스 SQL 지식 소스의 매개변수.
| 속성 | 형식 | Description |
|---|---|---|
| connectionString |
string |
Azure SQL Database 또는 SQL Managed Instance의 연결 문자열입니다. |
| contentColumns |
콘텐츠 필드에 대한 선택적 컬럼 매핑. 만약 이 열을 누락하면 모든 열이 자동 발견됩니다. |
|
| createdResources |
object |
지식 소스에서 만든 리소스입니다. |
| embeddingColumns |
벡터장 삽입을 위한 선택적 열(column) 매핑. 생략하면 벡터장이 생성되지 않습니다. |
|
| highWaterMarkColumnName |
string |
고수표 변경 감지를 위한 선택적 열명 사용. 제공된다면 HighWaterMarkChangeDetectionPolicy를 사용하세요. |
| ingestionParameters |
임베딩 모델, 스케줄, 아이덴티티를 포함한 모든 일반 인제트 설정을 통합합니다. |
|
| tableOrView |
string |
색인할 테이블 또는 뷰의 이름. 스키마 자격을 부여할 수 있습니다(예: 'dbo. MyTable'). |
IndexingSchedule
인덱서 실행 일정을 나타냅니다.
| 속성 | 형식 | Description |
|---|---|---|
| interval |
string (duration) |
인덱서 실행 사이의 시간 간격입니다. |
| startTime |
string (date-time) |
인덱서가 실행을 시작해야 하는 시간입니다. |
KnowledgeBaseAzureOpenAIModel
쿼리 계획을 수행하는 데 사용되는 Azure OpenAI 리소스를 지정합니다.
| 속성 | 형식 | Description |
|---|---|---|
| azureOpenAIParameters |
Azure OpenAI parameters. |
|
| kind |
string:
azure |
쿼리 계획에 사용할 AI 모델입니다. |
KnowledgeBaseMicrosoftRetriever1Model
쿼리 계획 및 검색에 사용되는 Microsoft Retriever 1을 지정합니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
microsoft |
쿼리 계획에 사용할 AI 모델입니다. |
KnowledgeBaseModelKind
쿼리 계획에 사용할 AI 모델입니다.
| 값 | Description |
|---|---|
| azureOpenAI |
쿼리 계획에 Azure Open AI 모델을 사용합니다. |
| openAICompatible |
지식 기반 검색이나 지식 소스 이미지 구체화를 위해 고객이 직접 제어하는 OpenAI 호환 엔드포인트를 사용하세요. |
| microsoftRetriever1 |
쿼리 계획 및 검색을 위해 Microsoft Retriever 1을 사용하세요. |
KnowledgeBaseOpenAICompatibleModel
지식 기반 검색이나 최소 모드 지식 소스 이미지 구체화를 위한 고객 제어 OpenAI 호환 모델을 지정합니다. 검색 시 모델 프로필은 채팅 완료 또는 응답을 선택합니다. Standard/CU 추출이나 웹 지식 소스가 포함된 지식 베이스에는 지원되지 않습니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
open |
쿼리 계획에 사용할 AI 모델입니다. |
| openAICompatibleParameters |
OpenAI 호환 엔드포인트의 연결 및 인증 매개변수. |
KnowledgeBaseOpenAICompatibleParameters
OpenAI 호환 채팅 완료 또는 응답 엔드포인트의 연결 매개변수. 생성하려면 비어 있지 않은 헤더 또는 managedIdentityAudience 중 정확히 하나가 필요합니다. 업데이트는 변경 없는 연결 및 모델 프로필에 대한 자격 증명을 유지하기 위해 헤더를 생략할 수 있습니다.
| 속성 | 형식 | Description |
|---|---|---|
| authIdentity | SearchIndexerDataIdentity: |
managedIdentityAudience 토큰을 획득하는 데 사용된 사용자 할당 관리 신원입니다. 검색 서비스의 시스템 할당 신원을 사용하지 않습니다. managedIdentityAudience에서만 허용됩니다. |
| headers |
object (password) |
엔드포인트 인증을 위한 비어 있지 않은 HTTP 헤더가 저장됩니다. 이름과 값 모두 비밀이며 응답에서 절대 반환되지 않습니다. 빈 지도는 유효하지 않습니다. managedIdentityAudience 및 authIdentity와 상호 독점적입니다. 업데이트 시, 생략된 헤더는 동일한 리소스와 모델 바인딩에서만 보존되며, 이는 정확한 엔드포인트, 모델 프로필 및 인증 ID가 변경되지 않은 경우에만 적용됩니다; 그렇지 않으면 새로운 자격 증명을 제공하세요. |
| managedIdentityAudience |
string |
관리형 신원 인증을 위한 고객의 서드파티 Microsoft Entra 애플리케이션의 기본 애플리케이션 GUID. api:// 접두사나 /.default 접미사는 포함하지 마십시오. 헤더와 상호 배타적인 경우. |
| modelName |
검색의 기능과 한계를 결정하는 지원되는 채팅 모델 이름입니다. 지식 소스 이미지 구상의 경우, 이는 요청 본문의 모델 선택자로 전송됩니다; URI 경로는 이 이름과 관계없이 채팅 완료 또는 응답을 선택합니다. 지식 기반 검색을 위해 GPT-6 모델 프로필은 응답을 사용하고, 기존 모델 프로필은 채팅 완료를 사용합니다; 엔드포인트는 선택한 프로토콜을 지원해야 하며, 응답에 대한 상태 없는 도구 연속성을 포함해야 합니다. 검색 요청 본문은 모델을 생략합니다; URI 또는 게이트웨이는 실제 모델을 선택하고 필요한 공급자 모델 식별자를 제공합니다. 임베딩 모델과 임의 공급자 프로토콜은 지원되지 않습니다. |
|
| uri |
string (uri) |
경로 및 쿼리 매개변수를 포함한 완전한 HTTPS POST URL. 경로나 API 버전을 추가하지 않고 변경 없이 전송됨; 리디렉션은 따르지 않습니다. 지식 기반 검색을 위해서는 엔드포인트가 모델 프로필의 채팅 완료 또는 응답 프로토콜을 수용해야 합니다. 지식 소스 이미지 구체화를 위해 URI 경로는 /chat/completions 또는 /response로 끝나야 합니다; 쿼리 매개변수는 프로토콜을 선택하지 않습니다. |
KnowledgeSourceAzureOpenAIVectorizer
쿼리 문자열을 벡터화하는 데 사용되는 Azure OpenAI 리소스를 지정합니다.
| 속성 | 형식 | Description |
|---|---|---|
| azureOpenAIParameters |
Azure OpenAI 포함 벡터화와 관련된 매개 변수를 포함합니다. |
|
| kind |
string:
azure |
벡터 검색에 사용하도록 구성되는 벡터화 메서드의 이름입니다. |
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 |
추출된 엔티티를 해석하는 데 사용되는 선택적 그라운딩 소스. |
||
| ontology |
트리플을 추출하는 데 사용된 온톨로지. 생성 시 없거나 null인 경우, 구성된 강화 캐시를 통해 삼중 추출 없이도 검색 가능한 청크와 캐시 강화가 생성됩니다. 일단 온톨로지가 부착되면 제거할 수 없습니다. 별도의 온톨로지 변경은 동기화가 활성화되지 않을 때까지 기다려야 합니다. |
||
| pageDegreeOfParallelism |
integer (int32) minimum: 1maximum: 1024 |
128 |
그래프 추출을 위해 병렬로 처리되는 최대 페이지 수. |
KnowledgeSourceGraphGrounding
그래프 추출을 위한 접지 소스. 동일 서비스 검색 인덱스만 지원됩니다.
| 속성 | 형식 | Default value | Description |
|---|---|---|---|
| index |
접지에 사용되는 동일 서비스 검색 인덱스입니다. searchIndex 소스에 필수입니다. |
||
| kind | searchIndex |
근원 종류. 생략하면 searchIndex가 적용된다고 가정합니다. 다른 종류들은 거부됩니다. |
KnowledgeSourceGraphGroundingIndex
추출된 엔티티를 접지시키는 데 사용되는 검색 인덱스를 식별합니다.
| 속성 | 형식 | Description |
|---|---|---|
| indexName |
string |
접지 검색 인덱스의 이름입니다. |
| vectorFieldName |
string |
벡터 조회가 구성될 때 접지에 사용되는 벡터 필드의 이름입니다. |
KnowledgeSourceGraphGroundingSourceKind
그라운딩 참조를 위한 명시적 출처 유형. searchIndex만 지원됩니다.
| 값 | Description |
|---|---|
| searchIndex |
동일한 검색 서비스 내의 검색 인덱스. |
KnowledgeSourceGraphOntology
그래프 추출을 위한 인라인 온톨로지. 지원되는 유일한 출처는 요청서에 직접 제공된 제한된 JSON-LD 문서입니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
근원 종류. "인라인"만 지원됩니다. |
|
| name |
string |
온톨로지에 대한 선택적 고객이 제공한 이름이 다시 메 |
| value |
string |
JSON으로 인코딩된 문자열로 제공되는 제한된 JSON-LD 1.1 온톨로지 문서(플랫 클래스 및 객체/데이터타입 속성). |
KnowledgeSourceGraphOntologySourceKind
온톨로지 참조의 명시적 소스 종류. "인라인"만 지원됩니다.
| 값 | Description |
|---|---|
| inline |
요청서에 인라인으로 제공되는 온톨로지 콘텐츠는 제한된 JSON-LD 문서로 제공됩니다. |
KnowledgeSourceIngestionParameters
참조 자료에 대한 모든 일반 수집 설정을 통합합니다.
| 속성 | 형식 | Default value | Description |
|---|---|---|---|
| aiServices |
콘텐츠 처리를 위한 선택적 AI 서비스 구성입니다. |
||
| assetStore |
이미지와 같은 추출된 자산을 저장하는 선택적 자산 저장소 설정. |
||
| cache |
Enrichment cache configuration for Azure Blob graph extraction. Blob 및 Table 엔드포인트와 재처리가 활성화된 GPv2 스토리지 계정이 필요합니다. 한 번 구성되면 캐시는 제거할 수 없으며, 저장 바인딩이나 식별 자체를 변경할 수 없습니다. |
||
| chatCompletionModel | KnowledgeBaseModel: |
이미지 언어화 또는 컨텍스트 추출을 위한 선택적 채팅 완료 모델입니다. |
|
| contentExtractionMode |
enum:
|
minimal |
선택적 콘텐츠 추출 모드. 기본값은 '최소'입니다. |
| disableImageVerbalization |
boolean |
False |
이미지 언어화를 사용하지 않도록 설정해야 하는지 여부를 나타냅니다. 기본값은 false입니다. |
| embeddingModel | KnowledgeSourceVectorizer: |
콘텐츠를 벡터화하기 위한 선택적 벡터화기 구성입니다. |
|
| freshnessPolicy |
검색을 새로운 문서에 편향하기 위한 선택적 신선성 정책. |
||
| identity | SearchIndexerDataIdentity: |
이 지식 소스에 사용할 명시적 ID입니다. |
|
| ingestionPermissionOptions |
문서 콘텐츠와 함께 수집할 권한 유형의 선택적 목록입니다. 지정된 경우 데이터 원본에 대한 인덱서 권한 옵션을 설정합니다. |
||
| ingestionSchedule |
데이터 수집에 대한 선택적 일정입니다. |
||
| networkAccessMode | 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:
open |
벡터 검색에 사용하도록 구성되는 벡터화 메서드의 이름입니다. |
| openAICompatibleParameters |
연결, 인증 및 임베딩 프로필 매개변수. |
KnowledgeSourceResultsProcessing
지식 소스의 결과가 재순위화되는지 여부를 통제합니다.
| 값 | Description |
|---|---|
| rerank |
이 지식 소스의 결과는 재순위 파이프라인을 거칩니다. 기본 동작입니다. |
| none |
이 지식 소스의 결과는 재순위를 거치지 않고 기본 순서를 유지합니다. |
McpServerAuthenticationKind
MCP 서버용 인증 방식입니다.
| 값 | Description |
|---|---|
| foundryConnection |
Azure AI Foundry 연결을 통해 인증하세요. |
| storedHeaders |
저장된 HTTP 헤더를 사용해 인증하세요. |
McpServerAutoOutputParsing
출력 형식을 자동으로 감지하고 그에 맞게 파싱합니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
auto |
어떤 종류의 출력 파싱을 적용해야 할지. |
McpServerFoundryConnectionAuthentication
Azure AI Foundry 연결을 통한 인증.
| 속성 | 형식 | Description |
|---|---|---|
| foundryConnectionParameters |
파운드리 연결 인증을 위한 매개변수. |
|
| kind |
string:
foundry |
어떤 종류의 인증 방식을 사용해야 할까요? |
McpServerFoundryConnectionParameters
파운드리 연결 인증을 위한 매개변수.
| 속성 | 형식 | Description |
|---|---|---|
| connectionId |
string |
Azure AI Foundry 연결 식별자. |
McpServerJsonOutputParsing
생성된 JSON 매개변수를 사용하여 출력을 JSON 문서로 파싱합니다.
| 속성 | 형식 | Description |
|---|---|---|
| jsonParameters |
JSON 출력 파싱을 위한 매개변수들. 종류가 'json'일 때 필수입니다. |
|
| kind |
string:
json |
어떤 종류의 출력 파싱을 적용해야 할지. |
McpServerKnowledgeSource
MCP(모델 컨텍스트 프로토콜) 서버가 지원하는 지식 소스 구성.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.etag |
string |
지식의 원천 ETag. |
| description |
string |
선택적 사용자 정의 설명입니다. |
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| kind |
string:
mcp |
지식 소스의 유형입니다. |
| mcpServerParameters |
MCP 서버 지식 소스의 매개변수. |
|
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
McpServerKnowledgeSourceParameters
MCP 서버 지식 소스의 매개변수.
| 속성 | 형식 | Description |
|---|---|---|
| authentication | McpServerAuthentication: |
MCP 서버의 인증 구성. |
| serverURL |
string |
MCP 서버 엔드포인트의 URL입니다. |
| tools |
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 |
사용할 언어 코드를 나타내는 값입니다. 기본값은 |
|
| maximumPageLength |
integer (int32) |
페이지당 최대 문자 수. |
| maximumPagesToTake |
integer (int32) |
출력에서 가져갈 수 있는 최대 페이지 수. |
| pageOverlapLength |
integer (int32) |
페이지 간에 겹치는 문자 수. |
| textSplitMode |
텍스트 분할 모드를 사용하세요. |
McpServerSplitOutputParsing
출력을 설정한 분할 매개변수를 사용해 페이지로 나누세요.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
split |
어떤 종류의 출력 파싱을 적용해야 할지. |
| splitParameters |
분할 출력 파싱을 위한 매개변수. |
McpServerStoredHeadersAuthentication
저장된 HTTP 헤더를 이용한 인증.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
stored |
어떤 종류의 인증 방식을 사용해야 할까요? |
| storedHeadersParameters |
저장된 헤더 인증에 대한 매개변수. |
McpServerStoredHeadersParameters
저장된 헤더 인증에 대한 매개변수.
| 속성 | 형식 | Description |
|---|---|---|
| headers |
object |
MCP 서버 요청에 포함하는 저장된 HTTP 헤더들. |
McpServerTool
MCP 서버 지식 소스 내의 단일 도구를 나타냅니다.
| 속성 | 형식 | Description |
|---|---|---|
| maxOutputTokens |
integer (int32) |
이 도구의 출력에 대해 선택적으로 파싱 후 토큰 제한을 설정할 수 있습니다. 명시된 경우 0보다 커야 합니다. |
| name |
string |
호출할 MCP 도구의 이름입니다. |
| outputParsing | McpServerOutputParsing: |
도구의 출력을 해석하는 선택적 설정. |
| resultsProcessing |
이 도구에서 파싱된 결과가 재순위화되는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
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 |
네이티브 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 |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| kind |
string:
remote |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| remoteSharePointParameters |
원격 SharePoint 지식 소스의 매개변수입니다. |
|
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
RemoteSharePointKnowledgeSourceParameters
원격 SharePoint 참조 자료에 대한 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| containerTypeId |
string |
SharePoint Embedded 연결에 대한 컨테이너 ID입니다. null이면 SharePoint Online을 사용합니다. |
| filterExpression |
string |
쿼리가 실행되기 전에 검색 범위를 지정하기 위한 쿼리 가능한 SharePoint 속성 및 특성이 있는 KQL(키워드 쿼리 언어) 식입니다. |
| resourceMetadata |
string[] |
응답의 각 항목에 대해 반환될 메타데이터 필드 목록입니다. 검색 가능한 메타데이터 속성만 이 목록에 포함될 수 있습니다. 기본적으로 메타데이터는 반환되지 않습니다. |
SearchIndexerDataNoneIdentity
데이터 원본의 ID 속성을 지웁니다.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
ID 유형을 지정하는 URI 조각입니다. |
SearchIndexerDataUserAssignedIdentity
사용할 데이터 원본의 ID를 지정합니다.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
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 |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| kind |
string:
search |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
|
| searchIndexParameters |
지식 소스에 대한 매개변수입니다. |
SearchIndexKnowledgeSourceBoostKind
검색 지수 지식 소스에 대한 부스트 팁 같은 것.
| 값 | Description |
|---|---|
| fieldValue |
필드 값을 기반으로 문서를 부스트하세요. |
| multiWordExpression |
여러 단어 표현식을 기반으로 문서를 강화하세요. |
SearchIndexKnowledgeSourceFieldValueBoost
필드 값에 따라 문서를 강화하는 힌트입니다.
| 속성 | 형식 | Description |
|---|---|---|
| boost |
number (double) |
문서 점수의 배수입니다. 1.0과 같지 않은 양수여야 합니다. |
| boostInstructions |
string |
부스트를 언제 어떻게 적용해야 하는지 설명하는 자연어 지침. |
| field |
string minLength: 1 |
검색 인덱스 필드의 이름입니다. |
| fieldValues |
string[] |
필드의 대표 값. |
| kind |
string:
field |
그런 종류의 부스트 힌트. |
SearchIndexKnowledgeSourceFilterHint
필드를 식별하는 힌트와 쿼리 플래너가 필터를 구성할 때 사용할 수 있는 포괄적인 근지 값입니다.
| 속성 | 형식 | Description |
|---|---|---|
| autoConfiguration |
필드의 측면에서 접지 값을 해결하도록 서비스를 구성합니다. 이 기능이 있으면 자동 구성을 가능하게 합니다. 필드는 필터링 가능하고 페이스팅 가능해야 합니다. 대상 인덱스에 문서 수준 권한이나 Purview 민감도 라벨이 활성화된 경우에는 지원되지 않습니다; 이 제한은 지식 소스 생성/업데이트 및 지식 기반 검색 시점에 검증됩니다.
|
|
| field |
string minLength: 1 |
필터링 가능한 검색 인덱스 필드의 이름입니다. |
| fieldValues |
string[] |
해당 분야에 대한 포괄적인 값 집합. 최대 160개의 값, 값당 최대 128자, 합산 2048자까지. 를 지원하는 |
| filterInstructions |
string |
필드에서 언제 어떻게 필터링할지 설명하는 자연어 지침. |
SearchIndexKnowledgeSourceFilterHintAutoConfiguration
대상 인덱스 측면에서 필터 힌트의 그라운딩 값을 자동으로 분해하도록 구성합니다.
| 속성 | 형식 | Description |
|---|---|---|
| cacheTtl |
integer (int32) minimum: 60maximum: 3600 |
해결된 페이스트 값의 초수 수가 캐시됩니다. 허용 범위는 전용 서비스에서 60에서 3600까지, 서버리스 서비스에서는 60에서 900까지입니다. 생략 시 전용 서비스에서는 3600초, 서버리스 서비스에서는 900초로 기본 설정됩니다. |
| maxFacetValueCount |
integer (int32) minimum: 1maximum: 64 |
접지로 사용할 최대 면(facet) 값 수. 기본값은 64입니다; 허용 범위는 1부터 64까지입니다. 값은 수제 필터 값과 동일한 2048자 결합 길이 제한과 값당 128자 제한을 적용받으며, 패셋 수 순서로 선택됩니다. |
SearchIndexKnowledgeSourceMultiWordExpressionBoost
여러 단어 표현을 기반으로 문서를 강화하는 힌트입니다.
| 속성 | 형식 | Description |
|---|---|---|
| boost |
number (double) |
문서 점수의 배수입니다. 1.0과 같지 않은 양수여야 합니다. |
| boostInstructions |
string |
부스트를 언제 어떻게 적용해야 하는지 설명하는 자연어 지침. |
| fieldValues |
string[] |
부스트의 대표 값입니다. |
| kind |
string:
multi |
그런 종류의 부스트 힌트. |
SearchIndexKnowledgeSourceParameters
검색 인덱스 지식 원본에 대한 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| baseFilter |
string |
검색 시점에 인덱스에 기본 필터 조건이 적용됩니다(예: '상태 eq VA'). 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다. |
| queryHints |
쿼리 계획을 안내하는 기본 힌트, 유용한 필터와 검색 정보 출처 향상을 위한 도움말입니다. 요청 시 쿼리 힌트가 이러한 기본값을 완전한 객체로 대체합니다. |
|
| searchFields |
검색 인덱스에서 검색할 필드를 제한하는 데 사용됩니다. |
|
| searchIndexName |
string |
검색 인덱스의 이름입니다. |
| semanticConfigurationName |
string |
대상 검색 인덱스에서 기본 구성이 아닌 다른 의미 체계 구성을 지정하는 데 사용됩니다. |
| sourceDataFields |
참조된 원본 데이터에 대한 추가 필드를 요청하는 데 사용됩니다. |
|
| topicGraph | VectorQueryTopicGraph: |
이 검색 인덱스 지식 소스의 기본 주제 그래프 벡터 검색 옵션입니다. |
SearchIndexKnowledgeSourceQueryHints
검색 색인 지식 소스를 위한 유용한 필터와 향상을 위한 쿼리 계획을 안내하는 힌트들.
| 속성 | 형식 | Description |
|---|---|---|
| boosts | SearchIndexKnowledgeSourceBoost[]: |
쿼리 플래너가 문서 순위에 영향을 줄 수 있는 조건을 식별하는 힌트를 강화하세요. |
| filters |
쿼리 플래너가 필터를 구성할 때 사용할 수 있는 필드와 대표 값을 식별하는 필터 힌트. |
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는 |
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 |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| kind |
string:
web |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
|
| webParameters |
웹 지식 소스에 대한 매개 변수입니다. |
WebKnowledgeSourceDomain
웹 지식 원본 도메인에 대한 구성입니다.
| 속성 | 형식 | Description |
|---|---|---|
| address |
string |
도메인의 주소입니다. |
| includeSubpages |
boolean |
이 도메인의 하위 페이지를 포함할지 여부입니다. |
WebKnowledgeSourceDomains
웹 지식 원본에 대한 도메인 허용/차단 구성입니다.
| 속성 | 형식 | Description |
|---|---|---|
| allowedDomains |
웹 결과에 허용되는 도메인들. |
|
| blockedDomains |
웹 결과에서 차단된 도메인들. |
WebKnowledgeSourceParameters
웹 지식 소스에 대한 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| count |
integer (int32) |
기본 웹 결과 수. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다. |
| domains |
웹 결과에 대한 도메인 허용/차단 구성입니다. |
|
| freshness |
string |
웹 결과의 기본 신선도 필터입니다. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다. |
| language |
string |
웹 결과의 기본 언어입니다. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다. |
| market |
string |
웹 결과의 기본 시장입니다. 쿼리 시점에 지식 소스 런타임 매개변수를 통해 덮어쓸 수 있습니다. |
WorkIQKnowledgeSource
WorkIQ 지식 소스 설정.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.etag |
string |
지식의 원천 ETag. |
| description |
string |
선택적 사용자 정의 설명입니다. |
| encryptionKey |
Azure Key Vault에서 만드는 암호화 키에 대한 설명입니다. 이 키는 지식 소스 정의에 대해 아무도, 심지어 마이크로소프트도 복호화할 수 없다는 완전한 확신을 원할 때 추가적인 암호화 상태를 제공하는 데 사용됩니다. 지식 소스 정의를 암호화한 후에는 항상 암호화된 상태로 유지됩니다. 검색 서비스는 이 속성을 null로 설정하려는 시도를 무시합니다. 암호화 키를 회전시키고 싶을 때 필요에 따라 이 속성을 변경할 수 있습니다; 지식 소스 정의는 영향을 받지 않을 것입니다. 고객 관리형 키를 사용한 암호화는 무료 검색 서비스에 사용할 수 없으며 2019년 1월 1일 이후 생성된 유료 서비스에만 사용할 수 있습니다. |
|
| kind |
string:
workIQ |
지식 소스의 유형입니다. |
| name |
string |
참조 자료의 이름입니다. |
| resultsProcessing |
이 지식 소스의 결과가 최종 결과 세트에 포함되기 전에 재순위가 매겨지는지 제어합니다. 명시되지 않은 경우 기본값은 '재배치'로 전환됩니다. |
|
| workIQParameters |
WorkIQ 지식 소스의 매개변수, 즉 인증 대신에 사용되는 고객 소유의 Entra 앱 구성 등이 포함됩니다. |
WorkIQKnowledgeSourceParameters
WorkIQ 지식 소스의 매개변수.
| 속성 | 형식 | Description |
|---|---|---|
| entraAppAuthentication |
고객 소유의 Microsoft Entra 앱 등록 구성은 Work IQ API를 대리하여 인증하는 데 사용됩니다. 고객은 임차인 소유의 Entra 앱을 등록하고, WorkIQAgent.Ask delegated 권한을 부여하며, Azure AI 검색가 저장된 클라이언트 비밀 없이 해당 앱으로 인증할 수 있도록 연합 자격 증명을 설정합니다. |