POST

Endpoint /api/process-knowledge

URL

https://api.integrationit.co/api/process-knowledge

Descripción

Este endpoint inicia el procesamiento asíncrono de todos los archivos en la base de conocimiento. El procesamiento extrae la información de los archivos y la prepara para ser utilizada por el agente de IA, lo que permite que el agente responda preguntas basadas en el contenido de estos documentos.

Importante: Este endpoint funciona de manera asíncrona. Devuelve inmediatamente un ID de trabajo que puede ser utilizado para consultar el estado del procesamiento mediante el endpoint/api/knowledge-processing-status.

Autenticación

Requiere el header x-api-key con una API key válida.

Parámetros

Este endpoint no requiere parámetros adicionales en el cuerpo de la solicitud.

Respuesta

La respuesta confirma el inicio del procesamiento asíncrono:

{
  "company": {
    "name": "Nombre de la empresa"
  },
  "success": true,
  "message": "Solicitud de procesamiento iniciada correctamente",
  "job": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "pending",
    "started_at": "2023-08-09T12:34:56.789Z",
    "created_at": "2023-08-09T12:34:56.789Z"
  }
}

Si ya existe un procesamiento en curso para la empresa, se devolverá información sobre ese trabajo:

{
  "company": {
    "name": "Nombre de la empresa"
  },
  "success": true,
  "message": "Ya existe un procesamiento en curso para esta empresa",
  "job": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "processing",
    "started_at": "2023-08-09T12:34:56.789Z",
    "created_at": "2023-08-09T12:34:56.789Z"
  }
}

Ejemplos

curl -X POST https://api.integrationit.co/api/process-knowledge \
  -H "x-api-key: SU_API_KEY_AQUI"

Notas adicionales

El procesamiento es asíncrono. Utilice el endpoint /api/knowledge-processing-status para verificar el estado del procesamiento.

  • El agente de IA comenzará a utilizar la información procesada automáticamente una vez que el procesamiento haya finalizado.
  • Siempre se elimina toda la base de conocimiento y se vuelven a procesar todos los archivos que hayan sido subidos.
  • Los formatos de archivo soportados para procesamiento incluyen: PDF
  • El procesamiento puede tomar varios minutos dependiendo del tamaño y cantidad de archivos.
  • Solo puede haber un procesamiento activo por empresa a la vez.