Creare un'origine knowledge Azure SQL indicizzata

Annotazioni

Foundry IQ (Azure AI Search) fornisce API dirette di indicizzazione e query, oltre ad API di livello superiore per origini dati di conoscenza e knowledge base per il recupero gestito. Usare il portale di Azure, le API REST o Azure SDK per configurare queste funzionalità o connettere gli agenti alle knowledge base nel portale di Microsoft Foundry.

Importante

Le caratteristiche o le funzionalità contrassegnate con (anteprima) in questo articolo sono in anteprima pubblica e sono soggette alle Condizioni supplementari per l'utilizzo delle anteprime di Microsoft Azure.

Per i termini di anteprima specifici di Foundry IQ (Azure AI Search), vedere Funzionalità di anteprima.

Un'origine knowledge Azure SQL indicizzata inserisce righe da database SQL di Azure o Istanza gestita di SQL di Azure in una pipeline di recupero agentico in Foundry IQ (Azure AI Search). Questa funzionalità è disponibile a livello generale con l'API 2026-10-01REST . Le origini dati vengono create in modo indipendente, a cui viene fatto riferimento in una Knowledge Base e usate come dati di base quando la Knowledge Base viene interrogata in fase di esecuzione.

A differenza delle origini dati basate su file, come Archiviazione BLOB di Azure e OneLake, ogni riga SQL è considerata un documento logico. Lo schema dell'indice viene definito tramite mapping di colonna espliciti anziché utilizzando uno schema di documento fisso.

Quando si crea un'origine dati indicizzata Azure SQL, si specifica un'origine dati SQL, mapping di colonne facoltativi e modelli facoltativi per generare automaticamente gli oggetti IQ Foundry seguenti:

  • Un'origine dati che rappresenta la tabella o la vista SQL.
  • Un indice i cui campi derivano dalle mappature delle tue colonne.
  • Set di competenze che genera incorporamenti. Il servizio crea un set di competenze solo quando si specifica embeddingColumns.
  • Indicizzatore che usa gli oggetti precedenti per guidare la pipeline di inserimento.

L'indicizzatore generato è conforme all'indicizzatore Azure SQL, i cui prerequisiti, i criteri di rilevamento delle modifiche e le limitazioni si applicano anche alle origini conoscenze indicizzate Azure SQL. Per altre informazioni, vedere la documentazione dell'indicizzatore Azure SQL.

Supporto per l'utilizzo

portale di Azure portale di Microsoft Foundry .NET SDK Python SDK Java SDK JavaScript SDK REST API
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Prerequisiti

  • Un servizio Foundry IQ in qualsiasi area geografica che fornisce il recupero agentico.

  • Completamento dei prerequisiti dell'indicizzatore Azure SQL, tra cui:

    • Un database SQL di Azure o Istanza gestita di SQL di Azure con una tabella o una vista da inserire.

    • Una chiave primaria a valore singolo nella tabella o nella vista di origine.

    • Per i valori, una colonna adatta al rilevamento delle variazioni del livello massimo raggiunto. È consigliabile usare una rowversion colonna.

  • Autorizzazione per la creazione di origini delle informazioni. Configurare l'autenticazione senza chiave con i ruoli Collaboratore servizio di ricerca e Collaboratore ai dati dell'indice di ricerca assegnati all'account utente (scelta consigliata) o usare una chiave API di amministrazione.

  • Se si specifica embeddingColumns e si usa l'identità gestita per Azure incorporamenti OpenAI, assegnare l'utente OpenAI di Servizi cognitivi all'identità selezionata nella Azure risorsa OpenAI o Foundry padre corrispondente resourceUria . Vedere Assegnare un ruolo.

  • Se imposti networkAccessMode su private, completa i requisiti seguenti:

  • Pacchetto di anteprima Azure.Search.Documents più recente: dotnet add package Azure.Search.Documents --prerelease

  • Per l'autenticazione senza chiave, il Azure.Identity pacchetto: dotnet add package Azure.Identity

  • Pacchetto di anteprima azure-search-documents più recente: pip install --pre azure-search-documents

  • Per l'autenticazione senza chiave, il azure-identity pacchetto: pip install azure-identity

  • Versione 2026-10-01 dell'API REST del servizio di ricerca.

  • Per l'autenticazione senza chiave, includere un token Microsoft Entra ID nell'intestazione Authorization di ogni richiesta HTTP.

Limitazioni e considerazioni

  • Una fonte di dati può attingere dati da una sola tabella o da una sola vista.
  • La tabella o la vista di origine deve avere una chiave primaria a valore singolo. Le chiavi composite non sono supportate.
  • La chiave primaria viene individuata automaticamente e non può essere sottoposta a override.
  • contentExtractionMode supporta solo "minimal".
  • L'estrazione di immagini e la verbalizzazione delle immagini non sono supportate.
  • La sincronizzazione in tempo reale non è supportata. L'indicizzatore generato è basato sulla pianificazione.
  • Il recupero SQL in tempo reale non è supportato. La fonte di conoscenza è indicizzata, non è remota.

Preparare l'indicizzatore generato

Un'origine dati di conoscenza Azure SQL indicizzata crea automaticamente un indicizzatore per gestire l'ingestione. Esaminare i dettagli seguenti prima di creare l'origine delle informazioni.

Rilevamento delle modifiche

L'indicizzatore generato usa il rilevamento delle modifiche standard dell'indicizzatore di Azure SQL:

Authentication

L'indicizzatore generato supporta due opzioni di autenticazione:

  • Autenticazione SQL: Specificare un nome utente e una password nella stringa di connessione.

  • Autenticazione dell'identità gestita: Usare un'identità gestita assegnata dal sistema o assegnata dall'utente che dispone del controllo degli accessi in base al ruolo di Azure e di ruoli a livello di database nella risorsa SQL.

Per i formati della stringa di connessione, i requisiti dei ruoli e i passaggi di configurazione, vedi prerequisiti dell'indicizzatore Azure SQL e Connettersi tramite un'identità gestita.

Verificare la presenza di fonti di conoscenza esistenti

Un'origine delle conoscenze è un oggetto riutilizzabile di primo livello. Conoscere le origini conoscenze esistenti è utile per riutilizzare o denominare nuovi oggetti.

Eseguire il codice seguente per elencare le origini delle informazioni in base al nome e al tipo.

// 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}}

Riferimento:Knowledge Sources - List

Puoi anche restituire una singola fonte di conoscenza per nome per esaminarne la definizione 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}}

Reference:Knowledge Sources - Get

Il seguente JSON è una risposta di esempio per un'origine della conoscenza di Azure SQL indicizzata.

{
  "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"
    }
  }
}

Creare una fonte di conoscenza

Esegui il codice seguente per creare un'origine dati di Azure SQL indicizzata.

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

Reference: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}}"
        }
      }
    }
  }
}

Reference:Knowledge Sources - Create or Update

Usare indexedSqlParameters per identificare la tabella o la vista SQL da inserire e per definire i mapping di colonna che diventano campi nell'indice generato. Per le viste, specificare la colonna di limite massimo utilizzata per il rilevamento delle modifiche.

Mappatura delle colonne

Usare contentColumns per eseguire il mapping delle colonne di testo SQL in campi ricercabili nell'indice Foundry IQ generato. Ogni mapping delle colonne del contenuto assegna un nome al campo indice di destinazione, alla colonna SQL di origine e al tipo di campo Foundry IQ. Per contentColumns, usare Edm.String.

Mappatura incorporata

Usare embeddingColumns per eseguire il mapping di colonne di testo SQL in campi vettoriali generati. Specificare un modello di incorporamento in ingestionParameters quando si usano le colonne di incorporamento.

Per le origini dati di conoscenza indicizzate di Azure SQL, contentExtractionMode deve essere "minimal" perché l'acquisizione SQL è basata sulle righe e non estrae il contenuto dai documenti binari. L'estrazione di immagini e la verbalizzazione delle immagini non sono supportate, quindi chatCompletionModel, assetStore, aiServices e le impostazioni correlate alle immagini non hanno alcun effetto.

Regole di impostazione dei valori predefiniti e di convalida

Le seguenti impostazioni predefinite si applicano quando si crea un'origine dati di conoscenza di Azure SQL indicizzata.

  • Se si omette contentColumns, il servizio esegue automaticamente il mapping delle colonne SQL che possono essere rappresentate in modo sicuro come testo nei campi nell'indice generato, usando un mapping 1:1 in cui Edm.String è nameuguale a sourceField .

  • Se si omette embeddingColumns, il servizio non crea campi vettoriali e non configura una competenza di incorporamento.

  • embeddingColumns è indipendente da contentColumns. Per fare in modo che i vettori corrispondano al testo recuperabile, includere la stessa colonna SQL in entrambe le matrici.

  • La chiave primaria della tabella o della vista di origine viene individuata automaticamente. Le sostituzioni esplicite non sono supportate e l'origine deve avere una chiave primaria a valore singolo.

Limitare l'inserimento a una rete privata

Nell'API stabile, 2026-10-01 controlla l'ambiente di rete in cui viene eseguito l'indicizzatore generato per un'origine di conoscenza Azure SQL indicizzata networkAccessMode. Questa impostazione influisce solo sull'acquisizione e non modifica le richieste o le risposte di recupero della base di conoscenza. Controllare la matrice di supporto del collegamento privato condiviso per le configurazioni idonee e le dipendenze di anteprima indipendenti.

networkAccessMode è impostato per impostazione predefinita su public, che mantiene il comportamento di rete pubblica esistente. Quando networkAccessMode è private, l'indicizzatore generato viene eseguito nell'ambiente di esecuzione privata. Usa collegamenti privati condivisi approvati per accedere alla connessione di origine di database SQL di Azure o Istanza gestita di SQL e alle dipendenze supportate Azure, ad esempio Azure modelli OpenAI e risorse Microsoft Foundry.

Per configurare e verificare l'accesso alla rete privata:

  1. Completare i prerequisiti della rete privata.

  2. Impostare networkAccessMode su private nella richiesta di creazione dell'origine dati della knowledge base. È possibile impostare questa proprietà solo durante la creazione, anche nell'API stabile 2026-10-01. Per modificare la modalità archiviata in un secondo momento, eliminare e ricreare il knowledge source. Le origini Blob idonee, ADLS Gen2 e Azure SQL possono invece usare l'override di rete temporaneo per l'indicizzatore generato. Questa eccezione non si applica ai SharePoint indicizzati o ad altri tipi di origine.

    La creazione può avere esito negativo se il livello di servizio o il runtime non supporta l'esecuzione privata o se non esiste un collegamento privato condiviso richiesto. Serverless e S3 HD non supportano l'esecuzione privata. La configurazione perimetrale della sicurezza di rete controlla l'accesso all'endpoint pubblico supportato, non l'esecuzione privata.

  3. Verificare che l'indicizzatore parameters.configuration.executionEnvironment generato sia private.

  4. Verificare che ogni collegamento privato condiviso richiesto sia approvato, sottoposto a provisioning e destinato alla dipendenza corretta. La creazione con esito positivo non conferma l'approvazione o la destinazione del collegamento. Se un controllo del portale non riesce a risolvere una risorsa tra sottoscrizioni, verificare manualmente l'approvazione e lo stato di preparazione per la risorsa di destinazione e il servizio IQ Foundry.

  5. Monitorare lo stato della fonte delle informazioni finché lastSynchronizationState.endTime non assume un valore. Verificare che itemsUpdatesFailed sia 0e quindi verificare il contenuto di origine specifico del connettore. La sincronizzazione non riesce se una dipendenza non è raggiungibile.

Controllare lo stato dell'ingestione

Eseguire il codice seguente per monitorare lo stato e l'integrità dell'inserimento, inclusi il tipo di origine delle informazioni e gli errori dettagliati di indicizzazione per le origini delle informazioni che generano una pipeline dell'indicizzatore e popolano un indice di ricerca.

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 

Reference:Knowledge Sources - Get Status

Una risposta per una richiesta che include parametri di inserimento e inserisce attivamente contenuto potrebbe essere simile all'esempio seguente.

{
  "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
  }
}

Annotazioni

La proprietà kind e l'array currentSynchronizationState.errors[] con i dettagli degli errori a livello di documento sono disponibili a partire dalla versione API 2026-04-01. Per le versioni precedenti dell'API, questi campi non vengono restituiti. Il lastSynchronizationState.status campo è anche nuovo nel 2026-04-01.

Esaminare gli oggetti generati

Quando si crea questa origine conoscenze, Foundry IQ (Azure AI Search) genera automaticamente un'origine dati, un indicizzatore e un indice, oltre a un set di competenze quando la pipeline di inserimento ne richiede una. La risposta di creazione elenca ogni oggetto in createdResources.

Questi oggetti vengono generati in base a un modello fisso e i relativi nomi si basano sul nome dell'origine conoscenze. Non è possibile modificare i nomi degli oggetti. Evitare di modificare direttamente questi oggetti, perché le modifiche possono introdurre errori o incompatibilità che interrompono la pipeline dell'indicizzatore.

Solo per le origini BLOB idonee, ADLS Gen2 e Azure SQL, l'override di rete provvisorio consente di modificare l'ambiente di esecuzione dell'indicizzatore generato. Questa eccezione non si applica a SharePoint o OneLake indicizzati e non consente altre modifiche all'oggetto generato. Gli aggiornamenti o la rigenerazione dell'origine conoscenze successivi possono sovrascrivere l'override.

È possibile usare il portale di Azure per convalidare la creazione di oggetti. Il flusso di lavoro è:

  1. Controllare l'indicizzatore per i messaggi di esito positivo o negativo. Gli errori di connessione o quota vengono visualizzati qui.

  2. Controllare l'origine dati per verificare la connessione all'archivio dati. La connessione utilizza una stringa di connessione o un'identità gestita, in base a come è stata configurata l'origine delle informazioni.

  3. Se viene generato uno skillset, controllare le impostazioni di arricchimento e vettorializzazione. Le origini dati SQL generano uno skillset solo quando si specifica embeddingColumns.

  4. Controllare l'indice per vedere in che modo il contenuto viene indicizzato ed esposto per il recupero, inclusi i campi ricercabili e filtrabili e quali campi archiviano vettori per la ricerca di somiglianza. Usa Search Explorer per eseguire query sull'indice generato.

Assegnare a una knowledge base

Se sei soddisfatto della fonte di conoscenza, aggiungila a una base di conoscenza.

Eseguire una query su una base di conoscenza

Dopo aver configurato la Knowledge Base, chiamare l'azione di recupero o l'endpoint MCP per eseguire una query sull'origine della knowledge base.

Eliminare una fonte di conoscenza

Prima di poter eliminare una fonte di conoscenza, è necessario eliminare qualsiasi base di conoscenza che vi faccia riferimento o aggiornare la definizione della base di conoscenza per rimuovere il riferimento. Per le fonti di conoscenza che generano un indice e una pipeline di indicizzazione, vengono eliminati anche tutti gli oggetti generati. Tuttavia, se è stato usato un indice esistente per creare un'origine conoscenze, l'indice non viene eliminato.

Se si tenta di eliminare una fonte di conoscenza attualmente in uso, l'azione fallisce e restituisce un elenco delle basi di conoscenza interessate.

Per eliminare una fonte di conoscenza:

  1. Ottenere un elenco di tutte le knowledge base nel servizio IQ Foundry.

    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

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
         "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
         "value": [
         {
             "name": "my-kb"
         },
         {
             "name": "my-kb-2"
         }
         ]
     }
    
  2. Ottenere una singola definizione della Knowledge Base per verificare la presenza di riferimenti all'origine della knowledge base.

    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

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
       "Name": "earth-knowledge-base",
       "KnowledgeSources": [
         {
           "Name": "earth-knowledge-source"
         }
       ],
       "Models": [
         {}
       ],
       "RetrievalReasoningEffort": {},
       "OutputMode": {},
       "ETag": "\u00220x8DE278629D782B3\u0022",
       "EncryptionKey": null,
       "Description": null,
       "RetrievalInstructions": null,
       "AnswerInstructions": null
     }
    
  3. Eliminare la Knowledge Base o, se si dispone di più origini informazioni, aggiornare la Knowledge Base per rimuovere l'origine. Questo esempio mostra l'eliminazione.

    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. Eliminare l'origine delle informazioni.

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

    Reference:SearchIndexClient

  1. Ottenere un elenco di tutte le knowledge base nel servizio 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

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
         "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
         "value": [
         {
             "name": "my-kb"
         },
         {
             "name": "my-kb-2"
         }
         ]
     }
    
  2. Ottenere una singola definizione della Knowledge Base per verificare la presenza di riferimenti all'origine della knowledge base.

    # 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

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
       "name": "my-kb",
       "description": null,
       "retrievalInstructions": null,
       "answerInstructions": null,
       "outputMode": null,
       "knowledgeSources": [
         {
           "name": "my-blob-ks"
         }
       ],
       "models": [],
       "encryptionKey": null,
       "retrievalReasoningEffort": {
         "kind": "low"
       }
     }
    
  3. Eliminare la Knowledge Base o, se si dispone di più origini informazioni, aggiornare la Knowledge Base per rimuovere l'origine. Questo esempio mostra l'eliminazione.

    # 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. Eliminare l'origine delle informazioni.

    # 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. Ottenere un elenco di tutte le knowledge base nel servizio IQ Foundry.

    ### Get knowledge bases
    GET {{search-url}}/knowledgebases?api-version={{api-version}}&$select=name
    Authorization: Bearer {{token}}
    

    Reference:Knowledge Bases - List

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
         "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
         "value": [
         {
             "name": "my-kb"
         },
         {
             "name": "my-kb-2"
         }
         ]
     }
    
  2. Ottenere una singola definizione della Knowledge Base per verificare la presenza di riferimenti all'origine della knowledge base.

    ### Get a knowledge base definition
    GET {{search-url}}/knowledgebases('{{knowledge-base-name}}')?api-version={{api-version}}
    Authorization: Bearer {{token}}
    

    Reference:Knowledge Bases - Get

    Una risposta di esempio potrebbe essere simile alla seguente:

     {
       "name": "my-kb",
       "description": null,
       "retrievalInstructions": null,
       "answerInstructions": null,
       "outputMode": null,
       "knowledgeSources": [
         {
           "name": "my-blob-ks"
         }
       ],
       "models": [],
       "encryptionKey": null,
       "retrievalReasoningEffort": {
         "kind": "low"
       }
     }
    
  3. Eliminare la Knowledge Base o, se si dispone di più origini informazioni, aggiornare la Knowledge Base per rimuovere l'origine. Questo esempio mostra l'eliminazione.

    ### Delete a knowledge base
    DELETE {{search-url}}/knowledgebases('{{knowledge-base-name}}')?api-version={{api-version}}
    Authorization: Bearer {{token}}
    

    Reference:Knowledge Bases - Delete

  4. Eliminare l'origine delle informazioni.

    ### Delete a knowledge source
    DELETE {{search-url}}/knowledgesources('{{knowledge-source-name}}')?api-version={{api-version}}
    Authorization: Bearer {{token}}
    

    Riferimento:Origini dati di conoscenza - Eliminazione