Utwórz źródło wiedzy z pliku

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=standard jest 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 standard tryb 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.Documents wersji zapoznawczej: dotnet add package Azure.Search.Documents --prerelease

  • W przypadku uwierzytelniania bezkluczowego pakiet Azure.Identity: dotnet add package Azure.Identity

  • Najnowszy pakiet azure-search-documents wersji zapoznawczej: pip install --pre azure-search-documents

  • W 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 Authorization każ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 programie 2026-05-01-preview. W pliku 2026-10-01 użyj wyodrębniania standard. Ekstrakcja minimal zwraca kod stanu HTTP 415 w 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;

Reference:SearchIndexClient.UploadKnowledgeSourceFileAsync

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,
)

Odwołanie:SearchIndexClient.upload_knowledge_source_file

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"))

Odwołanie:SearchIndexClient.list_knowledge_source_files

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ści prefix, a nie search, 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ść searchType na prefix, jego jedyną obsługiwaną wartość, aby wybrać ten tryb dopasowania. Ta wartość ma zastosowanie do searchparametru , a nie oddzielnego prefix parametru.
  • 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,
))

Odwołanie:SearchIndexClient.list_knowledge_source_files

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

Reference:SearchIndexClient.UpdateKnowledgeSourceFileAsync

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,
)

Odwołanie:SearchIndexClient.update_knowledge_source_file

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");

Reference:SearchIndexClient.DeleteKnowledgeSourceFileAsync

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")

Odwołanie:SearchIndexClient.delete_knowledge_source_file

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ć 503 podczas 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:

  1. 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"
         }
         ]
     }
    
  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
     }
    
  3. 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

  4. Usuń źródło wiedzy.

    await indexClient.DeleteKnowledgeSourceAsync(knowledgeSourceName);
    System.Console.WriteLine($"Knowledge source '{knowledgeSourceName}' deleted successfully.");
    

    Reference:SearchIndexClient

  1. 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"
         }
         ]
     }
    
  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"
       }
     }
    
  3. 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

  4. 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

  1. 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"
         }
         ]
     }
    
  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"
       }
     }
    
  3. 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

  4. 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.