Gestionar la base de conocimiento en Agentic Retrieval en Foundry Local

Este artículo explica cómo gestionar tu base de conocimientos en Agentic Retrieval. Una base de conocimiento es un objeto de configuración y límite que agrupa uno o varios orígenes de conocimiento . Define a qué datos puede acceder el sistema al procesar consultas de usuario.

Cada implementación incluye una base de conocimiento predeterminada que se aprovisiona automáticamente. Los cambios en la base de conocimiento se sincronizan automáticamente con su agente interno emparejado.

Prerrequisitos

• Implemente Recuperación de agentes en modo combinado o de agentes.

• Cree al menos un origen de conocimiento. Consulte Configuración de un origen de conocimiento.

• Configurar la autenticación. Necesita un token de portador con el rol EdgeRAGDeveloper para realizar operaciones de escritura.

  az account clear
  az login --tenant <your-tenant-id> --output none
  
  TOKEN=$(az account get-access-token \
    --resource "api://<app-registration-client-id>" \
    --query accessToken -o tsv)
  

Paso 1: Obtener la base de conocimiento predeterminada

Para recuperar la base de conocimiento predeterminada, envíe una solicitud GET:

curl https://<cluster-domain>/knowledge-bases?limit=1 \
  -H "Authorization: Bearer $TOKEN"

La respuesta incluye el identificador de la base de conocimiento que utilizará como <kb-id> en los pasos siguientes.

Paso 2: Vincular orígenes de conocimiento

Las fuentes de conocimiento se pueden vincular a su base de conocimientos mediante PATCH. Para agregar orígenes, use una solicitud PATCH para actualizar la knowledge_source_ids matriz.

1. Obtenga los identificadores de origen de conocimiento actuales:

   CURRENT=$(curl -s https://<cluster-domain>/knowledge-bases/<kb-id> \
     -H "Authorization: Bearer $TOKEN" | jq -r '.data.knowledge_source_ids')
   

2. Envíe una solicitud PATCH con la lista actualizada (incluya todos los identificadores deseados):

   curl -X PATCH https://<cluster-domain>/knowledge-bases/<kb-id> \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $TOKEN" \
     -d '{
       "knowledge_source_ids": ["<existing-ks-id>", "<new-ks-id>"]
     }'
   

   Importante

   PATCH reemplaza todo el knowledge_source_ids array. No se adjunta. Debe incluir todos los ID deseados en el array. Si se omite un identificador existente, se quita eficazmente ese origen de conocimiento de la base de conocimiento.

Paso 3: Actualización de la base de conocimiento

Puede actualizar una base de conocimiento mediante solicitudes PATCH (actualización parcial) o PUT (reemplazo completo).

Actualización parcial (PATCH)

Envíe una solicitud PATCH solo con los campos que desea actualizar:

curl -X PATCH https://<cluster-domain>/knowledge-bases/<kb-id> \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "name": "Updated Product KB",
    "description": "Updated description"
  }'

Solo se actualizan los campos proporcionados. Los campos omitidos permanecen sin cambios.

Sustitución completa (PUT)

Envíe una solicitud PUT con todos los campos obligatorios:

curl -X PUT https://<cluster-domain>/knowledge-bases/<kb-id> \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "name": "Replaced Product KB",
    "knowledge_source_ids": ["<new-ks-id>"]
  }'

Todos los campos se sobrescriben. Los campos no incluidos se restablecen a los valores predeterminados.

Paso 4: Enumerar las bases de conocimiento

Para recuperar una lista de todas las bases de conocimiento, envíe una solicitud GET al punto de conexión de knowledge bases:

curl https://<cluster-domain>/knowledge-bases?limit=10&order=desc \
  -H "Authorization: Bearer $TOKEN"

La respuesta incluye la paginación basada en cursores con parámetros after y before para navegar por grandes conjuntos de resultados.

procedimientos recomendados

1. Orígenes relacionados con el grupo: vincule todos los orígenes de conocimiento relacionados a la base de conocimiento predeterminada (por ejemplo, manuales de producto y preguntas más frecuentes juntos).
2. Iniciar sencillo: comience con las herramientas de búsqueda integradas del servidor MCP y agregue servidores MCP externos según sea necesario.
3. Usar metadatos: etiquete la base de conocimiento con el departamento, la versión o el entorno de la organización.
4. Realice una auditoría antes de PATCH: Dado que PATCH reemplaza toda la matriz knowledge_source_ids, lea primero el estado actual para no eliminar accidentalmente los orígenes.

Contenido relacionado

• Configuración de un origen de conocimiento
• La capa agéntica en la recuperación agéntica
• Inicio rápido: Consulta tus datos con recuperación agéntica