Creación de una base de conocimiento para flujos de trabajo agente que se usarán en Azure Logic Apps (versión preliminar)

Se aplica a: Azure Logic Apps (Estándar)

Su organización genera datos no estructurados a partir de documentos, hojas de cálculo, API y sistemas internos. Al usar la funcionalidad de base de conocimiento como servicio (KBaaS) de Azure Logic Apps, puede convertir este contenido en una base de conocimiento estructurada y más fácil de buscar que los bucles de agente en flujos de trabajo agénticos pueden usar para completar tareas. Una base de conocimiento es un contenedor lógico que organiza orígenes de conocimiento relacionados, como documentos o archivos relacionados con un dominio específico.

Por ejemplo, puede crear una base de conocimiento que contenga todos los documentos relacionados con las directivas y procedimientos de RR. HH. Al crear una base de conocimiento, KBaaS configura automáticamente las directivas de indexación, contenedores y bases de datos de Azure Cosmos DB necesarias. Para obtener más información, consulte Azure Cosmos DB bases de datos, contenedores y elementos.

En esta guía se muestra cómo crear una base de conocimiento, cargar orígenes de conocimiento y agregar la base de conocimiento como una herramienta que un bucle de agente puede usar en un flujo de trabajo agente estándar.

Limitaciones

Esta versión preliminar tiene las siguientes limitaciones:

• Esta versión preliminar admite las siguientes funcionalidades:

  • Archivos cargados como tipo de origen para artefactos de conocimiento.
  • Archivos con los siguientes formatos: DOC, DOCX, HTML, MD, PDF, PPT, PPTX, TXT, XLS, XLSX.
  • Análisis de contenido basado en texto en documentos, no imágenes.
  • Configuración de fragmentación predeterminada, no fragmentación personalizada.

• Después de crear la conexión con la base de conocimiento, solo podrá editar los nombres para mostrar de la conexión y de los modelos de Azure OpenAI. No puede editar ningún otro valor, como el tipo de autenticación o la información del punto de conexión.

• Actualmente, solo se admite el portal de Azure para esta funcionalidad.

Funcionamiento de una base de conocimiento

KBaaS simplifica la transformación de datos y proporciona una capa de abstracción sobre Azure Cosmos DB y Azure OpenAI para que los flujos de trabajo puedan consumir, procesar y recuperar conocimientos estructurados más fácilmente sin crear una canalización personalizada de generación de Retrieval-Augmented (RAG).

KBaaS tiene las siguientes canalizaciones:

• Canalización de ingesta: al cargar un documento o un origen de conocimiento en la base de conocimiento, el servicio analiza, fragmenta, resume y vectoriza automáticamente el contenido. A continuación, el servicio almacena los resultados en Azure Cosmos DB.

• Canalización deRetrieval: cuando el bucle del agente consulta la base de conocimiento, el servicio vuelve a escribir la consulta si es necesario, genera una representación vectorial, realiza una búsqueda semántica en Azure Cosmos DB y devuelve los fragmentos más relevantes al modelo de lenguaje grande (LLM) para la generación de respuestas.

Prerequisites

• Una cuenta y una suscripción de Azure. Obtenga una cuenta gratuita de Azure.

• Un recurso de Azure OpenAI. Para obtener más información, consulte Crear e implementar un recurso de Azure OpenAI Service.

  • El recurso necesita los siguientes modelos implementados:

    • Un modelo de finalizaciones, como gpt-4o.
    • Un modelo de embeddings, como text-embedding-3-small.

• Un Azure Cosmos DB para la cuenta de NoSQL.

  • Antes de crear la base de conocimiento, habilite la búsqueda de vectores en la cuenta de Cosmos DB. Esta operación puede tardar hasta 15 minutos antes de la finalización.

    Para obtener más información, consulte:

    • Inicio rápido: Cree una cuenta de Azure Cosmos DB for NoSQL mediante el portal de Azure
    • Búsqueda de vectores en Azure Cosmos DB para NoSQL

• Una aplicación lógica estándar y un flujo de trabajo agente.

  Para obtener más información, consulte:

  • Crear flujos de trabajo agente autónomos sin interacciones humanas en Azure Logic Apps
  • Crear flujos de trabajo conversacionales de agentes mediante interacciones de chat en Azure Logic Apps

Autenticación

La funcionalidad KBaaS admite la autenticación mediante Microsoft Entra ID con una identidad administrada o una clave de API. Si es posible, configure y use una identidad administrada para una seguridad óptima y superior. No es necesario proporcionar y administrar manualmente credenciales, secretos ni claves de acceso.

Si usa una clave de API, protege y protege datos confidenciales y personales, como credenciales, secretos, claves de acceso, cadenas de conexión, certificados, huellas digitales e información similar con el nivel de seguridad más alto disponible o compatible. Almacene esta información de forma segura mediante Microsoft Entra ID y Azure Key Vault. No codifique esta información de forma dura, comparta con otros usuarios o guarde en texto sin formato en cualquier lugar al que otros puedan acceder. Configure un plan para rotar o revocar los secretos si se ven comprometidos.

Para obtener más información, consulte los siguientes recursos:

• Automatización de la rotación de secretos en Azure Key Vault
• Procedimientos recomendados para proteger secretos
• Secretos en Azure Key Vault

1: Cree la conexión de la base de conocimientos

Para crear la conexión a la base de conocimiento, asocie su base de datos de Cosmos DB y los modelos del recurso de Azure OpenAI, siguiendo estos pasos:

1a: Configuración de la conexión de base de datos de Cosmos

1. En el portal de Azure, abra su recurso de aplicación lógica estándar.

2. En la barra lateral de la aplicación lógica, en Agentes, seleccione Knowledge Base.

3. En la página Base de conocimiento , seleccione Configurar.

4. En el panel Configurar , en la pestaña Aspectos básicos , proporcione la siguiente información:

   Parámetro	Obligatorio	Descripción
   Nombre para mostrar	Sí	Un nombre fácil de reconocer para la conexión a la base de conocimiento. Use el mismo nombre que la base de conocimiento que planea crear para que la acción de recuperación pueda asociar la conexión correcta.
   Tipo de autenticación	Sí	Identidad de servicio administrada o basada en claves
   Subscription	Sí	Su suscripción de Azure.
   Base de datos	Sí	La base de datos de Cosmos.
   Extremo de URL	Sí	La selección de la base de datos rellena automáticamente este valor.
   Clave	Sí	Solo está disponible si selecciona Autenticación basada en claves . La selección de la base de datos rellena automáticamente este valor.

5. Cuando haya terminado, seleccione Siguiente.

1b: Configuración de la conexión de recursos de OpenAI de Azure

1. En la pestaña Modelo , proporcione la siguiente información:

   Parámetro	Obligatorio	Descripción
   Tipo de autenticación	Sí	Autenticación basada en direcciones URL y clave o Managed Service Identity
   Subscription	Sí	Su suscripción de Azure.
   Recurso de Azure OpenAI	Sí	Su recurso de Azure OpenAI.
   Punto de conexión de API	Sí	La selección de recursos de Azure OpenAI rellena automáticamente este valor.
   Clave de API	Sí	Solo está disponible si selecciona la dirección URL y la autenticación basada en claves. La selección de recursos de Azure OpenAI rellena automáticamente este valor.
   Modelo de finalizaciones	Sí	Escriba el nombre para mostrar del modelo de finalizaciones implementado para el recurso de Azure OpenAI.
   Modelo de inserción	Sí	Escriba el nombre visible del modelo de inserción desplegado para su recurso de Azure OpenAI.

2. Cuando termine, seleccione Crear.

2: Agregar artefactos de conocimiento

Después de crear la conexión con tu base de conocimiento, agrega los archivos de información de origen para usarlos como artefactos de conocimiento en tu base de conocimiento.

1. En el portal de Azure, abra su recurso de aplicación lógica estándar.

2. En la barra lateral de la aplicación lógica, en Agentes, seleccione Knowledge Base.

3. Si desea crear un grupo antes de agregar archivos, en la barra de herramientas de la página Base de conocimiento , seleccione Nuevo>crear nuevo grupo y, a continuación, siga las indicaciones para crear el grupo.

4. En la página Base de conocimiento , seleccione Agregar archivos. O bien, en la barra de herramientas de la página, seleccione Nuevo>agregar archivos.

5. En el panel Agregar archivos , complete las siguientes tareas:

   1. En la sección Grupo , escriba la siguiente información:

      Parámetro	Obligatorio	Descripción
      Nombre	Sí	Nombre del grupo que organiza los archivos de la base de conocimiento. Escriba un nombre nuevo o seleccione un grupo existente.
      Description	No	Una descripción opcional del grupo.

   2. En la sección Agregar archivos , seleccione Examinar para cargar o arrastrar y colocar archivos en el grupo. Para cada archivo, escriba la siguiente información:

      Parámetro	Obligatorio	Value	Descripción
      Nombre	Sí	< source-name>	Un nombre para el archivo como origen de conocimiento, por ejemplo, HRPolicyDocument.
      Description	No	< source-description>	Descripción opcional del archivo como origen de conocimiento.

6. Cuando termine, seleccione Agregar.

   KBaaS crea los siguientes contenedores de Cosmos DB:

   Contenedor	propósito
   KnowledgeHubs	Almacena metadatos de la base de conocimiento.
   KnowledgeArtifacts	Almacena metadatos de origen y referencias a documentos de origen.
   KnowledgeArtifactChunks	Almacena fragmentos de documento de texto completo.
   KnowledgeArtifactChunkSummaries	Almacena fragmentos resumidos con incrustaciones de vectores para la búsqueda semántica.

   KBaaS devuelve una respuesta aceptada 202 con un identificador de operación para realizar el seguimiento del progreso de la carga.

   Durante el proceso de carga, KBaaS realiza operaciones para analizar, fragmentar, resumir, insertar y almacenar contenido vectorizado en el contenedor de Cosmos DB. Cuando se completa el proceso, el estado de origen cambia a Completado o Erróneo, en función del resultado.

7. Supervise el estado de carga en el portal de Azure o mediante el identificador de operación.

8. Cuando termine KBaaS, continúe con la siguiente sección para que pueda agregar la base de conocimiento como una herramienta que el bucle de agente pueda usar en su flujo de trabajo estándar orientado de agente.

3: Agregar la base de conocimiento como una herramienta

Ahora puede agregar la base de conocimiento al bucle de agente para usarla como herramienta en los flujos de trabajo estándar de agente. Los bucles del agente consultan automáticamente la base de conocimiento para recuperar información semánticamente relevante de los documentos cargados.

1. En la misma aplicación lógica estándar que incluye la base de conocimiento, en el diseñador, abra el flujo de trabajo de agente y seleccione el bucle del agente que desee.

2. En el panel de información del agente, en la sección Base de conocimiento , seleccione Crear.

3. En el panel Crear conexión , en la lista Orígenes , seleccione la base de conocimiento.

4. Para cargar más archivos en la base de conocimiento, seleccione + Cargar.

Administración de bases de conocimiento y orígenes

Para enumerar, ver y eliminar bases de conocimiento o orígenes, use el portal de Azure o la API REST.

Enumerar todas las bases de conocimiento

1. En el portal de Azure, abra su recurso de aplicación lógica estándar.

2. En la barra lateral de la aplicación lógica, en Agentes, seleccione Knowledge Base.

O bien, realice la siguiente llamada API REST:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs

Visualización de una base de conocimiento específica

En el portal de Azure, en la página Knowledge base, seleccione el nombre de la base de conocimiento.

O bien, realice la siguiente llamada API REST:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

La respuesta incluye la información de la base de conocimiento, una lista con los orígenes asociados y su estado de carga.

Enumeración de orígenes en una base de conocimiento

En el portal de Azure, seleccione la base de conocimiento para ver sus orígenes.

O bien, realice la siguiente llamada API REST:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts

Eliminación de un origen de conocimiento

Esta operación quita los metadatos de origen, los fragmentos de texto completo y las inserciones vectoriales de Cosmos DB. El servicio devuelve una respuesta aceptada 202 con un identificador de operación para realizar el seguimiento del progreso de la eliminación.

1. En el portal de Azure, seleccione la base de conocimiento para ver sus orígenes.

2. Seleccione la fuente. En la barra de herramientas, seleccione Eliminar.

O bien, realice la siguiente llamada API REST:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts/{artifactName}

Eliminación de una base de conocimiento

Esta operación elimina de Cosmos DB la base de conocimiento y las fuentes, fragmentos y resúmenes asociados.

1. En el portal de Azure, seleccione la base de conocimiento.

2. En la barra de herramientas, seleccione Eliminar.

O bien, realice la siguiente llamada API REST:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

Contenido relacionado

• ¿Qué es Azure Logic Apps?
• Servicio Azure OpenAI
• Azure Cosmos DB búsqueda de vectores
• Almacén de vectores integrado - Azure Cosmos DB for NoSQL