Compartir a través de

Creación de un recurso de origen de conocimiento web

Importante

Nota:

Esta característica actualmente está en su versión preliminar pública. Esta versión preliminar se ofrece sin contrato de nivel de servicio y no es aconsejable usarla en las cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

Web Knowledge Source permite la recuperación de datos web en tiempo real de Microsoft Bing en una canalización de recuperación agente. Los orígenes de conocimiento se crean de forma independiente, se hace referencia en una base de conocimiento y se usan como datos de base cuando un agente o bot de chat llama a una acción de recuperación en el momento de la consulta.

Bing Custom Search es siempre el proveedor de búsqueda de Web Knowledge Source. Aunque no puede especificar proveedores o motores de búsqueda alternativos, puede incluir o excluir dominios específicos, como https://learn.microsoft.com. Cuando no se especifica ningún dominio, Web Knowledge Source tiene acceso sin restricciones a toda la red pública de Internet.

El origen de conocimiento web funciona mejor junto con otros orígenes de conocimiento. Use Web Knowledge Source cuando el contenido propietario no proporcione respuestas completas, up-to-date o cuando desee complementar los resultados con información de un motor de búsqueda comercial.

Al utilizar la fuente de conocimiento web, tenga en cuenta lo siguiente:

  • La respuesta siempre es una respuesta única formulada a la consulta en lugar de resultados de búsqueda sin procesar de la web.

  • Dado que El origen de conocimiento web no admite datos extractivos, la base de conocimiento debe usar la síntesis de respuestas y el esfuerzo de razonamiento bajo o medio. Tampoco puede definir instrucciones de respuesta.

Prerrequisitos

Comprobación de fuentes de conocimiento existentes

Una fuente de conocimiento es un objeto reutilizable de nivel superior. Conocer los orígenes de conocimiento existentes resulta útil para reutilizar o asignar nombres a nuevos objetos.

Ejecute el código siguiente para enumerar los orígenes de conocimiento por nombre y 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}");
}

También puede devolver una única fuente de conocimiento por nombre para revisar su definición 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));

El siguiente json es una respuesta de ejemplo para un recurso de origen de conocimiento web.

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

Creación de una fuente de conocimiento

Ejecute el código siguiente para crear un recurso de origen de conocimiento 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.");

Propiedades específicas del origen

Puede pasar las siguientes propiedades para crear un recurso de origen de conocimiento web.

Nombre Description Tipo Modificable Obligatorio
Name El nombre del origen de conocimiento, que debe ser único dentro de la colección de orígenes de conocimiento y seguir las directrices de nomenclatura de los objetos de Azure AI Search. String Sí Sí
Description Descripción del origen de conocimiento. Cuando no se especifica, Azure AI Search aplica una descripción predeterminada. String Sí No
EncryptionKey Una clave administrada por el cliente para cifrar información confidencial en el origen de conocimiento. Objeto Sí No
WebParameters Parámetros específicos del origen de conocimiento web. Actualmente, solo es Domains. Objeto Sí No
Domains Dominios para permitir o bloquear en el espacio de búsqueda. De forma predeterminada, el origen de conocimiento usa Grounding con Bing Search para buscar en toda la red pública de Internet. Al especificar dominios, el origen de conocimiento usa Grounding con Bing Custom Search para restringir los resultados a los dominios especificados. En ambos casos, Bing Custom Search es el proveedor de búsqueda. Objeto Sí No
AllowedDomains Dominios que se van a incluir en el espacio de búsqueda. Para cada dominio, debe especificar su address en el formato website.com. También puede especificar si se deben incluir las subpáginas del dominio estableciendo IncludeSubpages en true o false. Array Sí No
BlockedDomains Dominios que se excluirán del espacio de búsqueda. Para cada dominio, debe especificar su address en el formato website.com. También puede especificar si se deben incluir las subpáginas del dominio estableciendo IncludeSubpages en true o false. Array Sí No

Asignar a una base de conocimiento

Si está satisfecho con el origen de conocimiento, continúe con el paso siguiente: especifique el origen de conocimiento en una base de conocimiento.

Una vez configurada la base de conocimiento, use la acción recuperar para consultar el origen de conocimiento.

Eliminación de una fuente de conocimiento

Para poder eliminar un origen de conocimiento, debe eliminar cualquier base de conocimiento que haga referencia a ella o actualizar la definición de la base de conocimiento para quitar la referencia. En el caso de los orígenes de conocimiento que generan una canalización de índice e indexador, también se eliminan todos los objetos generados . Sin embargo, si usó un índice existente para crear un origen de conocimiento, el índice no se eliminará.

Si intenta eliminar un origen de conocimiento que está en uso, se produce un error en la acción y devuelve una lista de bases de conocimiento afectadas.

Para eliminar un origen de conocimiento:

  1. Obtenga una lista de todas las bases de conocimiento del servicio de búsqueda.

    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 respuesta de ejemplo podría ser similar a la siguiente:

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

  2. Obtenga una definición de base de conocimiento individual para comprobar si hay referencias de origen de conocimiento.

    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 respuesta de ejemplo podría ser similar a la siguiente:

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

  3. Elimine la base de conocimiento o actualice la base de conocimiento para quitar el origen de conocimiento si tiene varios orígenes. En este ejemplo se muestra la eliminación.

    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. Elimine la fuente de conocimiento.

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

Importante

Nota:

Esta característica actualmente está en su versión preliminar pública. Esta versión preliminar se ofrece sin contrato de nivel de servicio y no es aconsejable usarla en las cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

Web Knowledge Source permite la recuperación de datos web en tiempo real de Microsoft Bing en una canalización de recuperación agente. Los orígenes de conocimiento se crean de forma independiente, se hace referencia en una base de conocimiento y se usan como datos de base cuando un agente o bot de chat llama a una acción de recuperación en el momento de la consulta.

Bing Custom Search es siempre el proveedor de búsqueda de Web Knowledge Source. Aunque no puede especificar proveedores o motores de búsqueda alternativos, puede incluir o excluir dominios específicos, como https://learn.microsoft.com. Cuando no se especifica ningún dominio, Web Knowledge Source tiene acceso sin restricciones a toda la red pública de Internet.

El origen de conocimiento web funciona mejor junto con otros orígenes de conocimiento. Use Web Knowledge Source cuando el contenido propietario no proporcione respuestas completas, up-to-date o cuando desee complementar los resultados con información de un motor de búsqueda comercial.

Al utilizar la fuente de conocimiento web, tenga en cuenta lo siguiente:

  • La respuesta siempre es una respuesta única formulada a la consulta en lugar de resultados de búsqueda sin procesar de la web.

  • Dado que El origen de conocimiento web no admite datos extractivos, la base de conocimiento debe usar la síntesis de respuestas y el esfuerzo de razonamiento bajo o medio. Tampoco puede definir instrucciones de respuesta.

Prerrequisitos

Comprobación de fuentes de conocimiento existentes

Una fuente de conocimiento es un objeto reutilizable de nivel superior. Conocer los orígenes de conocimiento existentes resulta útil para reutilizar o asignar nombres a nuevos objetos.

Ejecute el código siguiente para enumerar los orígenes de conocimiento por nombre y 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))

También puede devolver una única fuente de conocimiento por nombre para revisar su definición 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))

El siguiente json es una respuesta de ejemplo para un recurso de origen de conocimiento web.

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

Creación de una fuente de conocimiento

Ejecute el código siguiente para crear un recurso de origen de conocimiento 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.")

Propiedades específicas del origen

Puede pasar las siguientes propiedades para crear un recurso de origen de conocimiento web.

Nombre Description Tipo Modificable Obligatorio
name El nombre del origen de conocimiento, que debe ser único dentro de la colección de orígenes de conocimiento y seguir las directrices de nomenclatura de los objetos de Azure AI Search. String Sí Sí
description Descripción del origen de conocimiento. Cuando no se especifica, Azure AI Search aplica una descripción predeterminada. String Sí No
encryption_key Una clave administrada por el cliente para cifrar información confidencial en el origen de conocimiento. Objeto Sí No
web_parameters Parámetros específicos del origen de conocimiento web. Actualmente, solo es domains. Objeto Sí No
domains Dominios para permitir o bloquear en el espacio de búsqueda. De forma predeterminada, el origen de conocimiento usa Grounding con Bing Search para buscar en toda la red pública de Internet. Al especificar dominios, el origen de conocimiento usa Grounding con Bing Custom Search para restringir los resultados a los dominios especificados. En ambos casos, Bing Custom Search es el proveedor de búsqueda. Objeto Sí No
allowed_domains Dominios que se van a incluir en el espacio de búsqueda. Para cada dominio, debe especificar su address en el formato website.com. También puede especificar si se deben incluir las subpáginas del dominio estableciendo include_subpages en true o false. Array Sí No
blocked_domains Dominios que se excluirán del espacio de búsqueda. Para cada dominio, debe especificar su address en el formato website.com. También puede especificar si se deben incluir las subpáginas del dominio estableciendo include_subpages en true o false. Array Sí No

Asignar a una base de conocimiento

Si está satisfecho con el origen de conocimiento, continúe con el paso siguiente: especifique el origen de conocimiento en una base de conocimiento.

Una vez configurada la base de conocimiento, use la acción recuperar para consultar el origen de conocimiento.

Eliminación de una fuente de conocimiento

Para poder eliminar un origen de conocimiento, debe eliminar cualquier base de conocimiento que haga referencia a ella o actualizar la definición de la base de conocimiento para quitar la referencia. En el caso de los orígenes de conocimiento que generan una canalización de índice e indexador, también se eliminan todos los objetos generados . Sin embargo, si usó un índice existente para crear un origen de conocimiento, el índice no se eliminará.

Si intenta eliminar un origen de conocimiento que está en uso, se produce un error en la acción y devuelve una lista de bases de conocimiento afectadas.

Para eliminar un origen de conocimiento:

  1. Obtenga una lista de todas las bases de conocimiento del servicio de búsqueda.

    # 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 respuesta de ejemplo podría ser similar a la siguiente:

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

  2. Obtenga una definición de base de conocimiento individual para comprobar si hay referencias de origen de conocimiento.

    # 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 respuesta de ejemplo podría ser similar a la siguiente:

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

  3. Elimine la base de conocimiento o actualice la base de conocimiento para quitar el origen de conocimiento si tiene varios orígenes. En este ejemplo se muestra la eliminación.

    # 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. Elimine la fuente de conocimiento.

    # 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

Nota:

Esta característica actualmente está en su versión preliminar pública. Esta versión preliminar se ofrece sin contrato de nivel de servicio y no es aconsejable usarla en las cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

Web Knowledge Source permite la recuperación de datos web en tiempo real de Microsoft Bing en una canalización de recuperación agente. Los orígenes de conocimiento se crean de forma independiente, se hace referencia en una base de conocimiento y se usan como datos de base cuando un agente o bot de chat llama a una acción de recuperación en el momento de la consulta.

Bing Custom Search es siempre el proveedor de búsqueda de Web Knowledge Source. Aunque no puede especificar proveedores o motores de búsqueda alternativos, puede incluir o excluir dominios específicos, como https://learn.microsoft.com. Cuando no se especifica ningún dominio, Web Knowledge Source tiene acceso sin restricciones a toda la red pública de Internet.

El origen de conocimiento web funciona mejor junto con otros orígenes de conocimiento. Use Web Knowledge Source cuando el contenido propietario no proporcione respuestas completas, up-to-date o cuando desee complementar los resultados con información de un motor de búsqueda comercial.

Al utilizar la fuente de conocimiento web, tenga en cuenta lo siguiente:

  • La respuesta siempre es una respuesta única formulada a la consulta en lugar de resultados de búsqueda sin procesar de la web.

  • Dado que El origen de conocimiento web no admite datos extractivos, la base de conocimiento debe usar la síntesis de respuestas y el esfuerzo de razonamiento bajo o medio. Tampoco puede definir instrucciones de respuesta.

Prerrequisitos

Comprobación de fuentes de conocimiento existentes

Una fuente de conocimiento es un objeto reutilizable de nivel superior. Conocer los orígenes de conocimiento existentes resulta útil para reutilizar o asignar nombres a nuevos objetos.

Usar Fuentes de conocimiento - Obtener (API REST) para listar las fuentes de conocimiento por nombre y 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}}

También puede devolver una única fuente de conocimiento por nombre para revisar su definición json.

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

El siguiente json es una respuesta de ejemplo para un recurso de origen de conocimiento web.

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

Creación de una fuente de conocimiento

Usar orígenes de conocimiento: crear o actualizar (API REST) para crear un recurso de origen de conocimiento 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 } ]
    }
  }
}

Propiedades específicas del origen

Puede pasar las siguientes propiedades para crear un recurso de origen de conocimiento web.

Nombre Description Tipo Modificable Obligatorio
name El nombre del origen de conocimiento, que debe ser único dentro de la colección de orígenes de conocimiento y seguir las directrices de nomenclatura de los objetos de Azure AI Search. String Sí Sí
kind El tipo de origen de conocimiento, que es web en este caso. String No Sí
description Descripción del origen de conocimiento. Cuando no se especifica, Azure AI Search aplica una descripción predeterminada. String Sí No
encryptionKey Una clave administrada por el cliente para cifrar información confidencial en el origen de conocimiento. Objeto Sí No
webParameters Parámetros específicos del origen de conocimiento web. Actualmente, solo es domains. Objeto Sí No
domains Dominios para permitir o bloquear en el espacio de búsqueda. De forma predeterminada, el origen de conocimiento usa Grounding con Bing Search para buscar en toda la red pública de Internet. Al especificar dominios, el origen de conocimiento usa Grounding con Bing Custom Search para restringir los resultados a los dominios especificados. En ambos casos, Bing Custom Search es el proveedor de búsqueda. Objeto Sí No
allowedDomains Dominios que se van a incluir en el espacio de búsqueda. Para cada dominio, debe especificar su address en el formato website.com. También puede especificar si se deben incluir las subpáginas del dominio estableciendo includeSubpages en true o false. Array Sí No
blockedDomains Dominios que se excluirán del espacio de búsqueda. Para cada dominio, debe especificar su address en el formato website.com. También puede especificar si se deben incluir las subpáginas del dominio estableciendo includeSubpages en true o false. Array Sí No

Asignar a una base de conocimiento

Si está satisfecho con el origen de conocimiento, continúe con el paso siguiente: especifique el origen de conocimiento en una base de conocimiento.

Una vez configurada la base de conocimiento, use la acción recuperar para consultar el origen de conocimiento.

Eliminación de una fuente de conocimiento

Para poder eliminar un origen de conocimiento, debe eliminar cualquier base de conocimiento que haga referencia a ella o actualizar la definición de la base de conocimiento para quitar la referencia. En el caso de los orígenes de conocimiento que generan una canalización de índice e indexador, también se eliminan todos los objetos generados . Sin embargo, si usó un índice existente para crear un origen de conocimiento, el índice no se eliminará.

Si intenta eliminar un origen de conocimiento que está en uso, se produce un error en la acción y devuelve una lista de bases de conocimiento afectadas.

Para eliminar un origen de conocimiento:

  1. Obtenga una lista de todas las bases de conocimiento del servicio de búsqueda.

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

    Una respuesta de ejemplo podría ser similar a la siguiente:

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

  2. Obtenga una definición de base de conocimiento individual para comprobar si hay referencias de origen de conocimiento.

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

    Una respuesta de ejemplo podría ser similar a la siguiente:

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

  3. Elimine la base de conocimiento o actualice la base de conocimiento quitando el origen de conocimiento si tiene varios orígenes. En este ejemplo se muestra la eliminación.

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

  4. Elimine la fuente de conocimiento.

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

Contenido relacionado

  • Last updated on