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.
Źródło wiedzy Azure SQL z indeksem pozyskuje wiersze z Azure SQL Database lub Azure SQL Managed Instance do potoku wyszukiwania agentowego w usłudze Foundry IQ (Wyszukiwanie AI platformy Azure). Ta funkcja jest ogólnie dostępna za pomocą interfejsu API 2026-10-01REST.
Źródła wiedzy są tworzone niezależnie, przywoływane w bazie wiedzy i używane jako dane uziemienia, gdy baza wiedzy jest odpytywane w czasie wykonywania zapytań.
W przeciwieństwie do źródeł wiedzy opartych na plikach, takich jak Azure Blob Storage i OneLake, każdy wiersz SQL jest traktowany jako jeden dokument logiczny. Schemat indeksu można kierować za pomocą jawnych mapowań kolumn, a nie przy użyciu stałego schematu dokumentu.
Podczas tworzenia źródła wiedzy Azure SQL z indeksem określasz źródło danych SQL, opcjonalne mapowania kolumn oraz opcjonalne modele, aby automatycznie wygenerować następujące obiekty Foundry IQ:
- Źródło danych reprezentujące tabelę LUB widok SQL.
- Indeks, którego pola pochodzą z mapowań kolumn.
- Zestaw umiejętności generujący osadzenia wektorowe. Usługa tworzy zestaw umiejętności tylko wtedy, gdy określisz wartość
embeddingColumns. - Indeksator, który używa poprzednich obiektów do sterowania potokiem przetwarzania.
Wygenerowany indeksator jest zgodny z indeksatorem Azure SQL, którego wymagania wstępne, zasady wykrywania zmian i ograniczenia dotyczą również indeksowanych źródeł wiedzy Azure SQL. Aby uzyskać więcej informacji, zobacz dokumentację indeksatora Azure SQL.
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.
Ukończenie wymagań wstępnych indeksatora Azure SQL, w tym:
Azure SQL Database lub Azure SQL Managed Instance z tabelą lub widokiem do pozyskania danych.
Klucz podstawowy o pojedynczej wartości w tabeli źródłowej lub widoku.
W przypadku widoków kolumna odpowiednia do wykrywania zmian znacznika wysokiego poziomu wody. Zdecydowanie zalecamy kolumnę
rowversion.
Uprawnienie do tworzenia źródeł wiedzy. Skonfiguruj uwierzytelnianie bez klucza przy użyciu ról Współautor usługi wyszukiwania i Współautor danych indeksu wyszukiwania przypisanych do konta użytkownika (zalecane) lub użyj klucza interfejsu API administratora.
Jeśli określisz
embeddingColumnstożsamość zarządzaną i użyjesz jej do osadzania Azure openAI, przypisz użytkownika OpenAI usług Cognitive Services do wybranej tożsamości w zasobie openAI Azure openAI lub nadrzędnym zasobie foundry zgodnymresourceUriz . Zobacz Przypisywanie roli.Jeśli ustawisz
networkAccessModenaprivate, upewnij się, że spełniono następujące wymagania:Użyj usługi IQ S2, S3, L1 lub L2 Foundry. Sprawdź macierz obsługi udostępnionego łącza prywatnego kanonicznego pod kątem kwalifikacji konfiguracji i warstw.
Utwórz i zatwierdź udostępniony link prywatny do serwera SQL. Postępuj zgodnie z obsługiwanymi typami zasobów dla identyfikatora docelowego i grupy. Usługa SQL Managed Instance udostępnionego łącza prywatnego (wersja zapoznawcza) jest dostępna w wersji zapoznawczej.
Użyj uwierzytelniania SQL lub tożsamości zarządzanej, w której łącznik go obsługuje. Współużytkowane łącza prywatne usługi SQL Managed Instance wymagają uwierzytelniania SQL; tożsamość zarządzana nie jest obsługiwana w przypadku tego połączenia. W przypadku tożsamości zarządzanej w usłudze SQL Database przyznaj wymagane Azure i role bazy danych. Użyj parametry połączenia z
Database=<database-name>i identyfikatorem zasobu serwera SQL. UstawingestionParameters.identitytylko dla tożsamości przypisanej przez użytkownika. Jeśli go pominiesz, indeksator używa tożsamości przypisanej przez system usługi IQ usługi Foundry.Jeśli określisz
embeddingColumns, utwórz i zatwierdź udostępniony link prywatny dla każdego chronionego punktu końcowego modelu osadzania przy użyciu obsługiwanych typów zasobów. Bez kolumn z osadzeniami nie jest wymagany zestaw umiejętności osadzeń ani połączenie z modelem.
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.
Ograniczenia i zagadnienia
- Źródło wiedzy może pobierać dane dokładnie z jednej tabeli lub jednego widoku.
- Tabela źródłowa lub widok musi mieć klucz podstawowy o pojedynczej wartości. Klucze złożone nie są obsługiwane.
- Klucz podstawowy jest automatycznie wykrywany i nie można go zastąpić.
-
contentExtractionModeprogram obsługuje tylko"minimal". - Wyodrębnianie obrazów i werbalizacja obrazów nie są obsługiwane.
- Synchronizacja w czasie rzeczywistym nie jest obsługiwana. Wygenerowany indeksator jest oparty na harmonogramie.
- Pobieranie sql w czasie rzeczywistym nie jest obsługiwane. Źródło wiedzy jest źródłem indeksowanym, a nie zdalnym.
Przygotowywanie wygenerowanego indeksatora
Indeksowane źródło wiedzy Azure SQL automatycznie tworzy indeksator na potrzeby pozyskiwania danych. Przed utworzeniem źródła wiedzy zapoznaj się z poniższymi szczegółami.
Wykrywanie zmian
Wygenerowany indeksator używa standardowego Azure SQL wykrywania zmian indeksatora:
Tabele: Usługa automatycznie stosuje zintegrowane śledzenie zmian SQL . Włącz śledzenie zmian SQL w tabeli źródłowej przed utworzeniem źródła wiedzy.
Widoki: Usługa stosuje wykrywanie zmian na podstawie znacznika wysokiej wody. Określ kolumnę do użycia w pliku
highWaterMarkColumnName. Kolumnarowversionjest zdecydowanie zalecana. Aby wykrywać usunięcia w widoku, uwzględnij w nim kolumnę znacznika usunięcia nietrwałego zgodnie z opisem w sekcji Zasady wykrywania usunięć za pomocą kolumny usunięcia nietrwałego.
Uwierzytelnianie
Wygenerowany indeksator obsługuje dwie opcje uwierzytelniania:
Uwierzytelnianie SQL: Podaj nazwę użytkownika i hasło w parametry połączenia.
Uwierzytelnianie za pomocą tożsamości zarządzanej: Użyj tożsamości zarządzanej przypisanej przez system lub przez użytkownika, która ma role RBAC platformy Azure oraz role na poziomie bazy danych dla zasobu SQL.
Informacje o formatach parametrów połączenia, wymaganiach dotyczących ról i krokach konfiguracji można znaleźć w artykułach Wymagania wstępne indeksatora Azure SQL i Łączenie za pomocą tożsamości zarządzanej.
Sprawdzanie istniejących źródeł wiedzy
Ź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}}
Dokumentacja referencyjna:Źródła wiedzy — pobieranie
Poniższy kod JSON to przykładowa odpowiedź dla indeksowanego źródła wiedzy Azure SQL.
{
"name": "indexedsqlks",
"kind": "indexedSql",
"description": "Sample indexed Azure SQL knowledge source.",
"encryptionKey": null,
"indexedSqlParameters": {
"connectionString": "<sql-connection-string>",
"tableOrView": "dbo.tbl_hotels",
"contentColumns": [
{ "name": "hotelName", "sourceField": "HotelName", "searchFieldType": "Edm.String" },
{ "name": "description", "sourceField": "Description", "searchFieldType": "Edm.String" }
],
"embeddingColumns": [
{ "name": "descriptionVector", "sourceField": "Description" }
],
"ingestionParameters": {
"contentExtractionMode": "minimal",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "<aoai-endpoint>",
"deploymentId": "text-embedding-3-large",
"modelName": "text-embedding-3-large"
}
}
},
"createdResources": {
"datasource": "indexedsqlks-datasource",
"indexer": "indexedsqlks-indexer",
"skillset": "indexedsqlks-skillset",
"index": "indexedsqlks-index"
}
}
}
Tworzenie źródła wiedzy
Uruchom następujący kod, aby utworzyć indeksowany Azure SQL źródło wiedzy.
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
{
NetworkAccessMode = KnowledgeSourceNetworkAccessMode.Public,
ContentExtractionMode = "minimal",
EmbeddingModel = new KnowledgeSourceAzureOpenAIVectorizer
{
AzureOpenAIParameters = embeddingParams
}
};
var sqlParams = new IndexedSqlKnowledgeSourceParameters(
connectionString: sqlConnectionString,
tableOrView: "dbo.tbl_hotels")
{
ContentColumns =
{
new ContentColumnMapping("hotelName", "HotelName", "Edm.String"),
new ContentColumnMapping("description", "Description", "Edm.String")
},
EmbeddingColumns =
{
new EmbeddingColumnMapping("descriptionVector", "Description")
},
IngestionParameters = ingestionParams
};
var knowledgeSource = new IndexedSqlKnowledgeSource(
name: "indexedsqlks",
indexedSqlParameters: sqlParams)
{
Description = "Indexed Azure SQL knowledge source."
};
await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Console.WriteLine($"Knowledge source '{knowledgeSource.Name}' created or updated successfully.");
Odwołanie:SearchIndexClient, IndexedSqlKnowledgeSource
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
AzureOpenAIVectorizerParameters,
ContentColumnMapping,
EmbeddingColumnMapping,
IndexedSqlKnowledgeSource,
IndexedSqlKnowledgeSourceParameters,
)
from azure.search.documents.knowledgebases.models import (
KnowledgeSourceAzureOpenAIVectorizer,
KnowledgeSourceIngestionParameters,
KnowledgeSourceNetworkAccessMode,
)
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(
network_access_mode=KnowledgeSourceNetworkAccessMode.PUBLIC,
content_extraction_mode="minimal",
embedding_model=KnowledgeSourceAzureOpenAIVectorizer(
azure_open_ai_parameters=embedding_params
),
)
knowledge_source = IndexedSqlKnowledgeSource(
name="indexedsqlks",
description="Indexed Azure SQL knowledge source.",
indexed_sql_parameters=IndexedSqlKnowledgeSourceParameters(
connection_string="Server=tcp:{server}.database.windows.net,1433;Database={db};...;",
table_or_view="dbo.tbl_hotels",
content_columns=[
ContentColumnMapping(
name="hotelName",
source_field="HotelName",
search_field_type="Edm.String",
),
ContentColumnMapping(
name="description",
source_field="Description",
search_field_type="Edm.String",
),
],
embedding_columns=[
EmbeddingColumnMapping(
name="descriptionVector",
source_field="Description",
)
],
ingestion_parameters=ingestion_params,
),
)
index_client.create_or_update_knowledge_source(knowledge_source=knowledge_source)
print(f"Knowledge source '{knowledge_source.name}' created or updated successfully.")
Reference:SearchIndexClient
### Create an indexed Azure SQL knowledge source
PUT {{search-endpoint}}/knowledgesources/indexedsqlks?api-version=2026-10-01
Authorization: Bearer {{search-access-token}}
Content-Type: application/json
Prefer: return=representation
{
"name": "indexedsqlks",
"kind": "indexedSql",
"description": "Indexed Azure SQL knowledge source.",
"indexedSqlParameters": {
"connectionString": "Server=tcp:{server}.database.windows.net,1433;Database={db};...;",
"tableOrView": "dbo.tbl_hotels",
"contentColumns": [
{ "name": "hotelName", "sourceField": "HotelName", "searchFieldType": "Edm.String" },
{ "name": "description", "sourceField": "Description", "searchFieldType": "Edm.String" }
],
"embeddingColumns": [
{ "name": "descriptionVector", "sourceField": "Description" }
],
"ingestionParameters": {
"networkAccessMode": "public",
"contentExtractionMode": "minimal",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "{{aoai-endpoint}}",
"deploymentId": "{{aoai-embedding-deployment}}",
"modelName": "{{aoai-embedding-model}}"
}
}
}
}
}
Informacje o:Źródła wiedzy — tworzenie lub aktualizowanie
Użyj indexedSqlParameters do zidentyfikowania tabeli SQL lub widoku, z którego mają zostać pozyskane dane, oraz do zdefiniowania mapowań kolumn, które staną się polami w wygenerowanym indeksie. W przypadku widoków określ kolumnę znacznika wysokiego poziomu używaną do wykrywania zmian.
Mapowanie kolumn
Użyj contentColumns, aby mapować tekstowe kolumny SQL na pola z możliwością wyszukiwania w wygenerowanym indeksie Foundry IQ. Każde mapowanie kolumn zawartości określa docelowe pole indeksu, źródłową kolumnę SQL i typ pola Foundry IQ. Dla contentColumns użyj Edm.String.
Mapowanie osadzania
Służy embeddingColumns do mapowania kolumn tekstowych SQL na wygenerowane pola wektorów. Określ model osadzania w ingestionParameters, jeśli używasz kolumn osadzania.
W przypadku indeksowanych źródeł wiedzy Azure SQL "minimal" musi mieć wartość contentExtractionMode, ponieważ pozyskiwanie danych z SQL odbywa się na poziomie wierszy i nie wyodrębnia zawartości z dokumentów binarnych. Wyodrębnianie obrazów i opisywanie obrazów nie są obsługiwane, więc ustawienia chatCompletionModel, assetStore, aiServices oraz ustawienia związane z obrazami nie mają żadnego efektu.
Ustawianie wartości domyślnych i reguły walidacji
Następujące wartości domyślne mają zastosowanie podczas tworzenia indeksowanego Azure SQL źródła wiedzy.
Jeśli pominiesz
contentColumns, usługa automatycznie mapuje kolumny SQL, które można bezpiecznie reprezentować jako tekst, na polaEdm.Stringw wygenerowanym indeksie, używając mapowania 1:1, gdzienamejest równesourceField.Jeśli pominięto
embeddingColumns, usługa nie tworzy pól wektorowych i nie konfiguruje umiejętności osadzania.embeddingColumnsjest niezależny odcontentColumns. Aby wektory odpowiadały tekstowi możliwemu do pobrania, uwzględnij tę samą kolumnę SQL w obu tablicach.Klucz podstawowy tabeli źródłowej lub widoku jest automatycznie wykrywany. Jawne zastąpienia nie są obsługiwane, a źródło musi mieć jednowartościowy klucz podstawowy.
Ogranicz pozyskiwanie danych do sieci prywatnej
W stabilnym interfejsie API 2026-10-01 element networkAccessMode steruje środowiskiem sieciowym, w którym jest uruchamiany wygenerowany indeksator dla indeksowanego źródła wiedzy Azure SQL. To ustawienie wpływa tylko na indeksowanie i nie zmienia żądań ani odpowiedzi pobierania z bazy wiedzy. Zapoznaj się z macierzą obsługi udostępnionego łącza prywatnego pod kątem kwalifikujących się konfiguracji i oddzielnych zależności wersji zapoznawczej.
networkAccessMode ma domyślną wartość public, co zachowuje istniejące zachowanie sieci publicznej. Gdy parametr networkAccessMode ma wartość private, wygenerowany indeksator działa w prywatnym środowisku wykonywania. Używa zatwierdzonych prywatnych linków udostępnionych do uzyskiwania dostępu do źródłowego połączenia z usługą Azure SQL Database lub SQL Managed Instance oraz do obsługiwanych zależności platformy Azure, takich jak modele Azure OpenAI i zasoby Microsoft Foundry.
Aby skonfigurować i zweryfikować dostęp do sieci prywatnej:
Ustaw
networkAccessModenaprivatew żądaniu utworzenia źródła wiedzy. Tę właściwość można ustawić tylko podczas tworzenia, w tym w stabilnym2026-10-01interfejsie API. Aby zmienić tryb przechowywania później, usuń i ponownie utwórz źródło wiedzy. Kwalifikujące się źródła obiektów blob, ADLS Gen2 i Azure SQL mogą zamiast tego używać tymczasowego zastąpienia sieci dla tymczasowo wygenerowanego indeksatora. Ten wyjątek nie ma zastosowania do zaindeksowanego SharePoint ani innych rodzajów źródeł.Tworzenie może zakończyć się niepowodzeniem, jeśli warstwa usługi lub środowisko uruchomieniowe nie obsługuje wykonywania prywatnego lub jeśli wymagany udostępniony link prywatny nie istnieje. Serverless i S3 HD nie obsługują prywatnego wykonywania. Konfiguracja granic bezpieczeństwa sieci kontroluje obsługiwany dostęp do publicznego punktu końcowego, a nie uruchamianie prywatne.
Upewnij się, że wygenerowany indeksator
parameters.configuration.executionEnvironmentma wartośćprivate.Upewnij się, że każdy wymagany udostępniony link prywatny jest zatwierdzony, aprowizowany i jest przeznaczony dla prawidłowej zależności. Samo pomyślne utworzenie nie potwierdza zatwierdzenia linku ani kierowania. Jeśli sprawdzenie w portalu nie może zlokalizować zasobu między subskrypcjami, ręcznie zweryfikuj zatwierdzenie i gotowość zasobu docelowego oraz usługi Foundry IQ.
Sonduj stan źródła wiedzy, dopóki
lastSynchronizationState.endTimenie ma wartości. Potwierdź, żeitemsUpdatesFailedto0, a następnie zweryfikuj zawartość źródłową związaną z danym łącznikiem. Synchronizacja kończy się niepowodzeniem, jeśli zależność nie jest osiągalna.
Sprawdź stan importowania danych
Uruchom następujący kod, aby monitorować postęp przetwarzania danych i kondycję, w tym rodzaj źródła wiedzy i szczegółowe błędy indeksowania dla źródeł wiedzy, które generują potok indeksatora i tworzą indeks wyszukiwania.
using Azure.Search.Documents.Indexes;
using System.Text.Json;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new AzureKeyCredential(apiKey));
// Get knowledge source ingestion status
var statusResponse = await indexClient.GetKnowledgeSourceStatusAsync(knowledgeSourceName);
var status = statusResponse.Value;
// Serialize to JSON for display
var json = JsonSerializer.Serialize(status, new JsonSerializerOptions { WriteIndented = true });
Console.WriteLine(json);
Reference:SearchIndexClient
# Check knowledge source ingestion status
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"))
status = index_client.get_knowledge_source_status("knowledge_source_name")
print(json.dumps(status.as_dict(), indent=2))
Reference:SearchIndexClient
### Check knowledge source ingestion status
GET {{search-url}}/knowledgesources/{{knowledge-source-name}}/status?api-version={{api-version}}
Authorization: Bearer {{token}}
Content-Type: application/json
Odwołanie:Źródła wiedzy — pobieranie stanu
Odpowiedź na żądanie, która zawiera parametry pozyskiwania i aktywnie pozyskuje zawartość, może wyglądać jak poniższy przykład.
{
"kind": "azureBlob",
"synchronizationStatus": "active",
"synchronizationInterval": "1d",
"currentSynchronizationState": {
"startTime": "2026-04-10T19:30:00Z",
"itemUpdatesProcessed": 1100,
"itemsUpdatesFailed": 100,
"itemsSkipped": 1100,
"errors": [
{
"key": "Item id 1",
"docURL": "https://contoso.blob.core.windows.net/contracts/2024/Q4/doc-00023.csv",
"statusCode": 400,
"componentName": "DocumentExtraction.AzureBlob.MyDataSource",
"errorMessage": "Could not read the value of column 'foo' at index '0'.",
"details": "The file could not be parsed.",
"documentationLink": "https://go.microsoft.com/fwlink/?linkid=2049388"
}
]
},
"lastSynchronizationState": {
"status": "partialSuccess",
"startTime": "2026-04-09T19:30:00Z",
"endTime": "2026-04-09T19:40:01Z",
"itemUpdatesProcessed": 1100,
"itemsUpdatesFailed": 100,
"itemsSkipped": 1100,
"errors": null
},
"statistics": {
"totalSynchronizations": 25,
"averageSynchronizationDuration": "00:15:20",
"averageItemsProcessedPerSynchronization": 500
}
}
Note
Właściwość kind i tablica currentSynchronizationState.errors[] ze szczegółami błędów na poziomie dokumentu są dostępne począwszy od wersji interfejsu API 2026-04-01. W przypadku wcześniejszych wersji interfejsu API te pola nie są zwracane. Pole lastSynchronizationState.status jest również nowe w 2026-04-01.
Przeglądanie wygenerowanych obiektów
Podczas tworzenia tego źródła wiedzy usługa Foundry IQ (Wyszukiwanie AI platformy Azure) automatycznie generuje źródło danych, indeksator i indeks oraz zestaw umiejętności, gdy potok pozyskiwania wymaga. Odpowiedź na żądanie utworzenia wymienia każdy obiekt pod elementem createdResources.
Te obiekty są generowane zgodnie z ustalonym szablonem, a ich nazwy są oparte na nazwie źródła wiedzy. Nie można zmienić nazw obiektów. Unikaj bezpośredniego edytowania tych obiektów, ponieważ zmiany mogą powodować błędy lub niezgodności, które przerywają potok indeksatora.
Wyłącznie w przypadku kwalifikujących się źródeł Blob, ADLS Gen2 i Azure SQL tymczasowe obejście ustawień sieciowych umożliwia zmianę środowiska wykonywania wygenerowanego indeksatora. Ten wyjątek nie ma zastosowania do zindeksowanych elementów SharePoint ani OneLake i nie zezwala na zmiany innych wygenerowanych obiektów. Późniejsze aktualizacje źródła wiedzy lub ponowne generowanie mogą nadpisać to nadpisanie.
Aby zweryfikować tworzenie obiektów, możesz użyć portalu Azure. Przepływ pracy to:
Sprawdź indeksator pod kątem komunikatów o powodzeniu lub niepowodzeniu. Błędy połączenia lub limitu zostaną wyświetlone tutaj.
Sprawdź źródło danych, aby zweryfikować połączenie z magazynem danych. Połączenie używa albo parametru połączenia, albo tożsamości zarządzanej, w zależności od tego, jak skonfigurowano źródło wiedzy.
Jeśli zostanie wygenerowany zestaw umiejętności, sprawdź jego ustawienia wzbogacania i wektoryzacji. Źródła wiedzy SQL generują zestaw umiejętności tylko wtedy, gdy określisz
embeddingColumns.Sprawdź indeks, aby zobaczyć, jak zawartość jest indeksowana i uwidoczniona na potrzeby pobierania, w tym pola, które można przeszukiwać i filtrować oraz które pola przechowują wektory na potrzeby wyszukiwania podobieństwa. Użyj Eksploratora wyszukiwania, aby uruchamiać zapytania względem wygenerowanego indeksu.
Przypisywanie do bazy wiedzy
Jeśli źródło wiedzy jest zadowalające, dodaj je do bazy wiedzy.
Wykonywanie zapytań w bazie wiedzy
Po skonfigurowaniu bazy wiedzy wywołaj akcję pobierania lub punkt końcowy MCP , aby wysłać zapytanie do źródła wiedzy.
Usuwanie źródła wiedzy
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