Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te funkcje lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Ważna
Funkcje lub możliwości oznaczone (wersja zapoznawcza) w tym artykule znajdują się w publicznej wersji zapoznawczej i podlegają dodatkowym warunkom użytkowania Microsoft Azure w wersji zapoznawczej. Aby uzyskać terminy wersji zapoznawczej specyficzne dla IQ usługi Foundry (Wyszukiwanie AI platformy Azure), zobacz Funkcje wersji zapoznawczej.
Źródło wiedzy pliku przekazuje zestawy plików od małych do średnich bezpośrednio do funkcji IQ usługi Foundry na potrzeby pobierania agenta. Źródła wiedzy są tworzone niezależnie, uwzględniane w bazie wiedzy i używane jako dane źródłowe, gdy baza wiedzy jest odpytywana w czasie działania.
Źródła wiedzy dotyczące plików są przydatne, gdy chcesz korzystać z zarządzanego środowiska przekazywania zamiast aprowizować Azure Storage, konfigurować dostęp i tworzyć potok indeksatora za pośrednictwem kontenera zewnętrznego. Foundry IQ przetwarza przekazane pliki, aby ich wyodrębniona zawartość mogła być pobierana z bazy wiedzy.
Zamiast tego użyj źródła wiedzy typu blob, gdy pliki znajdują się już w usłudze Azure Blob Storage lub Azure Data Lake Storage Gen2, gdy zestaw plików przekracza lub prawdopodobnie przekroczy limity źródła wiedzy plików, albo gdy potrzebujesz planowego pozyskiwania danych. Użyj również źródła wiedzy obiektu blob, jeśli chcesz zarządzać źródłowymi obiektami blob przy użyciu zasad zarządzania cyklem życia Azure Blob Storage lub gdy potrzebujesz uprawnień na poziomie dokumentu na podstawie uprawnień w Azure Storage.
Wsparcie użytkowania
| Azure portal | portal Microsoft Foundry | zestaw SDK .NET | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Wymagania wstępne
Usługa Foundry IQ w dowolnym regionie, który zapewnia wyszukiwanie agentowe. Źródła wiedzy dotyczące plików obsługują modele cen dedykowane i bezserwerowe. Aby uzyskać szczegółowe informacje o modelu i warstwie, zobacz Wybieranie modelu cenowego i warstwy usług.
Zapoznaj się z kosztami Foundry IQ. Wywołania modelu, wektoryzacja i inne przetwarzanie sztucznej inteligencji mogą powodować naliczanie oddzielnych opłat.
W środowisku Serverless pomyślne operacje przesyłania plików zużywają płatne zasoby obliczeniowe. Nieudane przekazywanie nie powoduje naliczania opłat za zasoby obliczeniowe bezserwerowe.
Jeśli potrzebujesz płatnego wyszukiwania agentowego po przekroczeniu miesięcznego bezpłatnego limitu, włącz plan standardowy wyszukiwania agentowego. Ustawienie
knowledgeRetrieval=standardjest niezależne od opłat za bezserwerowe zasoby obliczeniowe i magazynowanie i nie służy do wyboru modelu cenowego.Pliki w obsługiwanym formacie.
Uprawnienie do tworzenia źródeł wiedzy. Skonfiguruj uwierzytelnianie bez klucza przy użyciu roli Współautor usługi wyszukiwania przypisanej do konta użytkownika (zalecane) lub użyj klucza interfejsu API administratora.
W przypadku wywołań z użyciem tożsamości zarządzanej do osadzeń Azure OpenAI należy przypisać rolę Cognitive Services OpenAI User do wybranej tożsamości w zasobie Azure OpenAI lub nadrzędnym zasobie Foundry, który odpowiada elementowi
resourceUri. Wyodrębnianie w usłudze Content Understanding wymaga oddzielnych uprawnień. Zobacz Przypisywanie roli.Jeśli zasób Foundry ma wyłączony dostęp do sieci publicznej, użyj kwalifikującej się usługi dedykowanej, aby utworzyć
foundry_accountshared private link do zasobu Foundry. Pozostaw włączone ustawienie zasobu Zezwalaj usługom Azure na liście zaufanych usług. Funkcja Serverless nie obsługuje tej konfiguracji udostępnionego łącza prywatnego. Aby uzyskać informacje na temat obsługiwanych mechanizmów kontroli dostępu do publicznego punktu końcowego, zobacz Obwód zabezpieczeń sieciowych; taki obwód nie tworzy połączenia prywatnego.Sprawdź konfigurację źródła wiedzy i macierz warstwy. Przesyłanie plików nie tworzy indeksatora, więc zastąpienie ustawień sieci dla wygenerowanego indeksatora nie ma zastosowania.
Jeśli źródło wiedzy określa
standardtryb wyodrębniania zawartości, zapoznaj się z wymaganiami dotyczącymi umiejętności Azure Content Understanding.- W przykładzie opisanym w tym artykule potrzebne są punkt końcowy i klucz zasobu Foundry, a także informacje o modelu osadzania Azure OpenAI oraz modelu ukończeń czatu.
Najnowszy pakiet
Azure.Search.Documentswersji zapoznawczej:dotnet add package Azure.Search.Documents --prereleaseW przypadku uwierzytelniania bezkluczowego pakiet
Azure.Identity:dotnet add package Azure.Identity
Najnowszy pakiet
azure-search-documentswersji zapoznawczej:pip install --pre azure-search-documentsW przypadku uwierzytelniania bezkluczowego pakiet
azure-identity:pip install azure-identity
Wersja 2026-10-01 interfejsu API REST usługi wyszukiwania.
W przypadku uwierzytelniania bez klucza dołącz token Microsoft Entra ID w nagłówku
Authorizationkażdego żądania HTTP.
Obsługa plików i limity
Przed utworzeniem źródła wiedzy o pliku zapoznaj się z wymaganiami i limitami, które mają wpływ na przekazywanie, wyodrębnianie i zarządzanie plikami.
Obsługiwane typy zawartości
Usługa Foundry IQ wykrywa typ MIME z bajtów plików.
minimal wyodrębnianie akceptuje obsługiwane formaty dokumentów, w tym wykryte text/* typy.
standardwyodrębnianie obsługuje bardziej ograniczony zestaw oparty na formatach plików obsługiwanych przez umiejętność Azure Content Understanding. Obrazy wymagają ekstrakcji standard i wykrytego, obsługiwanego formatu.
Obsługiwane tryby wyodrębniania
minimal używa wbudowanego wyodrębniania i jest wartością domyślną.
standard wysyła każdy plik za pośrednictwem usługi Content Understanding i wymaga konfiguracji aiServices.
- Zawartość wykryta jako
image/*nie jest obsługiwana w programie2026-05-01-preview. W pliku2026-10-01użyj wyodrębnianiastandard. Ekstrakcjaminimalzwraca kod stanu HTTP415w obu wersjach.
Limity i operacje na plikach
Limity i obsługiwane operacje na plikach różnią się w zależności od wersji interfejsu API i metody pozyskiwania.
| Zdolność |
2026-11-01-preview asynchronicznie |
2026-10-01 synchroniczne |
2026-08-01-preview synchroniczne |
|---|---|---|---|
| Maksymalna liczba plików na źródło wiedzy | 10,000 | 200 | 200 |
| Maksymalny rozmiar pliku | 512 MiB | 50 MiB w warstwie Bezpłatna i Podstawowa; 100 MiB w innych obsługiwanych warstwach | 50 MiB w warstwie Bezpłatna i Podstawowa; 100 MiB w innych obsługiwanych warstwach Dedicated i Serverless |
| Czas trwania przetwarzania | Sonduj do momentu ukończenia | 180 sekund | 180 sekund |
Wygenerowany indeks wyszukiwania przechowuje przekazaną zawartość. Aby uzyskać łączne limity magazynu według warstwy cenowej, zobacz Limity usług. W przypadku skonfigurowania wektoryzacji obowiązują również limity modelu i dalszego przetwarzania.
Sprawdzanie istniejących źródeł wiedzy
Przykłady języka C# i Python używają zestawów SDK w wersji zapoznawczej z listopada. W przypadku żądań REST ustaw wartość {{api-version}} na 2026-11-01-preview.
Źródłem wiedzy jest obiekt najwyższego poziomu wielokrotnego użytku. Znajomość istniejących źródeł wiedzy jest przydatna w przypadku ponownego użycia lub nazewnictwa nowych obiektów.
Uruchom następujący kod, aby wyświetlić listę źródeł wiedzy według nazwy i typu.
// List knowledge sources by name and type
using Azure.Search.Documents.Indexes;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var knowledgeSources = indexClient.GetKnowledgeSourcesAsync();
Console.WriteLine("Knowledge Sources:");
await foreach (var ks in knowledgeSources)
{
Console.WriteLine($" Name: {ks.Name}, Type: {ks.GetType().Name}");
}
Reference:SearchIndexClient
# List knowledge sources by name and type
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
for ks in index_client.list_knowledge_sources():
print(f" - {ks.name} ({ks.kind})")
Reference:SearchIndexClient
### List knowledge sources by name and type
GET {{search-url}}/knowledgesources?api-version={{api-version}}&$select=name,kind
Authorization: Bearer {{token}}
Odwołanie:Źródła wiedzy — lista
Możesz również zwrócić pojedyncze źródło wiedzy według nazwy, aby przejrzeć jego definicję JSON.
using Azure.Search.Documents.Indexes;
using System.Text.Json;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
// Specify the knowledge source name to retrieve
string ksNameToGet = "earth-knowledge-source";
// Get its definition
var knowledgeSourceResponse = await indexClient.GetKnowledgeSourceAsync(ksNameToGet);
var ks = knowledgeSourceResponse.Value;
// Serialize to JSON for display
var jsonOptions = new JsonSerializerOptions
{
WriteIndented = true,
DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.Never
};
Console.WriteLine(JsonSerializer.Serialize(ks, ks.GetType(), jsonOptions));
Reference:SearchIndexClient
# Get a knowledge source definition
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
import json
index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
ks = index_client.get_knowledge_source("knowledge_source_name")
print(json.dumps(ks.as_dict(), indent = 2))
Reference:SearchIndexClient
### Get a knowledge source definition
GET {{search-url}}/knowledgesources('{{knowledge-source-name}}')?api-version={{api-version}}
Authorization: Bearer {{token}}
Odwołanie:Źródła wiedzy — pobieranie
Poniższy kod JSON to przykładowa odpowiedź dla źródła wiedzy pliku.
{
"name": "my-file-ks",
"kind": "file",
"description": "A sample file knowledge source.",
"encryptionKey": null,
"fileParameters": {
"ingestionParameters": {
"contentExtractionMode": "minimal",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "<REDACTED>",
"deploymentId": "text-embedding-3-large",
"modelName": "text-embedding-3-large"
}
}
}
}
}
Tworzenie źródła wiedzy
Utwórz plikowe źródło wiedzy, które określa model osadzeń używany do wektoryzacji przesłanej zawartości.
Każde źródło wiedzy o pliku tworzy indeks, ale nie indeksator ani harmonogram. Należy dołączyć obiekt fileParameters.ingestionParameters. Usługa odrzuca żądania określające wartość networkAccessMode.
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
using Azure.Search.Documents.KnowledgeBases.Models;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
var embeddingParams = new AzureOpenAIVectorizerParameters
{
ResourceUri = new Uri(aoaiEndpoint),
DeploymentName = aoaiEmbeddingDeployment,
ModelName = aoaiEmbeddingModel
};
var ingestionParams = new KnowledgeSourceIngestionParameters
{
ContentExtractionMode = "minimal",
EmbeddingModel = new KnowledgeSourceAzureOpenAIVectorizer
{
AzureOpenAIParameters = embeddingParams
}
};
var fileParams = new FileKnowledgeSourceParameters
{
IngestionParameters = ingestionParams
};
var knowledgeSource = new FileKnowledgeSource(
name: "my-file-ks",
fileParameters: fileParams
)
{
Description = "This knowledge source uses directly uploaded product manuals."
};
await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Reference:SearchIndexClient
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
AzureOpenAIVectorizerParameters,
FileKnowledgeSource,
FileKnowledgeSourceParameters,
)
from azure.search.documents.knowledgebases.models import (
KnowledgeSourceAzureOpenAIVectorizer,
KnowledgeSourceIngestionParameters,
)
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
embedding_params = AzureOpenAIVectorizerParameters(
resource_url="<aoai-endpoint>",
deployment_name="<aoai-embedding-deployment>",
model_name="<aoai-embedding-model>",
)
ingestion_params = KnowledgeSourceIngestionParameters(
content_extraction_mode="minimal",
embedding_model=KnowledgeSourceAzureOpenAIVectorizer(
azure_open_ai_parameters=embedding_params
),
)
knowledge_source = FileKnowledgeSource(
name="my-file-ks",
description="This knowledge source uses directly uploaded product manuals.",
file_parameters=FileKnowledgeSourceParameters(ingestion_parameters=ingestion_params),
)
index_client.create_or_update_knowledge_source(knowledge_source=knowledge_source)
Reference:SearchIndexClient
PUT {{searchEndpoint}}/knowledgesources('my-file-ks')?api-version=2026-10-01
Authorization: ******
Content-Type: application/json
Prefer: return=representation
{
"name": "my-file-ks",
"kind": "file",
"description": "This knowledge source uses directly uploaded product manuals.",
"encryptionKey": null,
"fileParameters": {
"ingestionParameters": {
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "{{aoai-endpoint}}",
"deploymentId": "{{aoai-embedding-deployment}}",
"modelName": "{{aoai-embedding-model}}"
}
},
"contentExtractionMode": "minimal"
}
}
}
Dokumentacja:Źródła wiedzy — tworzenie lub aktualizowanie
Oczekuj 201 dla nowego źródła (200 aktualizuje istniejące źródło). Odczytaj definicję ponownie, aby potwierdzić jej nazwę, typ i wygenerowany indeks.
GET {{searchEndpoint}}/knowledgesources('my-file-ks')?api-version=2026-10-01
Authorization: ******
Odwołanie:Źródła wiedzy
Skonfiguruj ekstrakcję standardową
Od wersji interfejsu API 2026-08-01-preview ekstrakcja standard wykorzystuje usługę Content Understanding do wyodrębniania danych, semantycznego dzielenia na fragmenty i wzbogacania przesłanych plików. Usługa Foundry IQ zarządza potokiem pozyskiwania danych, korzystając z zasobu Foundry określonego w aiServices.
Przykłady konfiguracji dla języków C# i Python korzystają z listopadowych wersji zapoznawczych zestawów SDK. W przykładzie REST użyto 2026-11-01-preview. Przed ich użyciem zapoznaj się z wymaganiami usługi Content Understanding .
konfiguracja standardowa może dodawać mapowania modeli dla całego konta do skonfigurowanego konta usługi Content Understanding. Przed utworzeniem lub zaktualizowaniem standardowego źródła sprawdź konfigurację udostępnioną. Minimalna konfiguracja nie konfiguruje tego konta ani nie używa poświadczeń modelu.
Ekstrakcja standardowa wiąże się z opłatami za usługę Content Understanding oraz, gdy włączona jest werbalizacja obrazu, z opłatami za korzystanie z modelu. Aby uzyskać więcej informacji, zobacz kontrolki rozliczeń i opisu obrazu.
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
using Azure.Search.Documents.KnowledgeBases.Models;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
var embeddingParameters = new AzureOpenAIVectorizerParameters
{
ResourceUri = new Uri(aoaiEndpoint),
DeploymentName = aoaiEmbeddingDeployment,
ModelName = aoaiEmbeddingModel
};
var ingestionParameters = new KnowledgeSourceIngestionParameters
{
ContentExtractionMode = KnowledgeSourceContentExtractionMode.Standard,
AiServices = new AIServices(new Uri(foundryEndpoint)) { ApiKey = foundryKey },
EmbeddingModel = new KnowledgeSourceAzureOpenAIVectorizer
{
AzureOpenAIParameters = embeddingParameters
},
ChatCompletionModel = new KnowledgeBaseAzureOpenAIModel(
new AzureOpenAIVectorizerParameters
{
ResourceUri = new Uri(aoaiEndpoint),
DeploymentName = aoaiChatDeployment,
ModelName = aoaiChatModel
})
};
var knowledgeSource = new FileKnowledgeSource(
"my-file-ks",
new FileKnowledgeSourceParameters { IngestionParameters = ingestionParameters });
await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Reference:SearchIndexClient
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
AzureOpenAIVectorizerParameters,
FileKnowledgeSource,
FileKnowledgeSourceParameters,
KnowledgeBaseAzureOpenAIModel,
)
from azure.search.documents.knowledgebases.models import (
AIServices,
KnowledgeSourceAzureOpenAIVectorizer,
KnowledgeSourceIngestionParameters,
)
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
embedding_parameters = AzureOpenAIVectorizerParameters(
resource_url="<aoai-endpoint>",
deployment_name="<aoai-embedding-deployment>",
model_name="<aoai-embedding-model>",
)
ingestion_parameters = KnowledgeSourceIngestionParameters(
content_extraction_mode="standard",
ai_services=AIServices(
uri="<foundry-resource-endpoint>",
api_key="<foundry-resource-key>",
),
embedding_model=KnowledgeSourceAzureOpenAIVectorizer(
azure_open_ai_parameters=embedding_parameters
),
chat_completion_model=KnowledgeBaseAzureOpenAIModel(
azure_open_ai_parameters=AzureOpenAIVectorizerParameters(
resource_url="<aoai-endpoint>",
deployment_name="<aoai-gpt-deployment>",
model_name="<aoai-gpt-model>",
)
),
)
knowledge_source = FileKnowledgeSource(
name="my-file-ks",
file_parameters=FileKnowledgeSourceParameters(
ingestion_parameters=ingestion_parameters
),
)
index_client.create_or_update_knowledge_source(knowledge_source)
Reference:SearchIndexClient
PUT {{searchEndpoint}}/knowledgesources('my-file-ks')?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}
Prefer: return=representation
{
"name": "my-file-ks",
"kind": "file",
"description": "This knowledge source uses standard extraction.",
"fileParameters": {
"ingestionParameters": {
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "{{aoai-endpoint}}",
"deploymentId": "{{aoai-embedding-deployment}}",
"modelName": "{{aoai-embedding-model}}"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "{{aoai-endpoint}}",
"deploymentId": "{{aoai-gpt-deployment}}",
"modelName": "{{aoai-gpt-model}}"
}
},
"contentExtractionMode": "standard",
"aiServices": {
"uri": "{{foundry-resource-endpoint}}",
"apiKey": "{{foundry-resource-key}}"
}
}
}
}
Dokumentacja:Źródła wiedzy — tworzenie lub aktualizowanie
MECHANIZM CORS dla operacji na plikach
Ustaw corsOptions w pełnej definicji źródła, aby umożliwić zaufane źródło pochodzenia przeglądarki na potrzeby przekazywania, wyświetlania, aktualizowania i usuwania plików.
Ważna
W wersji API corsOptions element 2026-10-01 ma zastosowanie do endpointów przesyłania plików, listowania, aktualizacji i usuwania, niezależnie od trybu ekstrakcji. Jeśli pominięto corsOptions, źródło wiedzy pliku nie ma zasad między źródłami przeglądarki. Mechanizm CORS nie autoryzuje żądań. Włączenie źródeł może uwidaczniać operacje usług i dane w kontekście przeglądarki i wprowadzać zagrożenia bezpieczeństwa. Określ tylko zaufane źródła pochodzenia i nie używaj originu wieloznacznego w produkcji. W przypadku żądań z przeglądarki użyj uwierzytelniania tokenem Microsoft Entra z minimalną wymaganą rolą. Nigdy nie ujawniaj tokenów dostępu lub kluczy usługi w kodzie przeglądarki.
PUT {{searchEndpoint}}/knowledgesources('my-file-ks')?api-version=2026-10-01
api-key: {{searchAdminKey}}
Content-Type: application/json
{
"name": "my-file-ks",
"kind": "file",
"fileParameters": {
"ingestionParameters": {
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "{{aoai-endpoint}}",
"deploymentId": "{{aoai-embedding-deployment}}",
"modelName": "{{aoai-embedding-model}}"
}
},
"contentExtractionMode": "minimal"
}
},
"corsOptions": {
"allowedOrigins": ["https://files.example.com"],
"maxAgeInSeconds": 300
}
}
Odwołanie:Źródła wiedzy
OPTIONS {{searchEndpoint}}/knowledgesources('my-file-ks')/files?api-version=2026-10-01
Origin: https://files.example.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: authorization,content-type
Odwołanie:Źródła wiedzy
Przekaż pliki
Po utworzeniu źródła wiedzy prześlij pliki bezpośrednio do niego za pomocą przesyłania wieloczęściowego. Każde przesyłanie jest synchronicznym wywołaniem. Foundry IQ wyodrębnia zawartość, dzieli ją na fragmenty, tworzy osadzenia w razie potrzeby, indeksuje fragmenty i zapisuje metadane pliku. Nie trzeba konfigurować ani uruchamiać oddzielnego potoku ingestii.
Aby uzyskać pomoc dotyczącą błędów związanych z przekazywaniem plików i zarządzaniem nimi, zobacz Rozwiązywanie problemów z operacjami na plikach.
POST {{searchEndpoint}}/knowledgesources('my-file-ks')/files?api-version=2026-10-01
Authorization: ******
Content-Type: multipart/form-data; boundary=file-boundary
--file-boundary
Content-Disposition: form-data; name="metadata"
Content-Type: application/json
{
"fileName": "manuals/handbook.txt"
}
--file-boundary
Content-Disposition: form-data; name="content"; filename="handbook.txt"
Content-Type: application/octet-stream
Employees request production access through the engineering access portal.
--file-boundary--
Odwołanie:Źródła wiedzy
Prześlij plik RAW
Przesyłanie plików raw jest dostępne tylko w interfejsach API w wersji zapoznawczej. Aby uzyskać informacje o przekazywaniu plików GA, zobacz Przekazywanie plików.
W nieprzetworzonych przykładach w językach C# i Python użyto zestawów SDK w wersji zapoznawczej z listopada. Przykład REST używa synchronicznego punktu końcowego 2026-11-01-preview .
Nazwy plików mogą zawierać ścieżkę względną, taką jak manuals/installation-guide.pdf. Usługa zamienia ukośniki odwrotne na ukośniki proste. Odrzuca ścieżki bezwzględne, puste segmenty ścieżki, segmenty .. lub ., segmenty zawierające dwukropki oraz nieprawidłowe znaki w nazwach plików, ze stanem HTTP 400.
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
string fileName = "installation-guide.pdf";
byte[] fileBytes = await File.ReadAllBytesAsync(fileName);
string contentDisposition = $"attachment; filename=\"{fileName}\"";
KnowledgeSourceFile uploadedFile = (await indexClient.UploadKnowledgeSourceFileAsync(
"my-file-ks",
contentDisposition,
BinaryData.FromBytes(fileBytes))).Value;
from pathlib import Path
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
file_path = Path("installation-guide.pdf")
uploaded_file = index_client.upload_knowledge_source_file(
"my-file-ks",
file_path.read_bytes(),
filename=file_path.name,
)
Wyślij nieprzetworzone bajty pliku do synchronicznego punktu końcowego wersji zapoznawczej. Użyj application/octet-stream nawet w przypadku zawartości tekstowej.
POST {{searchEndpoint}}/knowledgesources('my-file-ks')/files?api-version=2026-11-01-preview
Authorization: ******
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="manuals/raw-handbook.txt"
Employees request production access through the engineering access portal.
Odwołanie:Źródła wiedzy
Przekazywanie pliku z opcjonalnymi metadanymi
Użyj żądania wieloczęściowego, aby przekazać jeden plik binarny. Dodaj jedną metadata część z obiektem JSON i jedną niepustą content część. Część metadata jest wymagana, nawet jeśli nie masz niestandardowych metadanych; w takim przypadku użyj {}. W przypadku dodawania niestandardowych metadanych użyj płaskiej struktury wartości typu string.
Jeśli określono obie nazwy, metadata.fileName ma pierwszeństwo przed nazwą pliku w części content. Jeśli żadna z nich nie zostanie określona, usługa przypisuje automatycznie wygenerowaną nazwę pliku.
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
var metadata = new FileUploadMetadata
{
FileName = "installation-guide.pdf",
Metadata =
{
["department"] = "support",
["product"] = "contoso-100"
}
};
#pragma warning disable SCME0004
var request = new UploadKnowledgeSourceFileMultipartRequest(
metadata,
"installation-guide.pdf");
KnowledgeSourceFile uploadedFile = (await indexClient
.UploadKnowledgeSourceFileMultipartAsync("my-file-ks", request)).Value;
#pragma warning restore SCME0004
Reference:SearchIndexClient.UploadKnowledgeSourceFileMultipartAsync
from pathlib import Path
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
FileUploadMetadata,
UploadKnowledgeSourceFileMultipartRequest,
)
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
file_path = Path("installation-guide.pdf")
request = UploadKnowledgeSourceFileMultipartRequest(
metadata=FileUploadMetadata(
file_name=file_path.name,
metadata={"department": "support", "product": "contoso-100"},
),
content=(file_path.name, file_path.read_bytes(), "application/pdf"),
)
uploaded_file = index_client.upload_knowledge_source_file_multipart(
name="my-file-ks",
body=request,
)
Odwołanie:SearchIndexClient.upload_knowledge_source_file_multipart
POST {{search-endpoint}}/knowledgesources('my-file-ks')/files?api-version=2026-11-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: multipart/form-data; boundary=file-boundary
--file-boundary
Content-Disposition: form-data; name="metadata"
Content-Type: application/json
{
"fileName": "installation-guide.pdf",
"metadata": {
"department": "support",
"product": "contoso-100"
}
}
--file-boundary
Content-Disposition: form-data; name="content"; filename="installation-guide.pdf"
Content-Type: application/octet-stream
< ./installation-guide.pdf
--file-boundary--
Odwołanie:Źródła wiedzy — przekazywanie pliku
Przekazywanie pliku nie zastępuje istniejącego pliku, nawet jeśli używasz tego samego pliku fileName. Każde pomyślne przesłanie tworzy nowy plik z własnym fileId, więc lista przesłanych plików może zawierać wiele wpisów, które mają ten sam fileName.
Wyświetl listę przesłanych plików
Wyświetlanie listy plików w źródle wiedzy w celu sprawdzenia przekazanego zestawu plików.
using System.Collections.Generic;
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
var files = new List<KnowledgeSourceFile>();
await foreach (KnowledgeSourceFile file in indexClient.GetAllKnowledgeSourceFilesAsync("my-file-ks"))
{
files.Add(file);
}
Reference:SearchIndexClient
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
files = list(index_client.list_knowledge_source_files("my-file-ks"))
GET {{searchEndpoint}}/knowledgesources('my-file-ks')/files?api-version=2026-10-01
Authorization: ******
Odwołanie:Źródła wiedzy
Odpowiedź zawiera metadane dla każdego przekazanego pliku. Pliki, które zostały pomyślnie wyświetlone, mają wartość errorMessagenull.
{
"value": [
{
"fileId": "file-abc123",
"fileName": "installation-guide.pdf",
"fileSizeBytes": 1048576,
"createdAt": "2026-05-07T18:10:00Z",
"lastUpdatedAt": "2026-05-07T18:14:00.803Z",
"errorMessage": null
}
]
}
Jeśli nowe przekazywanie nie powiedzie się, żądanie zwróci błąd i nie utworzy rekordu metadanych pliku.
Wyświetlanie listy i filtrowanie plików
Podczas wyświetlania listy plików użyj tych parametrów zapytania, aby filtrować i stronicować wyniki:
-
prefix: Wykonuje dopasowanie z uwzględnieniem wielkości liter dla pełnej względnej nazwy pliku zaczynającej się od podanej wartości. Użyj wartościprefix, a niesearch, dla ścieżek zawierających ukośniki lub kropki. -
search: wykonuje dopasowanie bez uwzględniania wielkości liter na podstawie pełnej względnej nazwy pliku. Akceptuje tylko składnię prefiksu nazwa-zasobu: małe litery, cyfry, łączniki i podkreślenia, począwszy od litery lub cyfry. Ustaw wartośćsearchTypenaprefix, jego jedyną obsługiwaną wartość, aby wybrać ten tryb dopasowania. Ta wartość ma zastosowanie dosearchparametru , a nie oddzielnegoprefixparametru. -
pageSize: ma co najmniej 1, maksymalnie 3000 i wartość domyślną 3000.
using System.Collections.Generic;
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
var filteredFiles = new List<KnowledgeSourceFile>();
await foreach (KnowledgeSourceFile file in indexClient.GetAllKnowledgeSourceFilesAsync(
"my-file-ks",
prefix: "manuals/",
pageSize: 100))
{
filteredFiles.Add(file);
}
Reference:SearchIndexClient
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
files = list(index_client.list_knowledge_source_files(
"my-file-ks",
prefix="manuals/",
page_size=100,
))
GET {{searchEndpoint}}/knowledgesources('my-file-ks')/files?api-version=2026-10-01&prefix=manuals%2F&search=manuals&searchType=prefix&pageSize=1
Authorization: ******
Odwołanie:Źródła wiedzy
Odpowiedź obejmuje tryby analizowania i wyodrębniania wybranych przez usługę, a także metadanych użytkownika na potrzeby zarządzania plikami. Metadane użytkownika nie można przeszukiwać ani filtrować.
{
"value": [
{
"fileId": "file-abc123",
"fileName": "manuals/installation-guide.md",
"prefix": "manuals/",
"metadata": {
"department": "support",
"product": "contoso-100"
},
"parsingMode": "markdown",
"extractionMode": "minimal",
"fileSizeBytes": 1048576,
"createdAt": "2026-08-03T18:10:00Z",
"lastUpdatedAt": "2026-08-03T18:14:00Z",
"errorMessage": null
}
],
"@odata.nextLink": "<service-generated continuation URL>"
}
Aby pobrać wszystkie wyniki, postępuj zgodnie z @odata.nextLink instrukcjami, aż nie będzie ono nieobecne. Wyślij pełny adres URL dokładnie tak, jak został zwrócony, bez zmieniania parametrów zapytania.
Aktualizuj przesłany plik
Zaktualizuj plik, wysyłając PUT żądanie z zwróconym fileIdelementem . Dołącz fileName ponownie, aby zachować nazwę pliku.
Jeśli pominiesz niestandardową torbę metadata lub ustawisz ją na null, zostaną zachowane poprzednie niestandardowe wartości metadanych. Jeśli podasz niestandardowy worek metadata, to zastąpi poprzedni worek zamiast scalać go z nim. Aby wyczyścić niestandardowy worek metadanych, podaj wartość "metadata": {}.
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
var metadata = new FileUploadMetadata
{
FileName = "installation-guide.pdf",
Metadata =
{
["department"] = "support",
["product"] = "contoso-200"
}
};
#pragma warning disable SCME0004
var request = new UpdateKnowledgeSourceFileRequest(
metadata,
"installation-guide.pdf");
KnowledgeSourceFile updatedFile = (await indexClient.UpdateKnowledgeSourceFileAsync(
fileId,
"my-file-ks",
request)).Value;
#pragma warning restore SCME0004
from pathlib import Path
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
FileUploadMetadata,
UpdateKnowledgeSourceFileRequest,
)
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
file_path = Path("installation-guide.pdf")
request = UpdateKnowledgeSourceFileRequest(
metadata=FileUploadMetadata(
file_name=file_path.name,
metadata={"department": "support", "product": "contoso-200"},
),
content=(file_path.name, file_path.read_bytes(), "application/pdf"),
)
updated_file = index_client.update_knowledge_source_file(
name="my-file-ks",
file_id=file_id,
body=request,
)
PUT {{search-endpoint}}/knowledgesources('my-file-ks')/files('{{file-id}}')?api-version=2026-11-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: multipart/form-data; boundary=file-boundary
--file-boundary
Content-Disposition: form-data; name="metadata"
Content-Type: application/json
{
"fileName": "installation-guide.pdf",
"metadata": {
"department": "support",
"product": "contoso-200"
}
}
--file-boundary
Content-Disposition: form-data; name="content"; filename="installation-guide.pdf"
Content-Type: application/octet-stream
< ./installation-guide.pdf
--file-boundary--
Odwołanie:Źródła wiedzy — aktualizacja pliku
Jeśli aktualizacja nie powiedzie się, poprzedni rekord metadanych pozostanie, ale stara indeksowana zawartość może zostać już usunięta.
Usuń przesłane pliki
Usuń pliki ze źródła wiedzy, gdy nie chcesz już ich pobierać.
using Azure.Identity;
using Azure.Search.Documents.Indexes;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new DefaultAzureCredential());
await indexClient.DeleteKnowledgeSourceFileAsync("my-file-ks", "file-abc123");
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
index_client = SearchIndexClient(endpoint="<search-endpoint>", credential=DefaultAzureCredential())
index_client.delete_knowledge_source_file("my-file-ks", "file-abc123")
DELETE {{searchEndpoint}}/knowledgesources('my-file-ks')/files('{{fileId}}')?api-version=2026-10-01
Authorization: ******
Odwołanie:Źródła wiedzy
Jeśli źródło wiedzy jest zadowalające, dodaj je do bazy wiedzy.
Asynchroniczne importowanie plików (wersja zapoznawcza)
Użyj oddzielnych :ingest akcji, aby przetworzyć pliki w tle. Asynchroniczne pozyskiwanie danych i monitorowanie operacji wymagają 2026-11-01-preview.
- Pozyskiwanie asynchroniczne nie obsługuje źródeł wiedzy chronionych kluczem zarządzanym przez klienta.
- Asynchroniczne pozyskiwanie danych może zwrócić
503podczas ograniczania przepustowości.
using Azure;
using Azure.Identity;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
var asyncIndexClient = new SearchIndexClient(
new Uri(searchEndpoint),
new DefaultAzureCredential());
var initialMetadata = new FileUploadMetadata
{
FileName = "manuals/async-handbook.txt",
Metadata = { ["stage"] = "initial" }
};
var ingestRequest = new UploadKnowledgeSourceFileMultipartRequest(
initialMetadata,
BinaryData.FromString(
"Employees request production access through the engineering access portal."));
Operation<KnowledgeSourceFile> ingestOperation = await asyncIndexClient
.IngestKnowledgeSourceFileMultipartAsync(
WaitUntil.Completed,
"my-file-ks",
ingestRequest);
KnowledgeSourceFile ingestedFile = ingestOperation.Value;
var updatedMetadata = new FileUploadMetadata
{
FileName = "manuals/async-handbook.txt",
Metadata = { ["stage"] = "updated" }
};
var replacementRequest = new UpdateKnowledgeSourceFileRequest(
updatedMetadata,
BinaryData.FromString(
"Employees request production access through the engineering access portal. " +
"Manager approval is required before access is granted."));
Operation<KnowledgeSourceFile> replacementOperation = await asyncIndexClient
.IngestKnowledgeSourceFileReplacementAsync(
WaitUntil.Completed,
"my-file-ks",
ingestedFile.FileId,
replacementRequest);
KnowledgeSourceFile replacedFile = replacementOperation.Value;
Reference:SearchIndexClient
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
FileUploadMetadata,
UpdateKnowledgeSourceFileRequest,
UploadKnowledgeSourceFileMultipartRequest,
)
async_index_client = SearchIndexClient(
endpoint="<search-endpoint>",
credential=DefaultAzureCredential(),
)
ingest_request = UploadKnowledgeSourceFileMultipartRequest(
metadata=FileUploadMetadata(
file_name="manuals/async-handbook.txt",
metadata={"stage": "initial"},
),
content=(
"handbook.txt",
b"Employees request production access through the engineering access portal.",
"application/octet-stream",
),
)
ingest_poller = async_index_client.begin_ingest_knowledge_source_file_multipart(
name="my-file-ks",
body=ingest_request,
)
ingested_file = ingest_poller.result()
replacement_request = UpdateKnowledgeSourceFileRequest(
metadata=FileUploadMetadata(
file_name="manuals/async-handbook.txt",
metadata={"stage": "updated"},
),
content=(
"handbook.txt",
(
b"Employees request production access through the engineering access portal. "
b"Manager approval is required before access is granted."
),
"application/octet-stream",
),
)
replacement_poller = (
async_index_client.begin_ingest_knowledge_source_file_replacement(
name="my-file-ks",
file_id=ingested_file.file_id,
body=replacement_request,
)
)
replaced_file = replacement_poller.result()
Reference:SearchIndexClient
Rozpocznij pozyskiwanie i monitoruj zakończenie
Przekaż jeden plik z dosłownymi metadanymi i zawartością wieloczęściową.
POST {{searchEndpoint}}/knowledgesources('my-file-ks')/files:ingest?api-version=2026-11-01-preview
Authorization: ******
Content-Type: multipart/form-data; boundary=file-boundary
--file-boundary
Content-Disposition: form-data; name="metadata"
Content-Type: application/json
{
"fileName": "manuals/async-handbook.txt",
"metadata": {
"stage": "initial"
}
}
--file-boundary
Content-Disposition: form-data; name="content"; filename="handbook.txt"
Content-Type: application/octet-stream
Employees request production access through the engineering access portal.
--file-boundary--
Odwołanie:Źródła wiedzy
Oczekuj 202. Po opóźnieniu Retry-After sonduj adres URL do momentu Operation-Location zakończenia operacji.
GET {{operationLocation}}
Authorization: ******
Accept: application/json
Odwołanie:Źródła wiedzy
Monitor zwraca kod odpowiedzi HTTP 200, gdy pozyskiwanie danych trwa i po jego zakończeniu. Sprawdź status, aby poznać wynik.
status |
Action |
|---|---|
NotStarted, Running |
Zaczekaj na Retry-After, a następnie ponownie odpytyj ten sam adres URL. |
Succeeded |
Zapisz result.fileId jako {{asyncFileId}} i zachowaj result.createdAt do weryfikacji zastąpienia. |
Failed |
Zatrzymaj i sprawdź error.code (OperationFailed) i error.message. |
Canceled |
Zatrzymaj się. Operacja nie powiodła się. |
Asynchroniczne zastępowanie pliku
Przed zastąpieniem tego pliku zaczekaj na pomyślne przesłanie. Wyślij oddzielną akcję POST z zwróconym identyfikatorem pliku.
POST {{searchEndpoint}}/knowledgesources('my-file-ks')/files('{{asyncFileId}}'):ingest?api-version=2026-11-01-preview
Authorization: ******
Content-Type: multipart/form-data; boundary=file-boundary
--file-boundary
Content-Disposition: form-data; name="metadata"
Content-Type: application/json
{
"fileName": "manuals/async-handbook.txt",
"metadata": {
"stage": "updated"
}
}
--file-boundary
Content-Disposition: form-data; name="content"; filename="handbook.txt"
Content-Type: application/octet-stream
Employees request production access through the engineering access portal. Manager approval is required before access is granted.
--file-boundary--
Odwołanie:Źródła wiedzy
Oczekuj 202. Zapisz tę odpowiedź Operation-Location jako {{replacementOperationLocation}} i zachowaj jej Retry-Afterwartość. Zastosuj tę samą zasadę klienta 40 GET lub 20 minut oraz obsługę nierozstrzygniętych wyników do monitorowania zastępczego.
GET {{replacementOperationLocation}}
Authorization: ******
Accept: application/json
Odwołanie:Źródła wiedzy
Po Succeeded sprawdź, czy result.fileId i result.createdAt są zgodne z oryginalnym plikiem.
Wyświetl listę zachowanych operacji
Wyświetl monitory należące do tego źródła wiedzy, oddzielnie od listy plików.
GET {{searchEndpoint}}/knowledgesources('my-file-ks')/files/operations?api-version=2026-11-01-preview
Authorization: ******
Odwołanie:Źródła wiedzy
Usuwanie źródła wiedzy
W poniższych przykładach języka C# i Python są używane zestawy SDK w wersji zapoznawczej z listopada. W przypadku żądań REST ustaw wartość {{api-version}} na 2026-11-01-preview.
Aby można było usunąć źródło wiedzy, należy usunąć dowolną bazę wiedzy, która odwołuje się do źródła wiedzy, lub zaktualizować definicję bazy wiedzy, aby usunąć odwołanie. W przypadku źródeł wiedzy, które generują potok indeksu i indeksatora, wszystkie wygenerowane obiekty również są usuwane. Jeśli jednak użyto istniejącego indeksu do utworzenia źródła wiedzy, indeks nie zostanie usunięty.
Jeśli spróbujesz usunąć używane źródło wiedzy, akcja zakończy się niepowodzeniem i zwróci listę baz wiedzy, których dotyczy problem.
Aby usunąć źródło wiedzy:
Pobierz listę wszystkich baz wiedzy w usłudze Foundry IQ.
using Azure.Search.Documents.Indexes; var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential); var knowledgeBases = indexClient.GetKnowledgeBasesAsync(); Console.WriteLine("Knowledge Bases:"); await foreach (var kb in knowledgeBases) { Console.WriteLine($" - {kb.Name}"); }Reference:SearchIndexClient
Przykładowa odpowiedź może wyglądać następująco:
{ "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)", "value": [ { "name": "my-kb" }, { "name": "my-kb-2" } ] }Uzyskaj pojedynczą definicję bazy wiedzy, aby sprawdzić odwołania do źródeł wiedzy.
using Azure.Search.Documents.Indexes; using System.Text.Json; var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential); // Specify the knowledge base name to retrieve string kbNameToGet = "earth-knowledge-base"; // Get a specific knowledge base definition var knowledgeBaseResponse = await indexClient.GetKnowledgeBaseAsync(kbNameToGet); var kb = knowledgeBaseResponse.Value; // Serialize to JSON for display string json = JsonSerializer.Serialize(kb, new JsonSerializerOptions { WriteIndented = true }); Console.WriteLine(json);Reference:SearchIndexClient
Przykładowa odpowiedź może wyglądać następująco:
{ "Name": "earth-knowledge-base", "KnowledgeSources": [ { "Name": "earth-knowledge-source" } ], "Models": [ {} ], "RetrievalReasoningEffort": {}, "OutputMode": {}, "ETag": "\u00220x8DE278629D782B3\u0022", "EncryptionKey": null, "Description": null, "RetrievalInstructions": null, "AnswerInstructions": null }Usuń bazę wiedzy lub, jeśli masz wiele źródeł wiedzy, zaktualizuj bazę wiedzy, aby usunąć źródło. W tym przykładzie pokazano usunięcie.
using Azure.Search.Documents.Indexes; var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential); await indexClient.DeleteKnowledgeBaseAsync(knowledgeBaseName); System.Console.WriteLine($"Knowledge base '{knowledgeBaseName}' deleted successfully.");Reference:SearchIndexClient
Usuń źródło wiedzy.
await indexClient.DeleteKnowledgeSourceAsync(knowledgeSourceName); System.Console.WriteLine($"Knowledge source '{knowledgeSourceName}' deleted successfully.");Reference:SearchIndexClient
Pobierz listę wszystkich baz wiedzy w usłudze Foundry IQ.
# Get knowledge bases from azure.core.credentials import AzureKeyCredential from azure.search.documents.indexes import SearchIndexClient index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key")) print("Knowledge Bases:") for kb in index_client.list_knowledge_bases(): print(f" - {kb.name}")Reference:SearchIndexClient
Przykładowa odpowiedź może wyglądać następująco:
{ "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)", "value": [ { "name": "my-kb" }, { "name": "my-kb-2" } ] }Uzyskaj pojedynczą definicję bazy wiedzy, aby sprawdzić odwołania do źródeł wiedzy.
# Get a knowledge base definition from azure.core.credentials import AzureKeyCredential from azure.search.documents.indexes import SearchIndexClient index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key")) kb = index_client.get_knowledge_base("knowledge_base_name") print(kb)Reference:SearchIndexClient
Przykładowa odpowiedź może wyglądać następująco:
{ "name": "my-kb", "description": null, "retrievalInstructions": null, "answerInstructions": null, "outputMode": null, "knowledgeSources": [ { "name": "my-blob-ks" } ], "models": [], "encryptionKey": null, "retrievalReasoningEffort": { "kind": "low" } }Usuń bazę wiedzy lub, jeśli masz wiele źródeł wiedzy, zaktualizuj bazę wiedzy, aby usunąć źródło. W tym przykładzie pokazano usunięcie.
# Delete a knowledge base from azure.core.credentials import AzureKeyCredential from azure.search.documents.indexes import SearchIndexClient index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key")) index_client.delete_knowledge_base("knowledge_base_name") print(f"Knowledge base deleted successfully.")Reference:SearchIndexClient
Usuń źródło wiedzy.
# Delete a knowledge source from azure.core.credentials import AzureKeyCredential from azure.search.documents.indexes import SearchIndexClient index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key")) index_client.delete_knowledge_source("knowledge_source_name") print(f"Knowledge source deleted successfully.")Reference:SearchIndexClient
Pobierz listę wszystkich baz wiedzy w usłudze Foundry IQ.
### Get knowledge bases GET {{search-url}}/knowledgebases?api-version={{api-version}}&$select=name Authorization: Bearer {{token}}Dokumentacja:Bazy wiedzy — lista
Przykładowa odpowiedź może wyglądać następująco:
{ "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)", "value": [ { "name": "my-kb" }, { "name": "my-kb-2" } ] }Uzyskaj pojedynczą definicję bazy wiedzy, aby sprawdzić odwołania do źródeł wiedzy.
### Get a knowledge base definition GET {{search-url}}/knowledgebases('{{knowledge-base-name}}')?api-version={{api-version}} Authorization: Bearer {{token}}Odwołanie:Bazy wiedzy — pobieranie
Przykładowa odpowiedź może wyglądać następująco:
{ "name": "my-kb", "description": null, "retrievalInstructions": null, "answerInstructions": null, "outputMode": null, "knowledgeSources": [ { "name": "my-blob-ks" } ], "models": [], "encryptionKey": null, "retrievalReasoningEffort": { "kind": "low" } }Usuń bazę wiedzy lub, jeśli masz wiele źródeł wiedzy, zaktualizuj bazę wiedzy, aby usunąć źródło. W tym przykładzie pokazano usunięcie.
### Delete a knowledge base DELETE {{search-url}}/knowledgebases('{{knowledge-base-name}}')?api-version={{api-version}} Authorization: Bearer {{token}}Odwołanie:Bazy wiedzy — usuwanie
Usuń źródło wiedzy.
### Delete a knowledge source DELETE {{search-url}}/knowledgesources('{{knowledge-source-name}}')?api-version={{api-version}} Authorization: Bearer {{token}}Odwołanie:Źródła wiedzy — usuwanie
DELETE {{searchEndpoint}}/knowledgesources('my-file-ks')?api-version=2026-10-01
Authorization: ******
Odwołanie:Źródła wiedzy
Oczekuj 204. Przed oczyszczeniem poczekaj na zakończenie każdej operacji asynchronicznej.
Rozwiązywanie problemów z operacjami na plikach
Poniższe kody stanu dotyczą operacji związanych z plikowym źródłem wiedzy.
| Kod stanu | Przyczyna i akcja |
|---|---|
400 |
Sprawdź pustą zawartość, brakujące lub zduplikowane części wieloczęściowe, nieprawidłowe dane JSON metadanych, niebezpieczne ścieżki względne i nieprawidłowe zapytania listy. |
404 |
Monitor pliku, źródła lub operacji nie istnieje w żądanym zakresie. Użyj źródła i identyfikatorów z rzeczywistej odpowiedzi. Powtarzające się usuwanie pliku zwraca również wartość 404. |
409 |
Efektywna liczba plików jest wyczerpana lub mutacja powoduje konflikt z aktywnym pozyskiwaniem asynchronicznym. Poczekaj na operacje terminalu przed zmodyfikowaniem lub usunięciem zasobów. |
413 |
Rozmiar pliku w bajtach przekracza efektywny limit rozmiaru dla punktu końcowego i warstwy. Zmniejsz rozmiar pliku. |
415 |
Synchroniczne przekazywanie wykryło nieobsługiwany typ MIME lub użyto nieobsługiwanego typu zawartości zewnętrznej. W przypadku obrazów wybierz standardowe wyodrębnianie i jawnie obsługiwany format. Zmiana podanego typu MIME nie zastępuje wykrywania. |
503 |
Importowanie asynchroniczne jest niedostępne lub brak kwalifikującego się procesu roboczego. Zależność indeksowania może również zwrócić ten stan. |
504 |
Przetwarzanie synchroniczne przekroczyło skonfigurowany limit czasu (domyślnie 180 sekund). Zmniejsz rozmiar pliku lub złożoność. To nie jest asynchroniczny termin sondowania. |