Compartilhar via

Criar um recurso de Fonte de Conhecimento da Web

Importante

Observação

Esse recurso está atualmente em versão prévia pública. Essa visualização é fornecida sem um contrato de nível de serviço e não é recomendada para utilização em produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

A Fonte de Conhecimento Web permite a recuperação de dados da Web em tempo real do Microsoft Bing em um pipeline de recuperação por meio de agentes. As fontes de conhecimento são criadas de forma independente, referenciadas em uma base de dados de conhecimento e usadas como dados de aterramento quando um agente ou chatbot chama uma ação de recuperação no momento da consulta.

A Pesquisa Personalizada do Bing é sempre o provedor de pesquisa da Fonte de Conhecimento Web. Embora você não possa especificar provedores ou mecanismos de pesquisa alternativos, você pode incluir ou excluir domínios específicos, como https://learn.microsoft.com. Quando nenhum domínio é especificado, a Fonte de Conhecimento da Web tem acesso irrestrito a toda a Internet pública.

A Fonte de Conhecimento da Web funciona melhor junto com outras fontes de conhecimento. Use uma Fonte de Conhecimento Online quando o conteúdo proprietário não fornecer respostas completas ou atualizadas, ou quando você quiser complementar os resultados com informações de um motor de busca comercial.

Ao usar a Fonte de Conhecimento da Web, tenha o seguinte em mente:

  • A resposta é sempre uma única resposta formulada para a consulta em vez dos resultados brutos da pesquisa da Web.

  • Como a Fonte de Conhecimento da Web não dá suporte a dados extrativos, sua base de dados de conhecimento deve usar síntese de resposta e esforço de raciocínio baixo ou médio. Você também não pode definir instruções de resposta.

Pré-requisitos

Verificar se há fontes de conhecimento existentes

Uma fonte de conhecimento é um objeto reutilizável de nível superior. Saber sobre fontes de conhecimento existentes é útil para reutilizar ou nomear novos objetos.

Execute o código a seguir para listar fontes de conhecimento por nome e 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}");
}

Você também pode retornar uma única fonte de conhecimento por nome para revisar sua definição de 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));

O JSON a seguir é uma resposta de exemplo para um recurso de Fonte de Conhecimento da Web.

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

Criar uma fonte de conhecimento

Execute o código a seguir para criar um recurso de Fonte de Conhecimento da 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.");

Propriedades específicas da origem

Você pode passar as propriedades a seguir para criar um recurso de Fonte de Conhecimento da Web.

Nome Description Tipo Editável Obrigatório
Name O nome da fonte de conhecimento, que deve ser exclusivo na coleção de fontes de conhecimento e seguir as diretrizes de nomenclatura para objetos no Azure AI Search. String Yes Yes
Description Uma descrição da fonte de conhecimento. Quando não especificado, o Azure AI Search aplica uma descrição padrão. String Yes Não
EncryptionKey Uma chave gerenciada pelo cliente para criptografar informações confidenciais na fonte de conhecimento. Object Yes Não
WebParameters Parâmetros específicos da Fonte de Conhecimento da Web. Atualmente, isso é apenas Domains. Object Yes Não
Domains Domínios a serem permitidos ou bloqueados no espaço de pesquisa. Por padrão, a fonte de conhecimento usa o Fundamento com a Pesquisa do Bing para pesquisar em toda a Internet pública. Quando você especifica domínios, a fonte de conhecimento usa Grounding com a Pesquisa Personalizada do Bing para restringir os resultados aos domínios especificados. Em ambos os casos, a Pesquisa Personalizada do Bing é o provedor de pesquisa. Object Yes Não
AllowedDomains Domínios a serem incluídos no espaço de pesquisa. Para cada domínio, você deve especificar seu address no formato website.com. Você também pode especificar se deseja incluir as subpáginas do domínio definindo IncludeSubpages ou truefalse. Array Yes Não
BlockedDomains Domínios a serem excluídos do espaço de pesquisa. Para cada domínio, você deve especificar seu address no formato website.com. Você também pode especificar se deseja incluir as subpáginas do domínio definindo IncludeSubpages ou truefalse. Array Yes Não

Atribuir a uma base de dados de conhecimento

Se você estiver satisfeito com a fonte de conhecimento, prossiga para a próxima etapa: especifique a fonte de conhecimento em uma base de dados de conhecimento.

Depois que a base de dados de conhecimento estiver configurada, use a ação de recuperação para consultar a fonte de conhecimento.

Excluir uma fonte de conhecimento

Antes de excluir uma fonte de conhecimento, exclua qualquer base de dados de conhecimento que faça referência a ela ou atualize a definição da base de dados de conhecimento para remover a referência. Para fontes de conhecimento que geram um pipeline de índice e indexador, todos os objetos gerados também são excluídos . No entanto, se você usou um índice existente para criar uma fonte de conhecimento, seu índice não será excluído.

Se você tentar excluir uma fonte de conhecimento que está em uso, a ação falhará e retornará uma lista de bases de dados de conhecimento afetadas.

Para excluir uma fonte de conhecimento:

  1. Obtenha uma lista de todas as bases de dados de conhecimento em seu serviço de pesquisa.

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

    Uma resposta de exemplo pode ser semelhante à seguinte:

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

  2. Obtenha uma definição de base de conhecimento individual para verificar referências de fonte de conhecimento.

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

    Uma resposta de exemplo pode ser semelhante à seguinte:

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

  3. Exclua a base de dados de conhecimento ou atualize a base de dados de conhecimento para remover a fonte de conhecimento se você tiver várias fontes. Este exemplo mostra a exclusão.

    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. Exclua a fonte de conhecimento.

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

Importante

Observação

Esse recurso está atualmente em versão prévia pública. Essa visualização é fornecida sem um contrato de nível de serviço e não é recomendada para utilização em produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

A Fonte de Conhecimento Web permite a recuperação de dados da Web em tempo real do Microsoft Bing em um pipeline de recuperação por meio de agentes. As fontes de conhecimento são criadas de forma independente, referenciadas em uma base de dados de conhecimento e usadas como dados de aterramento quando um agente ou chatbot chama uma ação de recuperação no momento da consulta.

A Pesquisa Personalizada do Bing é sempre o provedor de pesquisa da Fonte de Conhecimento Web. Embora você não possa especificar provedores ou mecanismos de pesquisa alternativos, você pode incluir ou excluir domínios específicos, como https://learn.microsoft.com. Quando nenhum domínio é especificado, a Fonte de Conhecimento da Web tem acesso irrestrito a toda a Internet pública.

A Fonte de Conhecimento da Web funciona melhor junto com outras fontes de conhecimento. Use uma Fonte de Conhecimento Online quando o conteúdo proprietário não fornecer respostas completas ou atualizadas, ou quando você quiser complementar os resultados com informações de um motor de busca comercial.

Ao usar a Fonte de Conhecimento da Web, tenha o seguinte em mente:

  • A resposta é sempre uma única resposta formulada para a consulta em vez dos resultados brutos da pesquisa da Web.

  • Como a Fonte de Conhecimento da Web não dá suporte a dados extrativos, sua base de dados de conhecimento deve usar síntese de resposta e esforço de raciocínio baixo ou médio. Você também não pode definir instruções de resposta.

Pré-requisitos

Verificar se há fontes de conhecimento existentes

Uma fonte de conhecimento é um objeto reutilizável de nível superior. Saber sobre fontes de conhecimento existentes é útil para reutilizar ou nomear novos objetos.

Execute o código a seguir para listar fontes de conhecimento por nome e 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))

Você também pode retornar uma única fonte de conhecimento por nome para revisar sua definição de 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))

O JSON a seguir é uma resposta de exemplo para um recurso de Fonte de Conhecimento da Web.

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

Criar uma fonte de conhecimento

Execute o código a seguir para criar um recurso de Fonte de Conhecimento da 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.")

Propriedades específicas da origem

Você pode passar as propriedades a seguir para criar um recurso de Fonte de Conhecimento da Web.

Nome Description Tipo Editável Obrigatório
name O nome da fonte de conhecimento, que deve ser exclusivo na coleção de fontes de conhecimento e seguir as diretrizes de nomenclatura para objetos no Azure AI Search. String Yes Yes
description Uma descrição da fonte de conhecimento. Quando não especificado, o Azure AI Search aplica uma descrição padrão. String Yes Não
encryption_key Uma chave gerenciada pelo cliente para criptografar informações confidenciais na fonte de conhecimento. Object Yes Não
web_parameters Parâmetros específicos da Fonte de Conhecimento da Web. Atualmente, isso é apenas domains. Object Yes Não
domains Domínios a serem permitidos ou bloqueados no espaço de pesquisa. Por padrão, a fonte de conhecimento usa o Fundamento com a Pesquisa do Bing para pesquisar em toda a Internet pública. Quando você especifica domínios, a fonte de conhecimento usa Grounding com a Pesquisa Personalizada do Bing para restringir os resultados aos domínios especificados. Em ambos os casos, a Pesquisa Personalizada do Bing é o provedor de pesquisa. Object Yes Não
allowed_domains Domínios a serem incluídos no espaço de pesquisa. Para cada domínio, você deve especificar seu address no formato website.com. Você também pode especificar se deseja incluir as subpáginas do domínio definindo include_subpages ou truefalse. Array Yes Não
blocked_domains Domínios a serem excluídos do espaço de pesquisa. Para cada domínio, você deve especificar seu address no formato website.com. Você também pode especificar se deseja incluir as subpáginas do domínio definindo include_subpages ou truefalse. Array Yes Não

Atribuir a uma base de dados de conhecimento

Se você estiver satisfeito com a fonte de conhecimento, prossiga para a próxima etapa: especifique a fonte de conhecimento em uma base de dados de conhecimento.

Depois que a base de dados de conhecimento estiver configurada, use a ação de recuperação para consultar a fonte de conhecimento.

Excluir uma fonte de conhecimento

Antes de excluir uma fonte de conhecimento, exclua qualquer base de dados de conhecimento que faça referência a ela ou atualize a definição da base de dados de conhecimento para remover a referência. Para fontes de conhecimento que geram um pipeline de índice e indexador, todos os objetos gerados também são excluídos . No entanto, se você usou um índice existente para criar uma fonte de conhecimento, seu índice não será excluído.

Se você tentar excluir uma fonte de conhecimento que está em uso, a ação falhará e retornará uma lista de bases de dados de conhecimento afetadas.

Para excluir uma fonte de conhecimento:

  1. Obtenha uma lista de todas as bases de dados de conhecimento em seu serviço de pesquisa.

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

    Uma resposta de exemplo pode ser semelhante à seguinte:

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

  2. Obtenha uma definição de base de conhecimento individual para verificar referências de fonte de conhecimento.

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

    Uma resposta de exemplo pode ser semelhante à seguinte:

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

  3. Exclua a base de dados de conhecimento ou atualize a base de dados de conhecimento para remover a fonte de conhecimento se você tiver várias fontes. Este exemplo mostra a exclusão.

    # 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. Exclua a fonte de conhecimento.

    # 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

Observação

Esse recurso está atualmente em versão prévia pública. Essa visualização é fornecida sem um contrato de nível de serviço e não é recomendada para utilização em produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

A Fonte de Conhecimento Web permite a recuperação de dados da Web em tempo real do Microsoft Bing em um pipeline de recuperação por meio de agentes. As fontes de conhecimento são criadas de forma independente, referenciadas em uma base de dados de conhecimento e usadas como dados de aterramento quando um agente ou chatbot chama uma ação de recuperação no momento da consulta.

A Pesquisa Personalizada do Bing é sempre o provedor de pesquisa da Fonte de Conhecimento Web. Embora você não possa especificar provedores ou mecanismos de pesquisa alternativos, você pode incluir ou excluir domínios específicos, como https://learn.microsoft.com. Quando nenhum domínio é especificado, a Fonte de Conhecimento da Web tem acesso irrestrito a toda a Internet pública.

A Fonte de Conhecimento da Web funciona melhor junto com outras fontes de conhecimento. Use uma Fonte de Conhecimento Online quando o conteúdo proprietário não fornecer respostas completas ou atualizadas, ou quando você quiser complementar os resultados com informações de um motor de busca comercial.

Ao usar a Fonte de Conhecimento da Web, tenha o seguinte em mente:

  • A resposta é sempre uma única resposta formulada para a consulta em vez dos resultados brutos da pesquisa da Web.

  • Como a Fonte de Conhecimento da Web não dá suporte a dados extrativos, sua base de dados de conhecimento deve usar síntese de resposta e esforço de raciocínio baixo ou médio. Você também não pode definir instruções de resposta.

Pré-requisitos

Verificar se há fontes de conhecimento existentes

Uma fonte de conhecimento é um objeto reutilizável de nível superior. Saber sobre fontes de conhecimento existentes é útil para reutilizar ou nomear novos objetos.

Use Fontes de Conhecimento – Obter (API REST) para listar fontes de conhecimento por nome e 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}}

Você também pode retornar uma única fonte de conhecimento por nome para revisar sua definição de JSON.

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

O JSON a seguir é uma resposta de exemplo para um recurso de Fonte de Conhecimento da Web.

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

Criar uma fonte de conhecimento

Use Fontes de Conhecimento – Criar ou Atualizar (API REST) para criar um recurso da Fonte de Conhecimento da 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 } ]
    }
  }
}

Propriedades específicas da origem

Você pode passar as propriedades a seguir para criar um recurso de Fonte de Conhecimento da Web.

Nome Description Tipo Editável Obrigatório
name O nome da fonte de conhecimento, que deve ser exclusivo na coleção de fontes de conhecimento e seguir as diretrizes de nomenclatura para objetos no Azure AI Search. String Yes Yes
kind O tipo de fonte de conhecimento, que é web neste caso. String Não Yes
description Uma descrição da fonte de conhecimento. Quando não especificado, o Azure AI Search aplica uma descrição padrão. String Yes Não
encryptionKey Uma chave gerenciada pelo cliente para criptografar informações confidenciais na fonte de conhecimento. Object Yes Não
webParameters Parâmetros específicos da Fonte de Conhecimento da Web. Atualmente, isso é apenas domains. Object Yes Não
domains Domínios a serem permitidos ou bloqueados no espaço de pesquisa. Por padrão, a fonte de conhecimento usa o Fundamento com a Pesquisa do Bing para pesquisar em toda a Internet pública. Quando você especifica domínios, a fonte de conhecimento usa Grounding com a Pesquisa Personalizada do Bing para restringir os resultados aos domínios especificados. Em ambos os casos, a Pesquisa Personalizada do Bing é o provedor de pesquisa. Object Yes Não
allowedDomains Domínios a serem incluídos no espaço de pesquisa. Para cada domínio, você deve especificar seu address no formato website.com. Você também pode especificar se deseja incluir as subpáginas do domínio definindo includeSubpages ou truefalse. Array Yes Não
blockedDomains Domínios a serem excluídos do espaço de pesquisa. Para cada domínio, você deve especificar seu address no formato website.com. Você também pode especificar se deseja incluir as subpáginas do domínio definindo includeSubpages ou truefalse. Array Yes Não

Atribuir a uma base de dados de conhecimento

Se você estiver satisfeito com a fonte de conhecimento, prossiga para a próxima etapa: especifique a fonte de conhecimento em uma base de dados de conhecimento.

Depois que a base de dados de conhecimento estiver configurada, use a ação de recuperação para consultar a fonte de conhecimento.

Excluir uma fonte de conhecimento

Antes de excluir uma fonte de conhecimento, exclua qualquer base de dados de conhecimento que faça referência a ela ou atualize a definição da base de dados de conhecimento para remover a referência. Para fontes de conhecimento que geram um pipeline de índice e indexador, todos os objetos gerados também são excluídos . No entanto, se você usou um índice existente para criar uma fonte de conhecimento, seu índice não será excluído.

Se você tentar excluir uma fonte de conhecimento que está em uso, a ação falhará e retornará uma lista de bases de dados de conhecimento afetadas.

Para excluir uma fonte de conhecimento:

  1. Obtenha uma lista de todas as bases de dados de conhecimento em seu serviço de pesquisa.

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

    Uma resposta de exemplo pode ser semelhante à seguinte:

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

  2. Obtenha uma definição de base de conhecimento individual para verificar referências de fonte de conhecimento.

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

    Uma resposta de exemplo pode ser semelhante à seguinte:

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

  3. Exclua a base de dados de conhecimento ou atualize a base de dados de conhecimento removendo a fonte de conhecimento se você tiver várias fontes. Este exemplo mostra a exclusão.

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

  4. Exclua a fonte de conhecimento.

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

Conteúdo relacionado

  • Last updated on