Regístrate y descubre habilidades en tu inventario de API

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

Al registrar aptitudes en el centro de API, se crea un registro centralizado que ayuda a su organización:

  • Detección de aptitudes disponibles y sus funcionalidades
  • Acceso al código fuente y a la documentación de las aptitudes

Prerrequisitos

  • Un centro de API. Si aún no tiene un centro de API, consulte el inicio rápido para crear un centro de API.
  • Una o varias aptitudes que desea registrar, normalmente hospedadas en un repositorio de código fuente, como GitHub.

Registro de una aptitud

Para registrar una habilidad en el Centro de API:

  1. Inicie sesión en Azure Portal y vaya al Centro de API.

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

  3. Seleccione + Registrar un activo>Habilidad.

    Captura de pantalla del registro de una aptitud en el portal.

  4. En el formulario Registrar una aptitud , proporcione la información de la tabla siguiente:

    Campo Descripción
    Título Escriba un nombre descriptivo para la aptitud (por ejemplo, Aptitud de revisión de código).
    Identificación El Centro de API genera automáticamente un identificador basado en el título (por ejemplo, code-review-skill). Si es necesario, puede editarlo.
    Resumen Proporcione una breve descripción de una línea de lo que hace la aptitud (por ejemplo, Realiza revisiones de código automatizadas mediante análisis estáticos).
    Descripción Escriba una descripción más detallada de las funcionalidades, los casos de uso y el comportamiento de la aptitud.
    Fase del ciclo de vida Seleccione la fase actual del ciclo de vida de la aptitud en el menú desplegable.
    Fuente
    Dirección URL de origen Escriba la URL del repositorio de Git para el código fuente de la habilidad (por ejemplo, https://github.com/<org>/<repo>/tree/main/skills/<skill-name>).
    Compatibilidad Describir los requisitos, las dependencias y los requisitos previos para usar la aptitud (por ejemplo, software o herramientas necesarios, como git, docker, lenguajes de programación; requisitos del sistema; requisitos de acceso a la red; Claves de API o requisitos de autenticación).
    Herramientas permitidas Seleccione + Agregar herramienta para especificar las API o los servidores MCP del inventario de API al que puede acceder esta aptitud. Este enfoque ayuda a garantizar la gobernanza y la seguridad adecuadas definiendo explícitamente qué recursos puede consumir la aptitud.
    Licencia Seleccione + Agregar para proporcionar información de licencias. Escriba el nombre de licencia (por ejemplo, MIT, Apache 2.0 o Propietario), proporcione opcionalmente una dirección URL de licencia y agregue una descripción si es necesario para aclarar los términos o restricciones de licencia.
    Información de contacto Seleccione + Agregar para agregar puntos de contacto para obtener soporte técnico o consultas. Escriba un nombre de contacto o un rol (por ejemplo, equipo de API o John Smith), proporcione detalles de contacto como la dirección de correo electrónico y, opcionalmente, agregue una descripción para aclarar cuándo y por qué ponerse en contacto con esta persona o equipo.

  5. Seleccione Crear para registrar la aptitud en el Centro de API.

Después del registro, la aptitud aparece en tu inventario en la página Inventario>Recursos.

Actualización de una aptitud registrada

Puede actualizar la información de aptitudes en cualquier momento:

  1. En el centro de API, vaya a Inventario>.Recursos
  2. Busque y seleccione la aptitud que desea actualizar.
  3. Seleccione Editar para modificar las propiedades de la aptitud.
  4. Realice los cambios y seleccione Guardar.

Sincronización de aptitudes desde un repositorio de Git

Para automatizar el registro de aptitudes y mantener el inventario actualizado, puede integrar un repositorio de Git con el centro de API. Para más información, consulte Synchronize API assets from a Git repo (Sincronizar recursos de API desde un repositorio de Git).

Descubre habilidades en el portal Centro de API

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

  • Examinar y filtrar habilidades del inventario.
  • Vea información detallada sobre cada aptitud.

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.

Contenido relacionado

  • Last updated on