Partager via

Créer une ressource de source de connaissances web

Important

Note

Cette fonctionnalité est actuellement disponible en préversion publique. Cette préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure.

La source de connaissances web permet la récupération de données web en temps réel à partir de Microsoft Bing dans un pipeline de récupération agentique. Les sources de connaissances sont créées indépendamment, référencées dans une base de connaissances et utilisées comme données de base lorsqu’un agent ou un chatbot appelle une action de récupération au moment de la requête.

La Recherche personnalisée Bing est toujours le fournisseur de recherche pour la source de connaissances du Web. Bien que vous ne puissiez pas spécifier d’autres fournisseurs de recherche ou moteurs, vous pouvez inclure ou exclure des domaines spécifiques, tels que https://learn.microsoft.com. Lorsqu’aucun domaine n’est spécifié, la source de connaissances web a un accès illimité à l’ensemble de l’Internet public.

La source de connaissances web fonctionne le mieux avec d’autres sources de connaissances. Utilisez la source de connaissances web lorsque votre contenu propriétaire ne fournit pas de réponses complètes, up-to-date ou lorsque vous souhaitez compléter les résultats avec des informations d’un moteur de recherche commercial.

Lorsque vous utilisez la source de connaissances web, gardez à l’esprit ce qui suit :

  • La réponse est toujours une réponse unique et formulée à la requête au lieu de résultats de recherche bruts à partir du web.

  • Étant donné que la source de connaissances web ne prend pas en charge les données extractives, votre base de connaissances doit utiliser la synthèse des réponses et un effort de raisonnement faible ou moyen. Vous ne pouvez pas non plus définir d’instructions de réponse.

Prerequisites

Rechercher des sources de connaissances existantes

Une source de connaissances constitue un objet réutilisable de niveau supérieur. Connaître les sources de connaissances existantes est utile pour réutiliser ou nommer de nouveaux objets.

Exécutez le code suivant pour répertorier les sources de connaissances par nom et par type.

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

Vous pouvez également renvoyer une seule source de connaissances par nom pour passer en revue sa définition 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));

Le code JSON suivant est un exemple de réponse pour une ressource de source de connaissances web.

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

Créer une source de connaissances

Exécutez le code suivant pour créer une ressource de source de connaissances 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.");

Propriétés spécifiques à la source

Vous pouvez transmettre les propriétés suivantes pour créer une ressource de source de connaissances web.

Nom Descriptif Type Modifiable Obligatoire
Name Nom de la source de connaissances, qui doit être unique dans la collection de sources de connaissances et suivre les instructions d’affectation de noms pour les objets dans Recherche IA Azure. Chaîne Oui Oui
Description Description de la source de connaissances. Lorsqu’elle n’est pas spécifiée, Azure AI Search applique une description par défaut. Chaîne Oui Non
EncryptionKey Clé gérée par le client pour chiffrer les informations sensibles dans la source de connaissances. Objet Oui Non
WebParameters Paramètres spécifiques à la source de connaissances web. Actuellement, ce n’est que Domains. Objet Oui Non
Domains Domaines à autoriser ou bloquer à partir de l’espace de recherche. Par défaut, la source de connaissances utilise Grounding avec Recherche Bing pour rechercher l’ensemble de l’Internet public. Lorsque vous spécifiez des domaines, la source de connaissances utilise Grounding avec Recherche personnalisée Bing pour limiter les résultats aux domaines spécifiés. Dans les deux cas, Recherche personnalisée Bing est le fournisseur de recherche. Objet Oui Non
AllowedDomains Domaines à inclure dans l’espace de recherche. Pour chaque domaine, vous devez spécifier son address dans le format website.com. Vous pouvez également spécifier s’il faut inclure les sous-pages du domaine en définissant IncludeSubpages sur true ou false. Array Oui Non
BlockedDomains Domaines à exclure de l’espace de recherche. Pour chaque domaine, vous devez spécifier son address dans le format website.com. Vous pouvez également spécifier s’il faut inclure les sous-pages du domaine en définissant IncludeSubpages sur true ou false. Array Oui Non

Attribuer à une base de connaissances

Si vous êtes satisfait de la source de connaissances, passez à l’étape suivante : spécifiez la source de connaissances dans une base de connaissances.

Une fois la base de connaissances configurée, utilisez l’action de récupération pour interroger la source de connaissances.

Supprimer une source de connaissances

Avant de pouvoir supprimer une source de connaissances, vous devez supprimer toute base de connaissances qui la référence ou mettre à jour la définition de la base de connaissances pour supprimer la référence. Pour les sources de connaissances qui génèrent un pipeline d’index et d’indexeur, tous les objets générés sont également supprimés . Toutefois, si vous avez utilisé un index existant pour créer une source de connaissances, votre index n’est pas supprimé.

Si vous essayez de supprimer une source de connaissances en cours d’utilisation, l’action échoue et retourne une liste de bases de connaissances affectées.

Pour supprimer une source de connaissances :

  1. Obtenez la liste de toutes les bases de connaissances sur votre service de recherche.

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

    Un exemple de réponse peut ressembler à ce qui suit :

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

  2. Obtenez une définition de base de connaissances individuelle pour rechercher des références à la source de connaissances.

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

    Un exemple de réponse peut ressembler à ce qui suit :

     {
   "Name": "earth-knowledge-base",
   "KnowledgeSources": [
     {
       "Name": "earth-knowledge-source"
     }
   ],
   "Models": [
     {}
   ],
   "RetrievalReasoningEffort": {},
   "OutputMode": {},
   "ETag": "\u00220x8DE278629D782B3\u0022",
   "EncryptionKey": null,
   "Description": null,
   "RetrievalInstructions": null,
   "AnswerInstructions": null
 }

  3. Supprimez la base de connaissances ou mettez à jour la base de connaissances pour supprimer la source de connaissances si vous avez plusieurs sources. Cet exemple montre la suppression.

    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. Supprimer la source de connaissances.

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

Important

Note

Cette fonctionnalité est actuellement disponible en préversion publique. Cette préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure.

La source de connaissances web permet la récupération de données web en temps réel à partir de Microsoft Bing dans un pipeline de récupération agentique. Les sources de connaissances sont créées indépendamment, référencées dans une base de connaissances et utilisées comme données de base lorsqu’un agent ou un chatbot appelle une action de récupération au moment de la requête.

La Recherche personnalisée Bing est toujours le fournisseur de recherche pour la source de connaissances du Web. Bien que vous ne puissiez pas spécifier d’autres fournisseurs de recherche ou moteurs, vous pouvez inclure ou exclure des domaines spécifiques, tels que https://learn.microsoft.com. Lorsqu’aucun domaine n’est spécifié, la source de connaissances web a un accès illimité à l’ensemble de l’Internet public.

La source de connaissances web fonctionne le mieux avec d’autres sources de connaissances. Utilisez la source de connaissances web lorsque votre contenu propriétaire ne fournit pas de réponses complètes, up-to-date ou lorsque vous souhaitez compléter les résultats avec des informations d’un moteur de recherche commercial.

Lorsque vous utilisez la source de connaissances web, gardez à l’esprit ce qui suit :

  • La réponse est toujours une réponse unique et formulée à la requête au lieu de résultats de recherche bruts à partir du web.

  • Étant donné que la source de connaissances web ne prend pas en charge les données extractives, votre base de connaissances doit utiliser la synthèse des réponses et un effort de raisonnement faible ou moyen. Vous ne pouvez pas non plus définir d’instructions de réponse.

Prerequisites

Rechercher des sources de connaissances existantes

Une source de connaissances constitue un objet réutilisable de niveau supérieur. Connaître les sources de connaissances existantes est utile pour réutiliser ou nommer de nouveaux objets.

Exécutez le code suivant pour répertorier les sources de connaissances par nom et par type.

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

Vous pouvez également renvoyer une seule source de connaissances par nom pour passer en revue sa définition 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))

Le code JSON suivant est un exemple de réponse pour une ressource de source de connaissances web.

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

Créer une source de connaissances

Exécutez le code suivant pour créer une ressource de source de connaissances 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.")

Propriétés spécifiques à la source

Vous pouvez transmettre les propriétés suivantes pour créer une ressource de source de connaissances web.

Nom Descriptif Type Modifiable Obligatoire
name Nom de la source de connaissances, qui doit être unique dans la collection de sources de connaissances et suivre les instructions d’affectation de noms pour les objets dans Recherche IA Azure. Chaîne Oui Oui
description Description de la source de connaissances. Lorsqu’elle n’est pas spécifiée, Azure AI Search applique une description par défaut. Chaîne Oui Non
encryption_key Clé gérée par le client pour chiffrer les informations sensibles dans la source de connaissances. Objet Oui Non
web_parameters Paramètres spécifiques à la source de connaissances web. Actuellement, ce n’est que domains. Objet Oui Non
domains Domaines à autoriser ou bloquer à partir de l’espace de recherche. Par défaut, la source de connaissances utilise Grounding avec Recherche Bing pour rechercher l’ensemble de l’Internet public. Lorsque vous spécifiez des domaines, la source de connaissances utilise Grounding avec Recherche personnalisée Bing pour limiter les résultats aux domaines spécifiés. Dans les deux cas, Recherche personnalisée Bing est le fournisseur de recherche. Objet Oui Non
allowed_domains Domaines à inclure dans l’espace de recherche. Pour chaque domaine, vous devez spécifier son address dans le format website.com. Vous pouvez également spécifier s’il faut inclure les sous-pages du domaine en définissant include_subpages sur true ou false. Array Oui Non
blocked_domains Domaines à exclure de l’espace de recherche. Pour chaque domaine, vous devez spécifier son address dans le format website.com. Vous pouvez également spécifier s’il faut inclure les sous-pages du domaine en définissant include_subpages sur true ou false. Array Oui Non

Attribuer à une base de connaissances

Si vous êtes satisfait de la source de connaissances, passez à l’étape suivante : spécifiez la source de connaissances dans une base de connaissances.

Une fois la base de connaissances configurée, utilisez l’action de récupération pour interroger la source de connaissances.

Supprimer une source de connaissances

Avant de pouvoir supprimer une source de connaissances, vous devez supprimer toute base de connaissances qui la référence ou mettre à jour la définition de la base de connaissances pour supprimer la référence. Pour les sources de connaissances qui génèrent un pipeline d’index et d’indexeur, tous les objets générés sont également supprimés . Toutefois, si vous avez utilisé un index existant pour créer une source de connaissances, votre index n’est pas supprimé.

Si vous essayez de supprimer une source de connaissances en cours d’utilisation, l’action échoue et retourne une liste de bases de connaissances affectées.

Pour supprimer une source de connaissances :

  1. Obtenez la liste de toutes les bases de connaissances sur votre service de recherche.

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

    Un exemple de réponse peut ressembler à ce qui suit :

     {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

  2. Obtenez une définition de base de connaissances individuelle pour rechercher des références à la source de connaissances.

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

    Un exemple de réponse peut ressembler à ce qui suit :

     {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks",
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

  3. Supprimez la base de connaissances ou mettez à jour la base de connaissances pour supprimer la source de connaissances si vous avez plusieurs sources. Cet exemple montre la suppression.

    # 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. Supprimer la source de connaissances.

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

Important

Note

Cette fonctionnalité est actuellement disponible en préversion publique. Cette préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure.

La source de connaissances web permet la récupération de données web en temps réel à partir de Microsoft Bing dans un pipeline de récupération agentique. Les sources de connaissances sont créées indépendamment, référencées dans une base de connaissances et utilisées comme données de base lorsqu’un agent ou un chatbot appelle une action de récupération au moment de la requête.

La Recherche personnalisée Bing est toujours le fournisseur de recherche pour la source de connaissances du Web. Bien que vous ne puissiez pas spécifier d’autres fournisseurs de recherche ou moteurs, vous pouvez inclure ou exclure des domaines spécifiques, tels que https://learn.microsoft.com. Lorsqu’aucun domaine n’est spécifié, la source de connaissances web a un accès illimité à l’ensemble de l’Internet public.

La source de connaissances web fonctionne le mieux avec d’autres sources de connaissances. Utilisez la source de connaissances web lorsque votre contenu propriétaire ne fournit pas de réponses complètes, up-to-date ou lorsque vous souhaitez compléter les résultats avec des informations d’un moteur de recherche commercial.

Lorsque vous utilisez la source de connaissances web, gardez à l’esprit ce qui suit :

  • La réponse est toujours une réponse unique et formulée à la requête au lieu de résultats de recherche bruts à partir du web.

  • Étant donné que la source de connaissances web ne prend pas en charge les données extractives, votre base de connaissances doit utiliser la synthèse des réponses et un effort de raisonnement faible ou moyen. Vous ne pouvez pas non plus définir d’instructions de réponse.

Prerequisites

Rechercher des sources de connaissances existantes

Une source de connaissances constitue un objet réutilisable de niveau supérieur. Connaître les sources de connaissances existantes est utile pour réutiliser ou nommer de nouveaux objets.

Utilisez les sources de connaissances - Obtenir (API REST) pour répertorier les sources de connaissances par nom et par type.

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

Vous pouvez également renvoyer une seule source de connaissances par nom pour passer en revue sa définition JSON.

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

Le code JSON suivant est un exemple de réponse pour une ressource de source de connaissances web.

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

Créer une source de connaissances

Utilisez des sources de connaissances - Créer ou mettre à jour (API REST) pour créer une ressource de source de connaissances 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 } ]
    }
  }
}

Propriétés spécifiques à la source

Vous pouvez transmettre les propriétés suivantes pour créer une ressource de source de connaissances web.

Nom Descriptif Type Modifiable Obligatoire
name Nom de la source de connaissances, qui doit être unique dans la collection de sources de connaissances et suivre les instructions d’affectation de noms pour les objets dans Recherche IA Azure. Chaîne Oui Oui
kind Type de source de connaissances, qui est web dans ce cas. Chaîne Non Oui
description Description de la source de connaissances. Lorsqu’elle n’est pas spécifiée, Azure AI Search applique une description par défaut. Chaîne Oui Non
encryptionKey Clé gérée par le client pour chiffrer les informations sensibles dans la source de connaissances. Objet Oui Non
webParameters Paramètres spécifiques à la source de connaissances web. Actuellement, ce n’est que domains. Objet Oui Non
domains Domaines à autoriser ou bloquer à partir de l’espace de recherche. Par défaut, la source de connaissances utilise Grounding avec Recherche Bing pour rechercher l’ensemble de l’Internet public. Lorsque vous spécifiez des domaines, la source de connaissances utilise Grounding avec Recherche personnalisée Bing pour limiter les résultats aux domaines spécifiés. Dans les deux cas, Recherche personnalisée Bing est le fournisseur de recherche. Objet Oui Non
allowedDomains Domaines à inclure dans l’espace de recherche. Pour chaque domaine, vous devez spécifier son address dans le format website.com. Vous pouvez également spécifier s’il faut inclure les sous-pages du domaine en définissant includeSubpages sur true ou false. Array Oui Non
blockedDomains Domaines à exclure de l’espace de recherche. Pour chaque domaine, vous devez spécifier son address dans le format website.com. Vous pouvez également spécifier s’il faut inclure les sous-pages du domaine en définissant includeSubpages sur true ou false. Array Oui Non

Attribuer à une base de connaissances

Si vous êtes satisfait de la source de connaissances, passez à l’étape suivante : spécifiez la source de connaissances dans une base de connaissances.

Une fois la base de connaissances configurée, utilisez l’action de récupération pour interroger la source de connaissances.

Supprimer une source de connaissances

Avant de pouvoir supprimer une source de connaissances, vous devez supprimer toute base de connaissances qui la référence ou mettre à jour la définition de la base de connaissances pour supprimer la référence. Pour les sources de connaissances qui génèrent un pipeline d’index et d’indexeur, tous les objets générés sont également supprimés . Toutefois, si vous avez utilisé un index existant pour créer une source de connaissances, votre index n’est pas supprimé.

Si vous essayez de supprimer une source de connaissances en cours d’utilisation, l’action échoue et retourne une liste de bases de connaissances affectées.

Pour supprimer une source de connaissances :

  1. Obtenez la liste de toutes les bases de connaissances sur votre service de recherche.

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

    Un exemple de réponse peut ressembler à ce qui suit :

     {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

  2. Obtenez une définition de base de connaissances individuelle pour rechercher des références à la source de connaissances.

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

    Un exemple de réponse peut ressembler à ce qui suit :

     {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks",
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

  3. Supprimez la base de connaissances ou mettez à jour la base de connaissances en supprimant la source de connaissances si vous avez plusieurs sources. Cet exemple montre la suppression.

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

  4. Supprimer la source de connaissances.

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

Contenu connexe

  • Last updated on