Registro y detección de complementos en el inventario de API

En este artículo se describe cómo usar Azure API Center para registrar complementos como parte del inventario de API. Los complementos son funcionalidades reutilizables que los agentes de inteligencia artificial pueden detectar y consumir para ampliar su funcionalidad.

En API Center, registra un complemento agrupando una o más habilidades y/o servidores MCP que ya están registrados en tu inventario de API. Al registrar un complemento, se crea una abstracción de nivel superior que simplifica la detección y el uso de aptitudes relacionadas y servidores MCP por parte de desarrolladores y sistemas de inteligencia artificial.

Prerequisites

Registro de un complemento en el Centro de API

Para registrar un complemento en el Centro de API:

  1. Inicie sesión en el portal Azure y vaya al centro de API.

  2. En el menú de la barra lateral, en Inventario, seleccione Recursos.

  3. Seleccione + Registrar un recurso>Plugin.

    Captura de pantalla del registro de un complemento en el portal.

  4. En el formulario Registrar un complemento , escriba la información descrita en la tabla siguiente:

    Campo Description
    Title Escriba un nombre descriptivo para el complemento.
    identificador El Centro de API genera automáticamente un identificador basado en el título. Puede editar este identificador si es necesario.
    Resumen Opcionalmente, escriba un breve resumen de lo que hace el complemento.
    Descripción Opcionalmente, escriba una descripción más detallada de las funcionalidades, los casos de uso y el comportamiento del complemento.
    Version Opcionalmente, escriba la versión del complemento.
    Habilidades Para agregar aptitudes al complemento, seleccione + Agregar aptitud y elija en la lista de aptitudes registradas en el inventario de API.
    Servidores MCP Para agregar servidores MCP al complemento, seleccione + Agregar servidor MCP y elija en la lista de servidores MCP registrados en el inventario de API.

  5. Seleccione Crear para registrar el complemento en el centro de API.

Después del registro, el complemento aparece en el inventario en la página Recursos de inventario>.

Detección de complementos en el portal del Centro de API

Configure el portal del Centro de API para que los desarrolladores y otras partes interesadas de la organización puedan detectar complementos en el inventario de API. En el portal del Centro de API, los usuarios pueden:

  • Examine y filtre los complementos en el inventario.
  • Vea información detallada sobre cada complemento.

Evaluación de recursos de IA

El Centro de API puede evaluar la calidad de los recursos de inteligencia artificial, como aptitudes y agentes registrados en el centro de API. API Center incluye de forma predeterminada criterios de evaluación para evaluar activos en distintas dimensiones predefinidas. Los administradores de plataforma empresarial pueden ampliar aún más estos valores predeterminados mediante la definición de criterios de evaluación personalizados adaptados a los estándares específicos, los requisitos de cumplimiento y las directivas de gobernanza de su organización.

Para habilitar las evaluaciones automatizadas de los recursos de inteligencia artificial en el inventario:

  1. En Azure Portal, vaya al Centro de API.

  2. En el menú de la barra lateral. vaya a Gobernanza>Evaluación de IA.

  3. Seleccione la pestaña Aptitudes para configurar las evaluaciones de aptitudes o seleccione la pestaña Agentes para configurar las evaluaciones de los agentes.

  4. En Estado de evaluación, seleccione Habilitado.

  5. Escriba una descripción para la evaluación.

  6. En Criterios de evaluación, realice una de las siguientes acciones:

    • Acepte los criterios predeterminados proporcionados por el Centro de API. Opcionalmente, quite los criterios predeterminados que no sean pertinentes para su organización.

    En la captura de pantalla siguiente se muestran los criterios predeterminados para las aptitudes:

    Captura de pantalla de la configuración de la evaluación de aptitudes de IA en el portal.

    • Agregue uno o varios criterios personalizados.
      1. Seleccione + Agregar criterios.
      2. Escriba un nombre y una instrucción de evaluación opcional para el criterio.
      3. Escriba Puntuación mínima y Valores de puntuación máxima para la puntuación (por ejemplo, 1 y 5).
      4. Escriba un valor de umbral de paso (por ejemplo, 3) que indique la puntuación mínima aceptable para el criterio.
      5. Escriba un valor Weight que indique la contribución del criterio a la evaluación total (por ejemplo, un peso de 0,3 múltiplo de la puntuación en 0,3, contribuyendo 30% a la evaluación total).
      6. Repita los pasos anteriores para agregar más criterios según sea necesario.

  7. Haga clic en Guardar.

A continuación, puede ver los resultados de la evaluación en el portal del Centro de API. Por ejemplo, vea los resultados de la evaluación de cada aptitud en la página de detalles de la aptitud.

Captura de pantalla de la evaluación de aptitudes en el portal del Centro de API.

Configura la detección y el uso de complementos mediante el endpoint de Marketplace

El extremo del mercado de complementos de API Center expone el catálogo de complementos registrados mediante la API de datos de API Center, lo que permite su descubrimiento y uso por parte de los desarrolladores. Los desarrolladores pueden agregar el Marketplace a GitHub Copilot CLI o al entorno de desarrollo de Claude Code para explorar e instalar complementos desde tu centro de API.

Contenido relacionado

  • Last updated on