Condividi tramite

Creare una risorsa di conoscenze Web

Importante

Annotazioni

Questa funzionalità è attualmente disponibile in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Web Knowledge Source consente il recupero di dati Web in tempo reale da Microsoft Bing in una pipeline di recupero agentico. Le origini delle informazioni vengono create in modo indipendente, a cui viene fatto riferimento in una knowledge base e usate come dati di base quando un agente o un chatbot chiama un'azione di recupero in fase di query.

La ricerca personalizzata di Bing è sempre il provider di ricerca per la Fonte di Conoscenza Web. Anche se non è possibile specificare provider o motori di ricerca alternativi, è possibile includere o escludere domini specifici, ad esempio https://learn.microsoft.com. Quando non viene specificato alcun dominio, l'origine delle informazioni Web ha accesso senza restrizioni all'intera rete Internet pubblica.

L'origine delle informazioni Web funziona meglio insieme ad altre fonti di conoscenza. Usa Web Knowledge Source quando il contenuto proprietario non fornisce risposte complete, up-to-date o quando vuoi integrare i risultati con le informazioni di un motore di ricerca commerciale.

Quando si usa l'origine delle informazioni Web, tenere presente quanto segue:

  • La risposta è sempre una singola risposta formulata alla query anziché i risultati di ricerca non elaborati dal Web.

  • Poiché la fonte delle informazioni Web non supporta i dati estrattivi, la Knowledge Base deve usare la sintesi delle risposte e il lavoro di ragionamento medio o basso. Non è anche possibile definire istruzioni di risposta.

Prerequisiti

Verificare le fonti di informazioni esistenti

Una fonte di informazioni è un oggetto riutilizzabile di livello superiore. 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}");
}

È anche possibile restituire una singola fonte di informazioni in base al 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));

Il codice JSON seguente è una risposta di esempio per una risorsa origine informazioni Web.

{
  "WebParameters": {
    "Domains": null
  },
  "Name": "my-web-ks",
  "Description": "A sample Web Knowledge Source.",
  "EncryptionKey": null,
}

Creare una fonte di informazioni

Esegui il codice seguente per creare una risorsa di Conoscenza del Web.

// Create Web Knowledge Source
// Create a Web knowledge source
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
using Azure;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new AzureKeyCredential(apiKey));

var knowledgeSource = new WebKnowledgeSource(name: "my-web-ks")
{
    Description = "A sample Web Knowledge Source.",
    WebParameters = new WebKnowledgeSourceParameters
    {
        Domains = new WebKnowledgeSourceDomains
        {
            AllowedDomains = 
            {
                new WebKnowledgeSourceDomain(address: "learn.microsoft.com") { IncludeSubpages = true }
            },
            BlockedDomains = 
            {
                new WebKnowledgeSourceDomain(address: "bing.com") { IncludeSubpages = false }
            }
        }
    }
};

await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Console.WriteLine($"Knowledge source '{knowledgeSource.Name}' created or updated successfully.");

Proprietà specifiche dell'origine

È possibile passare le seguenti proprietà per creare una risorsa di Conoscenza Web.

Nome Description TIPO Modificabili Obbligatorio
Name Nome della fonte di conoscenze, che deve essere univoco all'interno della raccolta delle fonti di conoscenze e seguire le linee guida per la denominazione degli oggetti in Azure AI Search. String Yes Yes
Description Descrizione dell'origine delle informazioni. Se non specificato, Ricerca di intelligenza artificiale di Azure applica una descrizione predefinita. String Yes NO
EncryptionKey Chiave gestita dal cliente per crittografare le informazioni riservate nell'origine delle informazioni. Oggetto Yes NO
WebParameters Parametri specifici della fonte di conoscenza Web. Attualmente, si tratta solo di Domains. Oggetto Yes NO
Domains Domini da consentire o bloccare nel contesto della ricerca. Per impostazione predefinita, l'origine delle informazioni usa Grounding con Ricerca Bing per eseguire ricerche nell'intera rete Internet pubblica. Quando si specificano domini, l'origine della knowledge base usa Grounding con Ricerca personalizzata Bing per limitare i risultati ai domini specificati. In entrambi i casi, Ricerca personalizzata Bing è il provider di ricerca. Oggetto Yes NO
AllowedDomains Domini da includere nello spazio di ricerca. Per ogni dominio, è necessario specificarne l'address nel formatowebsite.com. È anche possibile specificare se includere le pagine secondarie del dominio impostando IncludeSubpages su true o false. Array Yes NO
BlockedDomains Domini da escludere dallo spazio di ricerca. Per ogni dominio, è necessario specificarne l'address nel formatowebsite.com. È anche possibile specificare se includere le pagine secondarie del dominio impostando IncludeSubpages su true o false. Array Yes NO

Assegnare a una knowledge base

Se si è soddisfatti della fonte di conoscenza, continuare con il passaggio successivo: specificare la fonte nel knowledge base.

Dopo aver configurato la Knowledge Base, usare l'azione di recupero per eseguire query sull'origine della knowledge base.

Eliminare una fonte di informazioni

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 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 di ricerca.

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

    Una risposta di esempio potrebbe essere simile alla seguente:

     Knowledge Bases:
   - earth-knowledge-base
   - hotels-sample-knowledge-base
   - my-demo-knowledge-base

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

    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 base di conoscenza o aggiornare la base di conoscenza per rimuovere la fonte di conoscenza se sono presenti più fonti. In questo esempio viene mostrata la procedura di 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.");

  4. Eliminare la fonte di informazioni.

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

Importante

Annotazioni

Questa funzionalità è attualmente disponibile in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Web Knowledge Source consente il recupero di dati Web in tempo reale da Microsoft Bing in una pipeline di recupero agentico. Le origini delle informazioni vengono create in modo indipendente, a cui viene fatto riferimento in una knowledge base e usate come dati di base quando un agente o un chatbot chiama un'azione di recupero in fase di query.

La ricerca personalizzata di Bing è sempre il provider di ricerca per la Fonte di Conoscenza Web. Anche se non è possibile specificare provider o motori di ricerca alternativi, è possibile includere o escludere domini specifici, ad esempio https://learn.microsoft.com. Quando non viene specificato alcun dominio, l'origine delle informazioni Web ha accesso senza restrizioni all'intera rete Internet pubblica.

L'origine delle informazioni Web funziona meglio insieme ad altre fonti di conoscenza. Usa Web Knowledge Source quando il contenuto proprietario non fornisce risposte complete, up-to-date o quando vuoi integrare i risultati con le informazioni di un motore di ricerca commerciale.

Quando si usa l'origine delle informazioni Web, tenere presente quanto segue:

  • La risposta è sempre una singola risposta formulata alla query anziché i risultati di ricerca non elaborati dal Web.

  • Poiché la fonte delle informazioni Web non supporta i dati estrattivi, la Knowledge Base deve usare la sintesi delle risposte e il lavoro di ragionamento medio o basso. Non è anche possibile definire istruzioni di risposta.

Prerequisiti

Verificare le fonti di informazioni esistenti

Una fonte di informazioni è un oggetto riutilizzabile di livello superiore. 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
import requests
import json

endpoint = "{search_url}/knowledgesources"
params = {"api-version": "2025-11-01-preview", "$select": "name, kind"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

È anche possibile restituire una singola fonte di informazioni in base al nome per esaminarne la definizione JSON.

# Get a knowledge source definition
import requests
import json

endpoint = "{search_url}/knowledgesources/{knowledge_source_name}"
params = {"api-version": "2025-11-01-preview"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

Il codice JSON seguente è una risposta di esempio per una risorsa origine informazioni Web.

{
  "name": "my-web-ks",
  "kind": "web",
  "description": "A sample Web Knowledge Source.",
  "encryptionKey": null,
  "webParameters": {
    "domains": null
  }
}

Creare una fonte di informazioni

Esegui il codice seguente per creare una risorsa di Conoscenza del Web.

# Create Web Knowledge Source
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import WebKnowledgeSource, WebKnowledgeSourceParameters, WebKnowledgeSourceDomains

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

knowledge_source = WebKnowledgeSource(
    name = "my-web-ks",
    description = "A sample Web Knowledge Source.",
    encryption_key = None,
    web_parameters = WebKnowledgeSourceParameters(
        domains = WebKnowledgeSourceDomains(
            allowed_domains = [ { "address": "learn.microsoft.com", "include_subpages": True } ],
            blocked_domains = [ { "address": "bing.com", "include_subpages": False } ]
        )
    )
)

index_client.create_or_update_knowledge_source(knowledge_source)
print(f"Knowledge source '{knowledge_source.name}' created or updated successfully.")

Proprietà specifiche dell'origine

È possibile passare le seguenti proprietà per creare una risorsa di Conoscenza Web.

Nome Description TIPO Modificabili Obbligatorio
name Nome della fonte di conoscenze, che deve essere univoco all'interno della raccolta delle fonti di conoscenze e seguire le linee guida per la denominazione degli oggetti in Azure AI Search. String Yes Yes
description Descrizione dell'origine delle informazioni. Se non specificato, Ricerca di intelligenza artificiale di Azure applica una descrizione predefinita. String Yes NO
encryption_key Chiave gestita dal cliente per crittografare le informazioni riservate nell'origine delle informazioni. Oggetto Yes NO
web_parameters Parametri specifici della fonte di conoscenza Web. Attualmente, si tratta solo di domains. Oggetto Yes NO
domains Domini da consentire o bloccare nel contesto della ricerca. Per impostazione predefinita, l'origine delle informazioni usa Grounding con Ricerca Bing per eseguire ricerche nell'intera rete Internet pubblica. Quando si specificano domini, l'origine della knowledge base usa Grounding con Ricerca personalizzata Bing per limitare i risultati ai domini specificati. In entrambi i casi, Ricerca personalizzata Bing è il provider di ricerca. Oggetto Yes NO
allowed_domains Domini da includere nello spazio di ricerca. Per ogni dominio, è necessario specificarne l'address nel formatowebsite.com. È anche possibile specificare se includere le pagine secondarie del dominio impostando include_subpages su true o false. Array Yes NO
blocked_domains Domini da escludere dallo spazio di ricerca. Per ogni dominio, è necessario specificarne l'address nel formatowebsite.com. È anche possibile specificare se includere le pagine secondarie del dominio impostando include_subpages su true o false. Array Yes NO

Assegnare a una knowledge base

Se si è soddisfatti della fonte di conoscenza, continuare con il passaggio successivo: specificare la fonte nel knowledge base.

Dopo aver configurato la Knowledge Base, usare l'azione di recupero per eseguire query sull'origine della knowledge base.

Eliminare una fonte di informazioni

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 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 di ricerca.

    # Get knowledge bases
import requests
import json

endpoint = "{search_url}/knowledgebases"
params = {"api-version": "2025-11-01-preview", "$select": "name"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

    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
import requests
import json

endpoint = "{search_url}/knowledgebases/{knowledge_base_name}"
params = {"api-version": "2025-11-01-preview"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

    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 base di conoscenza o aggiornare la base di conoscenza per rimuovere la fonte di conoscenza se sono presenti più fonti. In questo esempio viene mostrata la procedura di 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.")

  4. Eliminare la fonte di 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.")

Importante

Annotazioni

Questa funzionalità è attualmente disponibile in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Web Knowledge Source consente il recupero di dati Web in tempo reale da Microsoft Bing in una pipeline di recupero agentico. Le origini delle informazioni vengono create in modo indipendente, a cui viene fatto riferimento in una knowledge base e usate come dati di base quando un agente o un chatbot chiama un'azione di recupero in fase di query.

La ricerca personalizzata di Bing è sempre il provider di ricerca per la Fonte di Conoscenza Web. Anche se non è possibile specificare provider o motori di ricerca alternativi, è possibile includere o escludere domini specifici, ad esempio https://learn.microsoft.com. Quando non viene specificato alcun dominio, l'origine delle informazioni Web ha accesso senza restrizioni all'intera rete Internet pubblica.

L'origine delle informazioni Web funziona meglio insieme ad altre fonti di conoscenza. Usa Web Knowledge Source quando il contenuto proprietario non fornisce risposte complete, up-to-date o quando vuoi integrare i risultati con le informazioni di un motore di ricerca commerciale.

Quando si usa l'origine delle informazioni Web, tenere presente quanto segue:

  • La risposta è sempre una singola risposta formulata alla query anziché i risultati di ricerca non elaborati dal Web.

  • Poiché la fonte delle informazioni Web non supporta i dati estrattivi, la Knowledge Base deve usare la sintesi delle risposte e il lavoro di ragionamento medio o basso. Non è anche possibile definire istruzioni di risposta.

Prerequisiti

Verificare le fonti di informazioni esistenti

Una fonte di informazioni è un oggetto riutilizzabile di livello superiore. Conoscere le origini conoscenze esistenti è utile per riutilizzare o denominare nuovi oggetti.

Usare Le origini delle informazioni - Ottenere (API REST) per elencare le origini delle informazioni in base al nome e al tipo.

### List knowledge sources by name and type
GET {{search-url}}/knowledgesources?api-version=2025-11-01-preview&$select=name,kind
api-key: {{api-key}}

È anche possibile restituire una singola fonte di informazioni in base al nome per esaminarne la definizione JSON.

### Get a knowledge source definition
GET {{search-url}}/knowledgesources/{{knowledge-source-name}}?api-version=2025-11-01-preview
api-key: {{api-key}}

Il codice JSON seguente è una risposta di esempio per una risorsa origine informazioni Web.

{
  "name": "my-web-ks",
  "kind": "web",
  "description": "A sample Web Knowledge Source.",
  "encryptionKey": null,
  "webParameters": {
    "domains": null
  }
}

Creare una fonte di informazioni

Usare Fonti di Conoscenza - Creare o Aggiornare (API REST) per creare una risorsa di Fonte di Conoscenza Web.

PUT {{search-url}}/knowledgesources/my-web-ks?api-version=2025-11-01-preview
Content-Type: application/json
api-key: {{api-key}}

{
  "name": "my-web-ks",
  "kind": "web",
  "description": "This knowledge source pulls content from the web.",
  "encryptionKey": null,
  "webParameters": {
    "domains": {
      "allowedDomains": [ { "address": "learn.microsoft.com", "includeSubpages": true } ],
      "blockedDomains": [ { "address": "bing.com", "includeSubpages": false } ]
    }
  }
}

Proprietà specifiche dell'origine

È possibile passare le seguenti proprietà per creare una risorsa di Conoscenza Web.

Nome Description TIPO Modificabili Obbligatorio
name Nome della fonte di conoscenze, che deve essere univoco all'interno della raccolta delle fonti di conoscenze e seguire le linee guida per la denominazione degli oggetti in Azure AI Search. String Yes Yes
kind Il tipo di origine delle conoscenze, che in questo caso è web . String NO Yes
description Descrizione dell'origine delle informazioni. Se non specificato, Ricerca di intelligenza artificiale di Azure applica una descrizione predefinita. String Yes NO
encryptionKey Chiave gestita dal cliente per crittografare le informazioni riservate nell'origine delle informazioni. Oggetto Yes NO
webParameters Parametri specifici della fonte di conoscenza Web. Attualmente, si tratta solo di domains. Oggetto Yes NO
domains Domini da consentire o bloccare nel contesto della ricerca. Per impostazione predefinita, l'origine delle informazioni usa Grounding con Ricerca Bing per eseguire ricerche nell'intera rete Internet pubblica. Quando si specificano domini, l'origine della knowledge base usa Grounding con Ricerca personalizzata Bing per limitare i risultati ai domini specificati. In entrambi i casi, Ricerca personalizzata Bing è il provider di ricerca. Oggetto Yes NO
allowedDomains Domini da includere nello spazio di ricerca. Per ogni dominio, è necessario specificarne l'address nel formatowebsite.com. È anche possibile specificare se includere le pagine secondarie del dominio impostando includeSubpages su true o false. Array Yes NO
blockedDomains Domini da escludere dallo spazio di ricerca. Per ogni dominio, è necessario specificarne l'address nel formatowebsite.com. È anche possibile specificare se includere le pagine secondarie del dominio impostando includeSubpages su true o false. Array Yes NO

Assegnare a una knowledge base

Se si è soddisfatti della fonte di conoscenza, continuare con il passaggio successivo: specificare la fonte nel knowledge base.

Dopo aver configurato la Knowledge Base, usare l'azione di recupero per eseguire query sull'origine della knowledge base.

Eliminare una fonte di informazioni

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 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 di ricerca.

    ### Get knowledge bases
GET {{search-endpoint}}/knowledgebases?api-version=2025-11-01-preview&$select=name
api-key: {{api-key}}

    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-endpoint}}/knowledgebases/{{knowledge-base-name}}?api-version=2025-11-01-preview
api-key: {{api-key}}

    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 aggiornare la Knowledge Base rimuovendo la fonte di conoscenza se sono presenti più fonti. In questo esempio viene mostrata la procedura di eliminazione.

    ### Delete a knowledge base
DELETE {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}?api-version=2025-11-01-preview
api-key: {{api-key}}

  4. Eliminare la fonte di informazioni.

    ### Delete a knowledge source
DELETE {{search-endpoint}}/knowledgesources/{{knowledge-source-name}}?api-version=2025-11-01-preview
api-key: {{api-key}}

Contenuti correlati

  • Last updated on